配置广告透明度网址

您可以通过广告透明度网址，自定义某些广告中显示的 AdChoices 图标。默认情况下，用户会在 Google 提供的“广告信息公开和控制”(AT&C) 界面中看到此图标，该界面包含了广告客户和广告本身等信息。

您可以向 Google 移动广告 SDK 发出广告请求，并在收到的响应中获取广告透明度网址。在您的应用中获取该网址后，您就可以集成一个与广告设计风格相符的个性化图标，并向用户呈现您自己的 AT&C 界面。

本页介绍了如何请求、解析和验证广告透明度网址。

前提条件

在继续之前，请确保您已完成以下操作：

  • 在应用中设置原生广告。如需详细了解原生广告，请参阅 原生广告。
  • 申请将此功能加入许可名单。如需申请访问权限，请联系您的客户经理。
    • 如果您没有访问权限，收到的响应不会返回广告透明度网址，并且默认图标会按预期呈现。

请求网址

为了让 GMA Next-Gen SDK 返回广告透明度网址，您需要在原生广告请求中添加一个额外的请求参数。此参数表示您的应用已准备就绪，可以处理个性化图标。

在请求中，您必须将值为 "1" 的键 "ad_transparency_url_requested" 添加到广告联盟额外信息包中。如需详细了解广告联盟额外信息， 请参阅 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