広告の透明性 URL を設定する

広告の透明性 URL を使用すると、特定の広告に表示される AdChoices アイコンをカスタマイズできます。デフォルトでは、このアイコンは、広告主や広告自体などの情報を含む、Google がレンダリングした広告の透明性と管理（AT&C）の機能を通じてユーザーに表示されます。

広告の透明性 URL は、Google Mobile Ads SDK に広告リクエストを送信し、広告の透明性 URL を含むレスポンスを受け取ることで取得できます。アプリ内で URL を受け取ったら、広告のデザインに合うようカスタマイズされたアイコンを統合し、独自の AT&C エクスペリエンスをユーザーに提供できます。

このページでは、広告の透明性 URL をリクエスト、解析、検証する方法について説明します。

前提条件

先に進む前に、次のことを完了してください。

  • アプリにネイティブ広告を設定します。ネイティブ広告の詳細については、ネイティブ広告をご覧ください。
  • この機能の許可リストへの追加をリクエストします。アクセス権のリクエストについては、アカウント マネージャーにお問い合わせください。
    • アクセス権がない場合はレスポンスで広告の透明性 URL が返されず、デフォルトのアイコンは意図したとおりにレンダリングされます。

URL をリクエストする

GMA Next-Gen SDK で広告の透明性 URL を返すには、ネイティブ広告リクエストに追加のリクエスト パラメータを追加します。このパラメータは、カスタマイズされたアイコンをアプリが処理する準備ができていることを示します。

リクエストでは、値 "1" を持つキー "ad_transparency_url_requested" をネットワーク追加情報バンドルに追加する必要があります。ネットワーク追加情報の詳細については、setGoogleExtrasBundle をご覧ください。

次の例では、このキーと値を設定して広告の透明性 URL をリクエストしています。

Java

private void loadNativeAd() {
  // Create an extra parameter that signals your AT&C implementation.
  Bundle extras = new Bundle();
  extras.putString("ad_transparency_url_requested", "1");
  NativeAdRequest adRequest = new NativeAdRequest.Builder("AD_UNIT_ID", List.of(NativeAdType.NATIVE))
      .setGoogleExtrasBundle(extras)
      .build();
}

Kotlin

private fun loadNativeAd() {
  // Create an extra parameter that signals your AT&C implementation
  val extras = Bundle()
  extras.putString("ad_transparency_url_requested", "1");
  val adRequest = NativeAdRequest.Builder("AD_UNIT_ID", listOf(NativeAd.NativeAdType.NATIVE))
    .setGoogleExtrasBundle(extras)
    .build()
}

AD_UNIT_ID は、実際の広告ユニット ID に置き換えます。たとえば、ネイティブ広告の場合は ca-app-pub-3940256099942544/2247696110 です。

URL を解析する

URL をリクエストすると、レスポンス情報オブジェクトに広告の透明性に関する URL が含まれた広告レスポンスが返されます。レスポンス情報オブジェクトの詳細については、レスポンス情報をご覧ください。

レスポンス追加情報から "ad_transparency_url" キー内の広告の透明性 URL にアクセスできます。次の例では、レスポンス情報オブジェクトで広告の透明性 URL を取得しています。

Java

nativeAd.getResponseInfo().getResponseExtras().getString("ad_transparency_url");

Kotlin

nativeAd.getResponseInfo().responseExtras.getString("ad_transparency_url")

URL を検証する

広告の透明性 URL をテストして検証するには、ネイティブ広告に Google が提供するデフォルトのアイコンではなく、カスタマイズされたアイコンが表示されることを確認します。アイコンをクリックして、AT&C の画面を表示します。

また、レスポンス情報オブジェクトのレスポンス追加情報に広告の透明性 URL が表示されることを確認します。広告の透明性 URL が表示されない場合は、カスタマイズされたアイコンの代わりにデフォルトの Google アイコンが表示されます。広告の透明性レポートの URL の例を次に示します。

https://adssettings.google.com/whythisad?source=display&reasons=REASON_ID