よく寄せられる質問

Microsoft Q&A フォーラムは、開発者コミュニティがBing Ads API と Microsoft Advertising Scripts に関する質問と回答を行うために利用できます。 Microsoft はフォーラムを監視し、コミュニティがまだ回答していない質問に回答します。

調査に機密性の高いアカウントまたは個人情報が含まれる場合、または Microsoft Q&A 経由で問題を解決するために必要な情報が見つからない場合は、 Microsoft Advertising サポートにお問い合わせください。 問題を効率的に解決するには、「 Engaging Support」で要求された詳細をサポートに提供してください。

リリース ノートと移行ガイドは、最初に最適なリソースです。

毎月のニュースレターには、開発者ポータルの [ ニュース ] タブからサインアップできます。また、最新の ブログ のお知らせが集計されます。

開始するには、Microsoft Advertising アカウントにサインアップし、開発者ポータルの [アカウント] タブで開発者トークンを取得する必要があります。

web サービスをサポートする任意のプログラミング言語を使用して、Bing Ads API アプリケーションを開発できます。 Bing Ads API Software Development Kits (SDK) は、.NET、Java、PHP、Python 言語を使用してBing Ads API アプリケーションを開発するエクスペリエンスを強化します。 各 SDK には、すべてのBing Ads API Web サービスへのプロキシが含まれており、OAuth による認証の低レベルの詳細が抽象化されます。 高レベルの BulkServiceManager インターフェイスと ReportingServiceManager インターフェイスを使用して、低レベルの Bulk および Reporting サービスで操作を抽象化して実行できます。

Perl や Ruby など、追加の SDK の要求は聞きましたが、近い期間にサポートを追加する予定はありません。

コード例に加えて、コード スニペットは、多くのテクニカル ガイド (例: 作業の開始ガイド) にあります。 これらのページの上部または右側にある言語セレクターを使用して、CSharp、Java、Php、または Python の例を表示できます。 言語を選択すると、他のページを移動するときに設定が保持されます。 言語セレクターには、その特定のページのサンプルがある言語のみが含まれます。以前に設定した言語が移動先のページで使用できない場合、既定では C# になります。

特に、アカウント内の複数の広告グループやキャンペーンに広告やキーワードを追加または更新する必要がある場合は、 一括サービス をお勧めします。 一部の機能は一括では使用できません。 たとえば、AddUetTags、 GetBMCStoresByCustomerId、 GetGeoLocationsFileUrl、 GetMediaMetaDataByAccountId などです。 もちろん、これらの機能については 、キャンペーン管理サービスを使用する必要があります。

Reporting サービスは、Microsoft Advertising Web アプリケーションで見つけることができるのと同じ レポートの種類 のほとんどをサポートしています。 可用性の詳細については、「レポート属性とパフォーマンス統計」および「レポート データ保持期間」ガイドを必ずチェックしてください。

ユーザーが広告をクリックすると、クリックが処理されるまでに最大 2 時間かかる場合があります (コンバージョンの場合は 3 時間)。 前日のすべてのデータが処理され、レポートに使用できるようになった場合、この状態はブッククローズと呼ばれます。 レポートのために書籍が閉じられるタイミングの詳細については、「レポート のタイム ゾーン」を参照してください。

Microsoft ID プラットフォーム エンドポイント経由で新しいmsads.manageスコープを使用するようにアプリケーションを更新する必要があります。 すべてのアプリケーション開発者は、新しいスコープを使用するためにアクションを実行する必要があります。

新しいmsads.manageスコープとMicrosoft ID プラットフォーム エンドポイントを使用して、ユーザーに同意を求める必要があります。

16 進数の値 (0000000012345A67 など) として書式設定された古いアプリケーション ID (別名クライアント ID) がある場合は、新しいアプリケーションを登録する必要があります。 有効なMicrosoft ID プラットフォームアプリケーション ID は、ダッシュ (例: 000011111-aaaa-2222-bbbb-3333cccc4444) で GUID として書式設定されます。 Azure portal - アプリの登録に既存のアプリが表示されない場合は、新しいアプリに置き換える必要があることを示しています。

はい。 新しいmsads.manageスコープとMicrosoft ID プラットフォーム エンドポイントを使用して、ユーザーに同意を求める必要があります。

Microsoft ID プラットフォーム エンドポイントで (共通テナントを使用して) ユーザーに同意を求めると、ユーザーサインイン エクスペリエンスは、資格情報の背後にある基になる ID によって異なります。

• MSA ID のみを持つユーザーは、MSA サインイン ページに移動します。
• Azure AD ID のみを持つユーザーは、組織のサインイン ページに移動されます。
• MSA ドメインと Azure AD ドメインの両方で有効な資格情報を持つユーザーには、個人と職場または学校の ID のどちらかを選択するように求めるあいまいさの解消ページが表示されます。 このあいまいさは、このユーザーが同じメール アドレスに 2 つの ID を関連付けている限り、常に存在します。 ユーザーは、 個人の Microsoft アカウントのメール アドレスを変更することで、この表示を停止できます。 詳細については、を参照してください https://cloudblogs.microsoft.com/enterprisemobility/2016/09/15/cleaning-up-the-azure-ad-and-microsoft-account-overlap/。

ユーザーが MSA 個人用アカウント ID を持たなくなった場合、Bing Ads API は既存のアクセス トークンを受け入れなくなります。 同様に、更新トークンを使用して新しいアクセス トークンを要求することはできなくなります。そのため、アプリケーションで Microsoft Advertising アカウントを管理するには、もう一度ユーザーの同意を要求する必要があります。 前の更新トークンは破棄する必要があります。

いいえ。 職場または学校のアカウントは、運用環境でのみサポートされます。

Microsoft Advertising アカウントをプログラムで管理するには、Web アプリケーションの同意フローを通じて少なくとも 1 回は同意を提供する必要があります。 繰り返し認証または長期認証の場合は、アクセス トークンと更新トークンを取得するための承認コード付与フローに従う必要があります。 その後、最新の更新トークンを使用して、ユーザーの操作を行わずに新しいアクセストークンと更新トークンを要求できます。 ユーザーがアカウントの回復を行った場合、パスワードを変更した場合、またはアプリケーションが自分の代わりに認証するためのアクセス許可を削除した場合など、ユーザーの同意を再度要求する必要がある場合があります。

アクセス トークンは通常、1 時間後に期限切れになりますが、新しいトークンを要求するたびに、常に有効期限をチェックする必要があります。

更新トークンは、常にアプリケーションに対して完全に不透明になります。 パブリック クライアントの場合は 90 日間など、有効期間が長くなりますが、更新トークンが一定期間続くと想定するようにアプリを記述しないでください。 更新トークンはいつでも無効にすることができます。また、更新トークンが有効かどうかをアプリが認識する唯一の方法は、トークン要求を行ってトークンを引き換えようとすることです。 最新の更新トークンを使用して同じデバイス上のトークンを継続的に更新する場合でも、ユーザーをサインアウトした場合、Microsoft Advertising ユーザーがパスワードを変更した場合、信頼されたデバイスの一覧からデバイスを削除した場合、またはアプリケーションが代わりに認証するためのアクセス許可を削除した場合など、ユーザーの同意を要求する必要があります。 Microsoft は、事前の警告なしにいつでも、ユーザーの同意を再び付与する必要があると判断する場合があります。 ベスト プラクティスとして、新しいアクセストークンと更新トークンを要求するたびに、常に最新の更新トークンを安全に格納する必要があります。

アクセス トークンは、1 つ以上の Microsoft Advertising アカウントにアクセスできるユーザー資格情報を表します。 アプリケーション ID (client_id) は、同意を許可する Microsoft Advertising ユーザーごとにアプリケーションを識別します。 開発者トークンは、Bing Ads API を使用するアクセス許可をアプリケーションに付与します。

Bing Adsが Microsoft Advertising になりました。 新しい名前は、より多くのお客様にリーチできるように広告ソリューションを拡大する方法を反映しています。 現在の API バージョンのブランドを変更する予定はありません。 次の表は、変更された名前または変更されていない名前の一覧です。 詳しくは 、ブランドのお知らせをご覧ください。