Microsoft Advertising サンドボックス

Microsoft 広告には、運用環境にデプロイする前にアプリケーションをテストできる API サンドボックス環境が用意されています。 サンドボックスで作成した広告は配信されません。 サンドボックスでサポートされるサービスは、運用環境によって異なります。 サポートされているサービスの Web サービス アドレスを取得するには、「 Bing Ads API Web サービス アドレス」を参照してください。

注:

サンドボックスは、事前の通知の有無にかかわらず、メンテナンスのためダウンする可能性があります。

顧客の初期サインアップ

サンドボックス環境と運用環境では、別々の資格情報を使用します。

次の手順に従って、新しいサンドボックス顧客を取得します。 既にサンドボックスの顧客がいて、Microsoft アカウントの資格情報を使用して新しいユーザーを追加する場合は、 ユーザー招待 の手順にスキップできます。

  1. ブラウザーを開き、 サンドボックス サインアップ ページに移動します。

  2. [ 今すぐサインアップ] を選択します。

  3. [ アカウントの作成 ] を選択して Microsoft アカウント (MSA) を作成します。

  4. [ 新しいメール アドレスを取得する] を選択します。

  5. MSA メール アドレスを入力します。 メール サーバーは outlook.com する必要があります (たとえば、 someone@outlook.com)。

    重要

    サンドボックスでは、outlook.com メール アカウントを使用して作成された MSA のみがサポートされます。 また、別のメール サービス ( @contoso.com) など、そのアカウントが outlook.com メール アカウントにリンクされている場合でも、そのアカウントを使用することはできません。

  6. 残りのユーザー情報とセキュリティ情報を指定して、MSA ワークフローを完了します。 その後、Microsoft Advertising にリダイレクトされ、サンドボックス顧客とアカウントのサインアップを続行します。

  7. [ アカウントの作成 ] フォームに入力します。

  8. [ ライブ配信] の場合は、[ 支払い情報をスキップする] を選択します。

オプション: さらにユーザーを招待する

サンドボックスで OAuth を使用して認証 するには、outlook.com メール アカウントで作成された Microsoft アカウント (MSA) が必要です。 サンドボックスの顧客がまだ Microsoft アカウント経由のユーザー資格情報を持っていない場合、またはサンドボックスの顧客が outlook-int.com メール アカウントを使用して作成された場合は、次の手順に従ってサン ドボックス アカウントで作業するようユーザーを招待する必要があります。

  1. Microsoft 広告 サンドボックスで、[ 設定] を選択します。

  2. [ ユーザー管理] を選択します。

  3. [ ユーザーの招待] を選択します。

  4. 招待するユーザーのメール アドレスを入力します。 メール サーバーは outlook.com する必要があります (たとえば、 someone@outlook.com)。

    重要

    招待は、outlook.com 電子メール アカウントにのみ送信できます。 アカウントが outlook.com メール アカウントにリンクされている場合でも、他のドメインに招待を送信することはできません。 別のドメイン ( someone@contoso.com など) に招待を送信しようとすると、BingAds UI は招待を無期限に保留中として表示します (招待は送信されません)。

  5. [送信] を選びます。

Microsoft Advertising からユーザーに電子メール招待状が送信されます。 招待が受信トレイに表示されない場合は、[Junk Email] フォルダーをチェックします。 招待状を受信するまでに数分かかる場合があります。 次の手順は、招待を承諾する方法を示しています。

  1. 件名が「Microsoft Advertising への招待状」の Microsoft Advertising からのメールを開きます

  2. 埋め込みリンクをコピーし、 InPrivate モード ウィンドウ または 別のブラウザーで開きます。

  3. [ アカウントの作成 ] を選択して Microsoft アカウント (MSA) を作成します。

  4. [ 新しいメール アドレスを取得する] を選択します。

  5. MSA メール アドレスを入力します。 メール サーバーは outlook.com する必要があります (たとえば、 someone@outlook.com)。

    重要

    サンドボックスでは、outlook.com メール アカウントを使用して作成された MSA のみがサポートされます。 また、別のメール サービス ( @contoso.com) など、そのアカウントが outlook.com メール アカウントにリンクされている場合でも、そのアカウントを使用することはできません。

  6. 残りのユーザー情報を指定して、ワークフローを終了します

  7. MSA プロセスを完了したら、Microsoft Advertising を終了します。

注:

MSA サインアップ プロセスでは、SI Microsoft 広告ユーザー インターフェイス (ads-int.microsoft.com) に戻ります。 MSA プロセスが完了したら、SI インターフェイスからサインアウトし、 https://sandbox.bingads.microsoft.com/ で新しい outlook.com メール アドレスを使用してサインインします。

サンドボックス環境 — Google OAuth サポート

Microsoft Advertising サンドボックス 環境と 運用 環境では、個別の資格情報を使用します。 Microsoft アカウントに加えて、 Google OAuth 2.0 を使用してサンドボックス顧客を作成し、ユーザーを認証できるようになりました。

これにより、開発者と広告主は、 outlook.com Microsoft アカウントを必要とせずに、Google ID を使用してサンドボックス内で Microsoft Advertising API をテストできます。

最初の顧客 Sign-Up (サンドボックス) — Google OAuth

Google アカウントを使用して、新しいサンドボックス顧客を作成できます。

Google OAuth を使用して新しいサンドボックス顧客を作成する手順

  1. ブラウザーを開き、 サンドボックス サインアップ ページに移動します。

  2. [ 今すぐサインアップ] を選択します。

  3. [ Google アカウントでサインアップ] を選択します。

  4. Google OAuth 認証フローを完了します。

    • Google アカウントでサインインします。
    • Microsoft Advertising がアカウントにアクセスできるように確認して同意します。
    • 要求されたスコープ (email、 profile) を承認する場合は、メッセージが表示されたら承認します。
  5. 認証が成功すると、Microsoft Advertising にリダイレクトされ、サンドボックス顧客の作成を続行します。

  6. [ アカウントの作成 ] フォームに入力します。

    • [ ライブ配信] の場合は、[ 支払い情報をスキップする] を選択します。

Google OAuth で招待を受け入れる

招待されたユーザーは、次のように Google OAuth を使用してサンドボックスの招待を承諾できます。

  1. 招待リンクを開きます。
  2. [ Google アカウントでサインイン] を選択します。
  3. Google OAuth 認証フローを完了します。
  4. サインインに成功すると、ユーザーがサンドボックス アカウントに追加されます。

この強化されたサンドボックス サポートにより、チームは運用環境と同じ API 動作を維持しながら、Google 認証ユーザーで Microsoft Advertising API をテストできます。

API アクセス権の取得

サンドボックス環境と運用環境では、別々の資格情報を使用します。

この表には、追加のサンドボックス エンドポイントが含まれています。

説明 Production サンドボックス
OAuth 要求のエンドポイント login.microsoftonline.com login.microsoftonline.com
Microsoft アカウントを取得するときに使用するメールのドメイン 任意のメール アドレス outlook.com
Microsoft アカウントのパスワードを変更するエンドポイント account.live.com/password/change account.live.com/password/change

運用環境では独自の開発者トークンを使用する必要がありますが、すべての Microsoft 広告のお客様は、サンドボックスで次のユニバーサル開発者トークンを使用できます。

BBD37VB98

運用環境とサンドボックスの両方で独自のアプリケーション ID (別名クライアント ID) を使用する必要があります。

これで、Microsoft 広告ユーザーのアクセス トークンと更新トークンを取得し、Bing 広告 API を使用して最初のサービス呼び出しを行うことができます。 クイック スタート ガイドを参照してください。

ヒント

Bing Ads SDK を使用してアクセス トークンと更新トークンを取得する方法の詳細については、「 SDK での認証」を参照してください。

Google oAuth の API アクセスを取得する

https://accounts.google.com で Google アカウントを作成します。

サンドボックスのベスト プラクティス

サンドボックスを運用環境と同じ容量で使用しないでください。

  • アプリケーションを実稼働環境にデプロイする場合は、実稼働 WSDL と実稼働資格情報を使用してください。
  • サンドボックスには現在の製品版リリースが含まれており、事前通知の有無にかかわらず機能プレビューで更新されます。
  • サンドボックスの容量は運用環境の容量より小さいため、サンドボックスを使用してストレス テストや容量テストを実行しないでください。
  • 複数のスレッドを使用しないでください。

Ad Insight Service

サンドボックスでは、Ad Insight サービスの操作をテストするために、限られたキーワード セットがサポートされています。 テスト データを使用して、運用環境のキーワードについて同様の推定値を推測したり、期待したりしないでください。 制限事項の一部を次の表で説明します。

ヒント

サンドボックスではなく本番環境で Ad Insight を使用します。 サンドボックスは運用サービス操作のサブセットのみを提供し、分析データは運用より遅れます。 サンドボックスの営業案件データは毎週末更新および更新され、月曜日まで利用可能になります。 サンドボックスのキーワード (keyword) アイデア データは、運用環境より数か月遅れる場合があります。 無効な日付範囲が原因で操作が失敗した場合は、以前の日付範囲を使用して要求を送信し直してください。

サービス操作 サンドボックスの制限事項
GetBidLandscapeByKeywordIds サポートされていません。 既存の キーワード (keyword) 識別子を使用して操作を呼び出すことができますが、データは返されません。
GetEstimatedBidByKeywordIds サポートされているキーワードは限られています: 航空、自動車、お得な情報、予約、車の情報、ケア、今日のお得な情報、割引、エンターテイメント、財務、ゲーム、ホテルのレビュー、保険比較、スポーツ、ホテル。
GetEstimatedBidByKeywords サポートされているキーワードは限られています: 航空、自動車、お得な情報、予約、車の情報、ケア、今日のお得な情報、割引、エンターテイメント、財務、ゲーム、ホテルのレビュー、保険比較、スポーツ、ホテル。
GetEstimatedPositionByKeywordIds サポートされているキーワードは限られています: 航空、自動車、お得な情報、予約、車の情報、ケア、今日のお得な情報、割引、エンターテイメント、財務、ゲーム、ホテルのレビュー、保険比較、スポーツ、ホテル。

推定値を取得する可能性を高めるには、 MaxBid 要素が 5 米ドル以上、または他の通貨での同等額である必要があります。
GetEstimatedPositionByKeywords サポートされているキーワードは限られています: 航空、自動車、お得な情報、予約、車の情報、ケア、今日のお得な情報、割引、エンターテイメント、財務、ゲーム、ホテルのレビュー、保険比較、スポーツ、ホテル。

推定値を取得する可能性を高めるには、 MaxBid 要素が 5 米ドル以上、または他の通貨での同等額である必要があります。
GetHistoricalKeywordPerformance サポートされているキーワードは限られています: 航空、自動車、お得な情報、予約、車の情報、ケア、今日のお得な情報、割引、エンターテイメント、財務、ゲーム、ホテルのレビュー、保険比較、スポーツ、ホテル。

MatchType 要素と AdPosition 要素は Aggregate に設定する必要があります。

Devices 要素は、Computers に設定するか、nil にする必要があります。
GetHistoricalSearchCount サポートされているキーワードは限られています: 航空、自動車、お得な情報、予約、車の情報、ケア、今日のお得な情報、割引、エンターテイメント、財務、ゲーム、ホテルのレビュー、保険比較、スポーツ、ホテル。

EndMonthAndYear 要素は先月に設定する必要があります。 たとえば、今日の日付が 2020 年 4 月 1 日の場合、終了月は 2020 年 3 月になります。

Devices 要素は、Computers に設定するか、nil にする必要があります。
GetKeywordCategories サンドボックスと運用環境に違いはありません。
GetKeywordDemographics サポートされているキーワードは限られています: 航空、自動車、お得な情報、予約、車の情報、ケア、今日のお得な情報、割引、エンターテイメント、財務、ゲーム、ホテルのレビュー、保険比較、スポーツ、ホテル。

Devices 要素は、Computers に設定するか、nil にする必要があります。
GetKeywordIdeas サンドボックスのテスト データは 3 か月ごとに更新されるため、日付範囲を早める必要があります。
GetKeywordLocations サポートされているキーワードは限られています: 航空、自動車、お得な情報、予約、車の情報、ケア、今日のお得な情報、割引、エンターテイメント、財務、ゲーム、ホテルのレビュー、保険比較、スポーツ、ホテル。

Devices 要素は、Computers に設定するか、nil にする必要があります。
SuggestKeywordsForUrl サンドボックスと運用環境に違いはありません。
SuggestKeywordsFromExistingKeywords SuggestionType が 1 に設定されている場合、運用環境と比較して動作に違いはありません。

提案タイプの値 2、3、4 の場合、限られたキーワード セットがサポートされます: 航空機、自動車、お得な情報、予約、車の情報、ケア、今日のお得な情報、割引、エンターテイメント、財務、ゲーム、ホテルのレビュー、保険比較、スポーツ、ホテル。

一括サービス

運用環境でのアップロードのファイル サイズ制限は 100 MB または 250 万行です。 サンドボックスの場合、制限は 20K 行です。 詳細については、「 一括ダウンロードとアップロード」を参照してください。

キャンペーン管理サービス

編集サポート

Sandbox では、限定的な編集レビューと異議申し立てがサポートされます。 サンドボックスでは、運用環境の場合のように、 GetEditorialReasonsByIds サービス操作を介して編集上の問題の理由を取得することはできません。

製品広告

製品広告は、米国のサンドボックスでサポートされています。 自動承認を受けるには、次のように、"sandbox" で終わるカタログと Microsoft マーチャント センター ストアを作成する必要があります。

  1. Microsoft Advertising Web アプリケーションで、[ ツール] を選択します。
  2. [ 管理ツール] で、[ Microsoft マーチャント センター] を選択します。
  3. [ ストアの作成] を選択し、"sandbox" で終わるストア名を入力します (大文字と小文字は区別されません)。
  4. 店舗情報を追加し、[カタログ設定] で [製品広告] を選択して、[完了] を選択します。
  5. 新しいストアで、 カタログ管理 を選択し、 カタログの作成 を選択します。
  6. カタログ名を追加し、[カタログ フィード ファイル] で [後で手動でファイルをアップロード] を選択して、[保存] を選択します。

顧客課金サービス

支払い方法はサンドボックスではサポートされていません。

Reporting Service

キーワード (keyword) を作成すると、テスト パフォーマンス データは数時間以内に生成されます。 データは、サンドボックスでのレポートの生成、取得、解析をテストするために提供されます。 テスト データを使用して、運用環境でのキーワードの同様のパフォーマンスを推測したり、期待したりしないでください。

エンティティが追加または更新されたのと同じ日についてのみ、テスト データが生成されます。 例えば、今日 キーワード (keyword) を追加し、先週のキーワード (keyword) パフォーマンス レポートをダウンロードしても、データは取得されません。 レポート期間に今日を含むレポートを取得する必要があります。

次のレポートは、サンドボックス内のパフォーマンス データを返すことができます。 他のすべての種類のレポートは正常に送信できますが、サンドボックス サービスはサンプル データを返しません。つまり、結果のポーリング時にレポートのダウンロード URL は設定されません。