テスト広告を有効にする

このガイドでは、広告統合でテスト広告を有効にする方法について説明します。クリックスルー行動をテストする際に純広告キャンペーンの統計情報に影響を与えたり Ad Exchange の広告主に課金したりすることがないよう、開発中にテスト広告を有効にすることをおすすめします。

前提条件

デモ広告ユニット

テストを有効にする最も簡単な方法は、Google が提供するデモ広告ユニットを使用することです。これらの広告ユニットはアド マネージャー アカウントと関連付けられていないため、アカウントで無効なトラフィックが発生するリスクがありません。

各フォーマットのテスト クリエイティブを参照するデモ広告ユニットを次に示します。

広告フォーマット デモ広告ユニット ID
アプリ起動 /21775744923/example/app-open
アダプティブ バナー /21775744923/example/adaptive-banner
固定サイズのバナー /21775744923/example/fixed-size-banner
インタースティシャル /21775744923/example/interstitial
リワード広告 /21775744923/example/rewarded
リワード インタースティシャル /21775744923/example/rewarded-interstitial
ネイティブ /21775744923/example/native
ネイティブ動画 /21775744923/example/native-video
キーポイント: これらのデモ広告ユニットはアド マネージャーで直接販売の広告を配信するよう設定されており、直接販売の広告は AdChoices を返しません。

テストデバイスを有効にする

本番環境の広告でより厳密なテストを行いたい場合は、デバイスをテストデバイスとして設定し、アド マネージャー管理画面で作成した独自の広告ユニット ID を使用できます。

ご利用のデバイスをテストデバイスとして追加する手順は次のとおりです。

プログラムでテストデバイスを追加する

開発中にアプリで広告をテストする場合は、次の手順でテストデバイスをプログラムに登録します。

  1. 広告統合アプリを読み込み、広告リクエストを行います。
  2. logcat 出力で、次のようなメッセージが表示されます。このメッセージには、デバイス ID と、デバイス ID をテストデバイスとして追加する方法が表示されます。
    I/Ads: Use RequestConfiguration.Builder.setTestDeviceIds(Arrays.asList("33BE2250B43518CCDA7DE426D04EE231"))
    to get test ads on this device."
    テストデバイス ID をクリップボードにコピーします。
  3. コードを変更して、RequestConfiguration.Builder.setTestDeviceIds() を呼び出し、テストデバイス ID のリストを渡します。

    Java

    List<String> testDeviceIds = Arrays.asList("33BE2250B43518CCDA7DE426D04EE231");
    RequestConfiguration configuration =
        new RequestConfiguration.Builder().setTestDeviceIds(testDeviceIds).build();
    MobileAds.setRequestConfiguration(configuration);
    

    Kotlin

    val testDeviceIds = Arrays.asList("33BE2250B43518CCDA7DE426D04EE231")
    val configuration = RequestConfiguration.Builder().setTestDeviceIds(testDeviceIds).build()
    MobileAds.setRequestConfiguration(configuration)
    
    必要に応じて isTestDevice() をチェックして、デバイスがテストデバイスとして正しく追加されたことを確認できます。
  4. アプリを再実行します。広告が Google 広告の場合、広告(バナー、インタースティシャル、動画リワード)の上部中央にテスト広告というラベルが表示されます。

    ネイティブ アドバンス広告の場合、広告見出しアセットの先頭に文字列「テスト広告」が追加されます。

このテスト広告ラベルがある広告はクリックしても問題ありません。テスト広告のリクエスト、インプレッション、クリックは、アカウントのレポートに記録されません。

注: [テスト広告] ラベルを表示するには、11.6.0 以降の SDK バージョンを使用する必要があります。

メディエーションによるテスト

Google のサンプル広告ユニットには Google 広告のみが表示されます。メディエーションの設定をテストするには、テストデバイスを有効にする方法を使用する必要があります。

メディエーション対象広告には、テスト広告ラベルが表示されません。そのため、これらのネットワークから無効なアクティビティの警告を受けないように、お客様が責任をもって個々のメディエーション ネットワークでテスト広告を有効にしてください。詳しくは、各ネットワークのメディエーション ガイドをご覧ください。

メディエーション広告ネットワーク アダプタがテスト広告をサポートしているかどうか不明な場合は、開発中にそのネットワークからの広告をクリックしないでください。どの広告フォーマットでも getMediationAdapterClassName() メソッドを使用すると、現在の広告を配信した広告ネットワークを特定できます。