此页面由 Cloud Translation API 翻译。

定位

本指南介绍了如何向 Google 移动广告 SDK 提供定位信息。

如需查看实际示例，请下载 Android API 演示应用。

下载 API 演示

前提条件

完成入门指南。

RequestConfiguration

RequestConfiguration 会收集全球范围内应用于每个广告请求的定位信息。如需了解可用的定位标记，请参阅 RequestConfiguration.Builder 文档。

要更新请求配置，请从现有的执行任何所需的更新，并按如下所示进行设置：

Kotlin

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

Java

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

面向儿童的设置

为了遵守《儿童在线隐私保护法》 (COPPA), 有一个名为“标记为面向儿童的内容”的设置设置此标记，即表示您确认此通知准确无误并且您已获得授权，可以代表应用的所有者行事。您了解滥用此设置可能会导致账号被终止您的 Google 账号名下。

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

您可以通过setTagForChildDirectedTreatment()：

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

以下示例表明您希望将自己的内容视为是否属于面向儿童的内容：

Kotlin

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

Java

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

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

Kotlin

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

Java

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

不应将用于启用面向儿童的设置的标记和 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：

Kotlin

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

Java

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

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

发布商隐私保护处理措施（Beta 版）

发布商隐私保护处理措施(PPT) API 是一款可选工具，可让应用使用 setPublisherPrivacyPersonalizationState() 方法指明是否要针对所有广告请求关闭广告个性化功能。使用此功能时，该会话余下部分未来的所有广告请求中都会包含发布商隐私保护措施 (PPT) 参数。

默认情况下，Google 在收到广告请求后会投放个性化广告。以下会针对所有广告请求关闭广告个性化功能：

Kotlin

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

Java

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

广告请求

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

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