設定廣告資訊公開政策網址

您可利用廣告資訊公開網址,自訂特定廣告顯示的 AdChoices 圖示。根據預設,使用者會在 Google 顯示的廣告資訊公開和控管 (AT&C) 體驗中看見這個圖示,其中包含廣告主和廣告本身等資訊。

您可以向 Google Mobile Ads SDK 發出廣告請求,並在收到的回應中取得廣告資訊公開網址。在應用程式中收到網址後,您可以整合至符合廣告設計的個人化圖示,向使用者提供專屬的 AT&C 體驗。

本頁說明如何要求、剖析及驗證廣告資訊公開網址。

必要條件

繼續操作前,請務必先完成下列工作:

  • 在應用程式中設定原生廣告。如要進一步瞭解原生廣告,請參閱「原生廣告」一文。
  • 要求這項功能的許可清單存取權。如需要求存取權,請與客戶經理聯絡。
    • 若您沒有存取權,回應就不會傳回廣告資訊公開網址,且會照常顯示預設圖示。

要求網址

請在原生廣告請求中加入額外的請求參數,GMA Next-Gen SDK 才會傳回廣告資訊公開網址。這項參數表示應用程式已準備好處理個人化圖示。

在要求中,您須將鍵 "ad_transparency_url_requested" 連同值 "1",新增至聯播網額外資訊組合。如要進一步瞭解聯播網額外資訊,請參閱「setGoogleExtrasBundle」。

請參考以下範例,設定這個鍵和值來要求廣告資訊公開網址:

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

剖析網址

要求網址後,您會收到廣告回應,回應資訊物件中包含廣告資訊公開網址。如要進一步瞭解回應資訊物件,請參閱「回應資訊」一文。

您可以透過回應額外資訊中的 "ad_transparency_url" 鍵,存取廣告資訊公開網址。請參考以下範例,在回應資訊物件中取得廣告資訊公開網址:

Java

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

Kotlin

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

驗證網址

如要測試和驗證廣告資訊公開網址,請確認原生廣告中顯示的是個人化圖示,而非 Google 提供的預設圖示。按一下圖示即可查看 AT&C 體驗。

此外,請確認回應資訊物件的回應額外資訊中,含有廣告資訊公開網址。若未看見廣告資訊公開網址,則個人化圖示的位置,會顯示預設的 Google 圖示。以下是廣告資訊公開網址的範例:

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