Microsoft Advertising Sandbox
Microsoft Advertising には、アプリケーションを運用環境にデプロイする前にテストできる API サンドボックス環境が用意されています。 サンドボックスで作成した広告は配信されません。 サンドボックスでサポートされるサービスは、運用環境とは異なります。 サポートされているサービスの Web サービス アドレスを取得するには、「 Bing Ads API Web サービス アドレス」を参照してください。
注:
サンドボックスは、事前通知の有無にかかわらず、メンテナンスのために停止する可能性があります。
初期顧客サインアップ
サンドボックスと運用環境では、個別の資格情報が使用されます。
新しいサンドボックス顧客を取得するには、次の手順に従います。 既にサンドボックスのお客様がいて、たとえば Microsoft アカウントの資格情報を使用して新しいユーザーを追加する場合は、 ユーザーの招待 手順に進むことができます。
ブラウザーを開き、https://sandbox.bingads.microsoft.com?simpsp=true に移動します。
[Microsoft Advertising にサインアップする] または [今すぐサインアップ] をクリックします
[ 新しいメール アドレスの作成 ] を選択して MSA を作成します。 既存のメール アドレスは使用しないでください。
[次へ] をクリックします
MSA メール アドレスを入力します。 電子メール サーバーは outlook-int.com である必要があります (例: someone@outlook-int.com)。
重要
サンドボックスでは、outlook-int.com メール アカウントのみを使用して作成された MSA がサポートされます。 outlook.com メール アカウントを使用することはできません。 また、別のメール サービスのメール アカウントを使用することはできません (たとえば、 @contoso.com) アカウントが outlook.com または outlook-int.com メール アカウントにリンクされている場合でも同様です。
残りのユーザーとセキュリティ情報を指定して、MSA ワーク フローを完了します。 その後、Microsoft Advertising にリダイレクトされ、サンドボックスの顧客とアカウントのサインアップを続行します。
[アカウントの作成] フォームに入力する
[キャンペーンのインポート/作成] で、[キャンペーンの作成をスキップ] をクリックします
[Go Live]\(ライブに移動\) で、[支払い情報をスキップする] をクリックします
他のユーザーを招待する
サンドボックス内 の OAuth で認証 するには、サンドボックス Microsoft アカウント (MSA) が必要です。 サンドボックスのお客様が Microsoft アカウント経由でユーザー資格情報をまだ持っていない場合は、次の手順で ユーザーをサンドボックス アカウントで作業するように招待する必要があります。
Microsoft Advertising サンドボックスで、ユーザー名 (右上隅) をクリックします
[アカウント] & [課金] をクリックします
[ユーザー] をクリックします
[ユーザーの招待] をクリックします
招待するユーザーのメール アドレスを入力します。 電子メール サーバーは、outlook.com する必要があります (例: someone@outlook.com)。
重要
outlook.com メール アカウントにのみ招待を送信できます。 アカウントが outlook.com メール アカウントにリンクされている場合でも、他のドメインに招待を送信することはできません。 別のドメイン (たとえば) に招待を送信しようとすると、 someone@contoso.comBingAds UI は招待を無期限に保留中として表示します (招待は送信されません)。
[送信] をクリックします
Microsoft Advertising からユーザーに電子メールの招待が送信されます。 招待が受信トレイに表示されない場合は、迷惑メール Email フォルダーをチェックします。 招待を受け取るために数分かかる場合があります。 次の手順では、招待を承諾する方法を示します。
件名を含む Microsoft Advertising のメールを開きます。[Microsoft Advertising への招待]
埋め込みリンクをクリックします
[ 新しいメール アドレスの作成 ] を選択して MSA を作成します。 既存のメール アドレスは使用しないでください。
[次へ] をクリックします
MSA メール アドレスを入力します。 電子メール サーバーは outlook-int.com である必要があります (例: someone@outlook-int.com)。
重要
サンドボックスでは、outlook-int.com メール アカウントのみを使用して作成された MSA がサポートされます。 outlook.com メール アカウントを使用することはできません。 また、別のメール サービスのメール アカウントを使用することはできません (たとえば、 @contoso.com) アカウントが outlook.com または outlook-int.com メール アカウントにリンクされている場合でも同様です。
残りのユーザー情報を指定して作業フローを完了する
MSA プロセスを完了した後、Microsoft Advertising を終了します。
注:
MSA サインアップ プロセスは、SI Microsoft Advertising ユーザー インターフェイス (ui.si.bingads.microsoft.com) に戻ります。 MSA プロセスが完了したら、SI インターフェイスからサインアウトしてから、 の新しい outlook-int.com メール アドレス https://secure.sandbox.bingads.microsoft.com/を使用してサインインします。
API アクセスを取得する
サンドボックスと運用環境では、個別の資格情報が使用されます。
サンドボックス環境の場合は、 にhttps://login.windows-ppe.net/consumers置き換えますhttps://login.microsoftonline.com/common。
この表には、追加のサンドボックス エンドポイントが含まれています。
| 説明 | 生産 | サンドボックス |
|---|---|---|
| OAuth 要求のエンドポイント | login.microsoftonline.com | login.windows-ppe.net |
| Microsoft アカウントを取得するときに使用されるメールのドメイン | 任意のメール アドレス | outlook-int.com |
| Microsoft アカウントのパスワードを変更するエンドポイント | account.live.com/password/change | account.live-int.com/password/change |
運用環境では独自の開発者トークンを使用する必要がありますが、すべての Microsoft Advertising のお客様はサンドボックスで次のユニバーサル開発者トークンを使用できます。
BBD37VB98
運用環境では独自のアプリケーション ID (クライアント ID) を使用する必要がありますが、すべての Microsoft Advertising のお客様はサンドボックスで次のパブリック アプリケーション ID を使用できます。 "チュートリアル サンプル アプリ" クライアント ID はデスクトップまたはコンソール アプリケーションに制限されており、Web アプリケーション内のクライアント シークレットでは使用できません。
4c0b021c-00c3-4508-838f-d3127e8167ff
これで、Microsoft Advertising ユーザーのアクセス トークンと更新トークンを取得し、Bing Ads API を使用して最初のサービス呼び出しを行うことができます。 クイック スタート ガイドを参照してください。
ヒント
Bing広告 SDK を使用してアクセス トークンと更新トークンを取得する方法の詳細については、「SDK での 認証」を参照してください。
サンドボックスのベスト プラクティス
サンドボックスは、運用環境と同じ容量で使用しないでください。
- アプリケーションを運用環境にデプロイするときに、運用環境の 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 または left nil に設定する必要があります。 |
| GetHistoricalSearchCount | 制限付きのキーワードセットがサポートされています:航空、自動車、最高のお得な情報、予約、車の情報、ケア、一日の取引、割引、エンターテイメント、財務、ゲーム、ホテルレビュー、保険比較、スポーツ、ホテル。 EndMonthAndYear 要素は、前の月に設定する必要があります。 たとえば、今日の日付が 2020 年 4 月 1 日の場合、月末は 2020 年 3 月にする必要があります。 Devices 要素は、Computers または left nil に設定する必要があります。 |
| GetKeywordCategories | サンドボックスと運用環境に違いはありません。 |
| GetKeywordDemographics | 制限付きのキーワードセットがサポートされています:航空、自動車、最高のお得な情報、予約、車の情報、ケア、一日の取引、割引、エンターテイメント、財務、ゲーム、ホテルレビュー、保険比較、スポーツ、ホテル。 Devices 要素は、Computers または left nil に設定する必要があります。 |
| GetKeywordIdeas | サンドボックス テスト データは 3 か月ごとに更新されるため、以前の日付範囲を設定する必要があります。 |
| GetKeywordLocations | 制限付きのキーワードセットがサポートされています:航空、自動車、最高のお得な情報、予約、車の情報、ケア、一日の取引、割引、エンターテイメント、財務、ゲーム、ホテルレビュー、保険比較、スポーツ、ホテル。 Devices 要素は、Computers または left nil に設定する必要があります。 |
| SuggestKeywordsForUrl | サンドボックスと運用環境に違いはありません。 |
| SuggestKeywordsFromExistingKeywords | SuggestionType が 1 に設定されている場合、運用環境と比較して動作に違いはありません。 提案の種類の値 2、3、および 4 の場合、制限付きのキーワードセットがサポートされています。航空、自動、ベスト のお得な情報、予約、車の情報、ケア、1 日の取引、割引、エンターテイメント、財務、ゲーム、ホテルレビュー、保険比較、スポーツ、ホテル。 |
一括サービス
運用環境でのアップロードのファイル サイズ制限は、100 MB または 250 万行です。 サンドボックスの場合、制限は 20,000 行です。 詳細については、「 一括ダウンロードとアップロード」を参照してください。
キャンペーン管理サービス
エディトリアル サポート
サンドボックスでは、限定された編集レビューと不服申し立てがサポートされます。 たとえば、GetEditorialReasonsByIds サービス操作を使用して、運用環境のようにサンドボックスで編集の問題の理由を取得することはできません。
製品広告
製品広告は、米国のサンドボックスでサポートされています。 自動承認するには、次のように "サンドボックス" で終わるカタログと Microsoft Merchant Center ストアを作成する必要があります。
Microsoft Advertising Web アプリケーションで、[ ツール] をクリックします。
[ 管理ツール] で、[ Microsoft Merchant Center] をクリックします。
[ ストアの作成] をクリックし、"サンドボックス" で終わるストア名を入力します (大文字と小文字は区別されません)。
ストア情報を追加し、[カタログ設定] で [製品広告] を選択し、[完了] をクリックします。
新しいストアで、[ カタログ管理] をクリックし、[ カタログの作成] をクリックします。
カタログ名を追加し、[カタログ フィード ファイル] の [後でファイルを手動でアップロードする] を選択し、[保存] をクリックします。
顧客課金サービス
支払い方法はサンドボックスではサポートされていません。
Reporting Service
キーワード (keyword)を作成するときは、数時間以内にテスト パフォーマンス データを生成する必要があります。 データは、サンドボックス内のレポートの生成、取得、解析をテストするために提供されます。 テスト データを使用して、運用環境のキーワードに対して同様のパフォーマンスを推論したり、期待したりしないでください。
テスト データは、エンティティが追加または更新された同じ日にのみ生成されます。 たとえば、今日キーワード (keyword)を追加し、先週のキーワード (keyword)パフォーマンス レポートをダウンロードした場合、データはありません。 レポート期間の今日を含むレポートをプルする必要があります。
次のレポートでは、サンドボックス内のパフォーマンス データを返すことができます。 他のすべてのレポートの種類は正常に送信できますが、サンドボックス サービスはサンプル データを返しません。つまり、結果をポーリングするときにレポートのダウンロード URL は設定されません。