テスト アカウント

テスト アカウントを使用すると、本番環境に変更を実装する前に、新しい API 実装やアカウント構成を試すことができます。

本番環境アカウントでは、請求が必要な広告が配信され、ユーザーに表示されます。一方、テストアカウントは、有効な請求がなく、ユーザーに広告が表示されないため、Google 広告の管理画面で利用停止中のアカウントとして表示されます。

テスト用アカウントと本番用アカウントは相互にやり取りできないため、既存の本番用 MCC アカウントでテスト用アカウントを使用することはできません。テスト アカウントを使用するには、テスト用マネージャー アカウントをルートとする新しいアカウント階層が必要です。

テスト アカウントが必要ですか？

別のテスト アカウント階層を作成する前に、ユースケースに最適なテスト オプションを確認してください。

  • 初めて API 呼び出しを行う場合、または実際の口座に対してテストを行う場合（1 日あたり最大 2,880 回のオペレーション）: エクスプローラ アクセスで制限されている機能（アカウントの作成、ユーザー管理、キーワード プランニング、請求など）をテストする場合を除き、テスト アカウントは必要ありません。Google Cloud コンソールの Google Ads API の概要ページで、自動エクスプローラ アクセスレベルを申請して、本番環境アカウントを直接クエリして管理します。
  • データを変更せずにリクエストの構文とポリシーの遵守を検証する: GoogleAdsService.Search または変更リクエストで validate_only フィールドを設定します（本番環境アカウントをターゲットとする場合は、少なくともエクスプローラ アクセスが必要です）。
  • テストアクセス プロジェクトを使用して開発するか、無料のサンドボックスでキャンペーン作成全体をテストする: このページの手順に沿って、テスト マネージャー アカウントとテスト クライアント アカウントを作成します。

テストアカウントを使用する理由

テスト用アカウントは、実際の広告に影響を与えたり、アカウントに請求が発生したりすることはありません。アクティブな開発中に、次のようなメリットがあります。

  • 本番アカウントと同様に、階層構造で設定して整理できます。
  • 本番環境アカウントと同様に、Google 広告の管理画面で表示、操作できます。
  • Google Cloud プロジェクトで本番環境 Products API へのアクセスを承認する必要がないため、プロジェクトにテスト アクセスレベルが設定されている間、すぐに API のテストを開始できます。（テストアクセス権を持つ Google Cloud プロジェクトが本番環境アカウントを呼び出そうとすると、API は v25 以降では AuthorizationError.CLOUD_PROJECT_NOT_APPROVED_FOR_PRODUCTION を、v24 以前では AuthorizationError.ACTION_NOT_PERMITTED を返します）。
  • 広告を配信したり、本番環境アカウントを操作したりすることはできません。これにより、広告配信中アカウントに影響を与えることなく、コードや構成の変更をテストするための安全な環境が提供されます。
  • 本番環境アカウントと同じ制限（レート制限など）が適用されます。

テストアカウントには予算がないため、マネージャー アカウントでテスト用サブアカウントを作成するとエラーが表示されることがあります。このエラーは無視してかまいません。

テスト用のアカウントとキャンペーンを作成する

以下の手順では、テスト用 MCC アカウント、テスト用クライアント アカウント、テスト用クライアント アカウントにデータを入力するためのいくつかのキャンペーンを作成します。これらのアカウントの種類について詳しくは、アカウント タイプをご覧ください。

  1. [テスト用 MCC アカウントを作成] をクリックして、Google 広告アカウントの選択ページを開きます。プロンプトが表示されたら、本番環境の Google 広告 MCC アカウントにリンクされていない Google アカウントでログインするか、ログイン メッセージから Google アカウントを作成します。

    テスト用 MCC アカウントを作成する

  2. アカウント選択ページで、[新しい Google 広告アカウント] をクリックします（[アカウントの設定を完了しますか？] ダイアログが表示された場合は、[新しいアカウントを作成] をクリックします）。アカウント選択ページにはテスト インジケーターは表示されませんが、[テスト用 MCC アカウントを作成] から開くと、テスト用 MCC アカウントを作成するための登録フローが構成されます。

  3. [ビジネス情報を確認する] ページで、[アカウントの表示名] を入力し、[アカウントの主な使用目的] オプションを選択して、国、タイムゾーン、通貨を選択します。右上にある赤色の [テストアカウント] ラベルを確認し、[送信] をクリックしてから、[アカウントに移動] をクリックして、テスト用 MCC アカウントのダッシュボードを開きます。

  4. テスト用クライアント アカウントを作成します。テスト用クライアント アカウントを作成するには、テスト用クライアント アカウントで [アカウント] > > [新しいアカウントを作成] をクリックします。アカウント名を入力し、国、タイムゾーン、通貨を選択して、アカウントを保存します。テスト用 MCC アカウントから作成したクライアント アカウントは、自動的にテストアカウントになります。

  5. 後続のレポートクエリでサンプルデータが返されるように、テスト クライアント アカウントに 1 つ以上のテスト キャンペーンを作成します。

  6. API 構成用に、Google 広告の管理画面から 10 桁のお客様 ID（ハイフンなし）を両方とも記録します。

    • customer_id（ターゲット クライアント アカウント）: テスト キャンペーンを作成した新しいテスト クライアント アカウントの 10 桁のお客様 ID を使用します（キャンペーンをクエリまたは変更する API 呼び出しは、マネージャー アカウントではなく、クライアント アカウントをターゲットにする必要があります）。
    • login-customer-id（マネージャー アカウント）: テスト マネージャー アカウントにリンクされている Google アカウントまたはサービス アカウントで認証する場合は、login-customer-id をテスト マネージャー アカウントの 10 桁のお客様 ID に設定します。

  7. 最初の API 呼び出しを行うの手順に沿って、クライアント ライブラリまたは REST 認証情報を構成し、新しいテスト クライアント アカウントに対してテストクエリを実行します。

テスト アカウントを表示する

Google 広告の管理画面でテスト用 MCC アカウントのテスト用クライアント アカウントを表示するには、利用を停止したアカウントを表示してアカウントを再表示します。

MCC アカウントの設定中や、Google 広告の管理画面の一部のビューでは、テストアカウントに赤色の [テストアカウント] ラベルが表示されます。

赤いテストアカウント ラベルが表示された Google 広告の管理画面

API を使用してアカウントがテストアカウントかどうかを確認するには、GoogleAdsService.Search メソッドまたは GoogleAdsService.SearchStream メソッドを使用して customer.test_account フィールドをクエリします。

SELECT customer.id, customer.test_account
FROM customer
LIMIT 1

このクエリは、テスト マネージャー アカウントまたはテスト クライアント アカウントに対して実行できます。テスト用 MCC アカウントを使用してテスト用クライアント アカウントをクエリする場合は、login-customer-id ヘッダーに MCC アカウント ID を含めます。テスト マネージャー アカウントとテスト クライアント アカウントは、customer.test_account に対して true を返しますが、本番環境アカウントは false を返します。

制限事項

テストアカウントを使用する際は、次の制限事項に注意してください。

  • テストアカウントでは広告を配信したり、本番環境のアカウントを操作したりすることはできないため、配信指標（インプレッション数、コンバージョン数、費用データなど）は空になります。
  • 入札単価シミュレーション、コンバージョンのアップロード、お支払いなど、一部の機能はテスト用アカウントではテストできません。最適化案などの他の機能は、テストアカウントでは配信データが生成されないため、テストアカウント内での機能が制限されます。
  • テスト用 MCC アカウントの階層には、最大 50 個のテストアカウントを含めることができます。追加のテストアカウントが必要な場合は、別のテスト用マネージャー アカウントを作成できます。
  • 大量の継続的なリクエストを生成するテストアカウントは、予告なしにスロットルされることがあります。

これらの制限を回避する方法については、テストのベスト プラクティスをご覧ください。

前へ
テスト