此页面由 Cloud Translation API 翻译。

定位

本指南介绍如何向广告请求提供定位信息。对于请下载 Android API Demo 应用

下载 API 演示

前提条件

完成入门指南。

RequestConfiguration

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 将您的内容视为面向儿童的内容，我们会采取措施停用针对该广告请求的针对用户兴趣投放广告和再营销广告。

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

使用以下号码致电 setTagForChildDirectedTreatment： TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE，以表明您想要根据 COPPA 的规定将内容视为面向儿童的内容。这可防止 Android 广告标识符的传输 (AAID)。
使用以下号码致电 setTagForChildDirectedTreatment： TAG_FOR_CHILD_DIRECTED_TREATMENT_FALSE，以表明您不希望根据 COPPA 的规定将内容视为面向儿童的内容。
使用以下号码致电 setTagForChildDirectedTreatment： TAG_FOR_CHILD_DIRECTED_TREATMENT_UNSPECIFIED（如果您不想指明）在广告请求中，您希望如何根据《儿童在线隐私保护法》(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)

未达到同意年龄的用户

您可以将广告请求标记为欧洲经济区 (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) 内的用户，未达到同意年龄。
使用以下号码致电 setTagForUnderAgeOfConsent()： TAG_FOR_UNDER_AGE_OF_CONSENT_UNSPECIFIED，表明您指明了广告请求是否应该按照未达到同意年龄的欧洲经济区 (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() 和 setTagForUnderAgeOfConsent() 同时设置为 true。如果同时设置为 true，则以“面向儿童的设置”为准。

广告内容过滤

遵守 Google Play 的“不恰当的广告”政策其中包括广告内的相关优惠、所有广告及其相关应用中展示的优惠必须适合评分（共即使内容本身在其他方面符合 Google 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)

不妨查看以下内容了解详情：

发布商隐私权处理方式（Beta 版）

通过发布商隐私保护处理 (PPT) API 是一个可选工具，可让应用指明是否关闭广告针对使用 setPublisherPrivacyPersonalizationState() 方法。使用此功能时，发布商隐私保护处理 (PPT) 参数包含在此会话剩余时间内的所有后续广告请求中

默认情况下，系统会向 Google 发送个性化广告请求。以下会针对所有广告请求关闭广告个性化功能：

Java

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

Kotlin

var requestConfiguration = MobileAds.getRequestConfiguration()
  .toBuilder()
  .setPublisherPrivacyPersonalizationState(PublisherPrivacyPersonalizationState.DISABLED)
  .build()
MobileAds.setRequestConfiguration(requestConfiguration)

广告请求

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

参阅广告定位示例了解 Android API Demo 应用中广告定位的实现。