定位

本指南介绍如何为广告请求提供定位信息。如需查看实际示例，请下载 Android API 演示应用。

下载 API 演示

先决条件

• 完成入门指南。

请求配置

RequestConfiguration 对象用于通过 MobileAds 静态方法收集要全局应用的定位信息。

如需更新请求配置，请从现有配置中获取构建器，执行任何所需的更新，然后按如下所示进行设置：

Java

RequestConfiguration requestConfiguration = MobileAds.getRequestConfiguration()
    .toBuilder()
    .build();
MobileAds.setRequestConfiguration(requestConfiguration);

Kotlin

var requestConfiguration = MobileAds.getRequestConfiguration()
  .toBuilder()
  .build()
MobileAds.setRequestConfiguration(requestConfiguration)

面向儿童的设置

为了遵守《儿童在线隐私保护法》(COPPA) 的规定，我们提供了一项名为“面向儿童的内容的标记”的设置。设置此标记，即表示您确认此通知准确无误，且您有权代表应用的所有者行事。您了解，滥用此设置可能会导致您的 Google 帐号被终止。

作为应用开发者，您可以在发出广告请求时表明是否希望 Google 将您的内容视为面向儿童的内容。如果您表明希望 Google 将您的内容视为面向儿童的内容，我们会采取相应措施，在该广告请求中停用针对用户兴趣投放广告和再营销广告。

通过 RequestConfiguration.Builder.setTagForChildDirectedTreatment(int)，此设置可用于所有版本的 Google Play 服务 SDK：

• 使用 TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE 调用 setTagForChildDirectedTreatment，即表明您希望根据《儿童在线隐私保护法》(COPPA) 的规定将您的内容视为面向儿童的内容。这样可以阻止传输 Android 广告标识符 (AAID)。

• 使用 TAG_FOR_CHILD_DIRECTED_TREATMENT_FALSE 调用 setTagForChildDirectedTreatment，即表明您不希望根据《儿童在线隐私保护法》(COPPA) 的规定将您的内容视为面向儿童的内容。

• 如果您不想在广告请求中表明您想如何根据《儿童在线隐私保护法》(COPPA) 的规定来认定您的内容，请使用 TAG_FOR_CHILD_DIRECTED_TREATMENT_UNSPECIFIED 调用 setTagForChildDirectedTreatment。

以下示例表明您希望根据《儿童在线隐私保护法》(COPPA) 的规定将您的内容视为面向儿童的内容：

Java

RequestConfiguration requestConfiguration = MobileAds.getRequestConfiguration()
    .toBuilder()
    .setTagForChildDirectedTreatment(RequestConfiguration.TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE)
    .build();
MobileAds.setRequestConfiguration(requestConfiguration);

Kotlin

var requestConfiguration = MobileAds.getRequestConfiguration()
  .toBuilder()
  .setTagForChildDirectedTreatment(RequestConfiguration.TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE)
  .build()
MobileAds.setRequestConfiguration(requestConfiguration)

注意：亲子同乐计划中的应用为 主要面向儿童的应用 ，以及通过 Family Link 登录的 Google 帐号会自动将所有广告请求的所有内容都视为面向儿童的内容。

未达到同意年龄的用户

您可以对广告请求进行标记，确保针对未达到法定承诺年龄的欧洲经济区 (EEA) 用户投放的是合适的广告。这项功能旨在帮助您遵守一般数据保护条例 (GDPR)。请注意，您可能还须承担 GDPR 规定的其他法律义务。具体请查看欧盟发布的指南，并咨询您自己的法律顾问。另外请注意，Google 的工具旨在协助发布商遵守法规，但并不能免除任何特定发布商按照法律规定所需承担的义务。 详细了解 GDPR 给发布商带来了哪些影响。

使用这项功能时，广告请求中会包含一个用于表示用户位于欧洲且未达到法定承诺年龄的标记 (TFUA) 参数。此参数会禁止针对所有广告请求投放个性化广告，包括再营销广告。它还禁止向第三方广告供应商（例如广告衡量像素和第三方广告服务器）发送请求。

与面向儿童的设置一样，RequestConfiguration.Builder 中有用于设置 TFUA 参数的 setTagForUnderAgeOfConsent() 方法，其中包括以下选项。

• 使用 TAG_FOR_UNDER_AGE_OF_CONSENT_TRUE 调用 setTagForUnderAgeOfConsent()，即表明您希望按适合未达到法定承诺年龄的欧洲经济区 (EEA) 用户的方式处理该广告请求。这也将阻止传输 Android 广告标识符 (AAID)。

• 使用 TAG_FOR_UNDER_AGE_OF_CONSENT_FALSE 调用 setTagForUnderAgeOfConsent()，即表明您不希望按适合未达到法定承诺年龄的欧洲经济区 (EEA) 用户的方式处理该广告请求。

• 使用 TAG_FOR_UNDER_AGE_OF_CONSENT_UNSPECIFIED 调用 setTagForUnderAgeOfConsent()，即表明您未明确是否按适合未达到法定承诺年龄的欧洲经济区 (EEA) 用户的方式处理该广告请求。

以下示例表明您希望广告请求中包含 TFUA 标记：

Java

RequestConfiguration requestConfiguration = MobileAds.getRequestConfiguration()
    .toBuilder()
    .setTagForUnderAgeOfConsent(RequestConfiguration.TAG_FOR_UNDER_AGE_OF_CONSENT_TRUE)
    .build();
MobileAds.setRequestConfiguration(requestConfiguration);

Kotlin

var requestConfiguration = MobileAds.getRequestConfiguration()
  .toBuilder()
  .setTagForUnderAgeOfConsent(RequestConfiguration.TAG_FOR_UNDER_AGE_OF_CONSENT_TRUE)
  .build()
MobileAds.setRequestConfiguration(requestConfiguration)

不应将用于启用面向儿童的设置的标记和 setTagForUnderAgeOfConsent() 同时设置为 true。如果同时设置为 true，则以“面向儿童的设置”为准。

广告内容过滤

为了符合 Google Play 的“不当内容”政策（包括广告中的相关优惠），应用内展示的所有广告及其相关优惠都必须适合应用的内容分级，即使内容本身在其他方面符合 Google Play 政策也是如此。

广告内容分级上限等工具有助于您更好地控制向用户展示的广告内容。您可以设置最高内容分级，以帮助遵守平台政策。

应用可以使用 setMaxAdContentRating 方法为其广告请求设置广告内容分级上限。如果配置了此方法，所返回的 AdMob 广告的内容分级会等于或低于该上限。此广告联盟额外参数可能的值依数字内容标签分类而定，并且必须是以下字符串之一：

• MAX_AD_CONTENT_RATING_G
• MAX_AD_CONTENT_RATING_PG
• MAX_AD_CONTENT_RATING_T
• MAX_AD_CONTENT_RATING_MA

以下代码会配置 RequestConfiguration 对象，以指定返回的广告内容所对应的数字内容标签不应高于 G：

Java

RequestConfiguration requestConfiguration = MobileAds.getRequestConfiguration()
    .toBuilder()
    .setMaxAdContentRating(RequestConfiguration.MAX_AD_CONTENT_RATING_G)
    .build();
MobileAds.setRequestConfiguration(requestConfiguration);

Kotlin

var requestConfiguration = MobileAds.getRequestConfiguration()
  .toBuilder()
  .setMaxAdContentRating(RequestConfiguration.MAX_AD_CONTENT_RATING_G)
  .build()
MobileAds.setRequestConfiguration(requestConfiguration)

详细了解以下内容：

• 为每个广告请求设置内容分级上限

• 为应用或帐号设置广告内容分级上限

注意：通过 Google 移动广告 SDK 指定的内容分级过滤器设置会替换使用 AdMob 界面配置的所有设置。

广告请求

AdRequest 对象可收集随广告请求一起发送的定位信息。

如需了解 Android API Demo 应用中广告定位的实现方式，请参阅广告定位示例。