テスト アカウントを使用すると、本番環境に変更を実装する前に、新しい API 実装やアカウント構成を試すことができます。
本番環境アカウントでは、請求が必要な広告が配信され、ユーザーに表示されます。一方、テストアカウントは、有効な請求がなく、ユーザーに広告が表示されないため、Google 広告の管理画面に利用停止中のアカウントとして表示されます。
テスト用アカウントと本番用アカウントは相互にやり取りできないため、既存の本番用 MCC アカウントでテスト用アカウントを使用することはできません。テスト アカウントを使用するには、テスト用 MCC アカウントをルートとする新しいアカウント階層が必要です。
テスト アカウントが必要ですか?
別のテスト アカウント階層を作成する前に、ユースケースに最適なテスト オプションを確認してください。
- 初めて API 呼び出しを行う場合、または実際のアカウントに対してテストを行う場合(1 日あたり最大 2,880 オペレーション): エクスプローラ アクセスで制限されている機能(アカウント作成、ユーザー管理、キーワード プランニング、お支払いなど)をテストする場合を除き、テスト アカウントは必要ありません。Google Cloud コンソールの Google Ads API の概要ページで、自動 Explorer アクセスレベルを申請して、本番環境アカウントを直接クエリして管理します。
- データを変更せずにリクエストの構文とポリシーの遵守を検証する:
GoogleAdsService.Searchまたは変更リクエストでvalidate_onlyフィールドを設定します(本番環境アカウントをターゲットとする場合は、少なくともエクスプローラ アクセス権が必要です)。 - テストアクセス プロジェクトを使用して開発する場合、または無料のサンドボックスでキャンペーン作成の全工程をテストする場合: このページの手順に沿って、テスト用 MCC アカウントとテスト用クライアント アカウントを作成します。
テストアカウントを使用する理由
テスト用アカウントは、実際の広告に影響を与えたり、アカウントに請求が発生したりすることはありません。アクティブな開発中に、次のようなメリットがあります。
- 本番アカウントと同様に、階層構造で設定して整理できます。
- 本番環境アカウントと同様に、Google 広告の管理画面で表示、操作できます。
- Google Cloud プロジェクトで本番環境 API へのアクセスを承認する必要がないため、プロジェクトにテスト アクセスレベルがある間は、すぐに API のテストを開始できます。(テストアクセス権を持つ Google Cloud プロジェクトが本番環境アカウントを呼び出そうとすると、API は
v25以降ではAuthorizationError.CLOUD_PROJECT_NOT_APPROVED_FOR_PRODUCTIONを、v24以前ではAuthorizationError.ACTION_NOT_PERMITTEDを返します)。 - 広告を配信したり、本番環境アカウントを操作したりすることはできません。これにより、広告配信中アカウントに影響を与えることなく、コードや構成の変更をテストするための安全な環境が提供されます。
- 本番環境アカウントと同じ制限(レート制限など)が適用されます。
テストアカウントには予算がないため、マネージャー アカウントでテスト用サブアカウントを作成するときにエラーが表示されることがあります。このエラーは無視してかまいません。
テスト用のアカウントとキャンペーンを作成する
以下の手順では、テスト用 MCC アカウント、テスト用クライアント アカウント、テスト用クライアント アカウントにデータを入力するためのいくつかのキャンペーンを作成します。これらのアカウント タイプの詳細については、アカウント タイプをご覧ください。
青いボタンをクリックして、テスト用マネージャー アカウントを作成します。プロンプトが表示されたら、本番環境の Google 広告 MCC アカウントにリンクされていない Google アカウントでログインします。ログイン プロンプトから新しい Google アカウントを作成することもできます。
テスト用クライアント アカウントを作成するには、テスト用マネージャー アカウントで [アカウント] > > [新しいアカウントを作成] をクリックし、フォームに入力します。テスト用 MCC アカウントから作成したクライアント アカウントは、自動的にテストアカウントになります。
Google 広告ページから、テスト クライアント アカウントにテスト用のキャンペーンをいくつか作成します。
API 構成用に、Google 広告の管理画面から 10 桁のお客様 ID(ハイフンなし)を両方とも記録します。
customer_id(ターゲット クライアント アカウント): テスト キャンペーンを作成した新しいテスト クライアント アカウントの 10 桁のお客様 ID を使用します(キャンペーンのクエリまたは変更を行う API 呼び出しは、マネージャー アカウントではなく、クライアント アカウントをターゲットにする必要があります)。login-customer-id(マネージャー アカウント): テスト用マネージャー アカウントにリンクされている Google アカウントまたはサービス アカウントで認証する場合は、login-customer-idをテスト用マネージャー アカウントの 10 桁のお客様 ID に設定します。
最初の API 呼び出しを行うの手順に沿って、クライアント ライブラリまたは REST 認証情報を構成し、新しいテスト クライアント アカウントに対してテストクエリを実行します。
テスト アカウントを表示する
UI でテストアカウントを表示するには、利用停止したアカウントを表示するように選択して、アカウントを再表示します。
テストアカウントには赤いラベルが表示されます。
Google 広告アカウントのページに赤色の [テストアカウント] ラベルが表示されていない場合、そのアカウントは本番環境アカウントです。
制限事項
テストアカウントを使用する場合は、次の制限事項に注意してください。
- テスト アカウントは広告を配信したり、本番環境アカウントとやり取りしたりできないため、インプレッション、コンバージョン、費用データなどの配信指標は空になります。
- 入札単価シミュレーション、コンバージョンのアップロード、お支払いなど、一部の機能はテスト アカウントではテストできません。最適化案などの他の機能は、テストアカウントでは配信データが生成されないため、テストアカウント内での機能が制限されます。
- テスト用 MCC アカウントの階層には、最大 50 個のテストアカウントを含めることができます。追加のテストアカウントが必要な場合は、別のテスト用 MCC アカウントを作成できます。
- 大量の継続的なリクエストを生成するテストアカウントは、予告なしにスロットリングされることがあります。
これらの制限を回避する方法については、テストのベスト プラクティスをご覧ください。