本指南介绍了如何向 Google 移动广告 SDK 提供定位信息。
如需查看实际示例,请下载 Android 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);
为确保所有广告请求都应用请求配置更改,请在初始化移动广告 SDK 之前设置请求配置。
面向儿童的设置
为了遵守《儿童在线隐私保护法》(COPPA) 的规定,我们提供了一项名为“面向儿童的内容的标记”的设置。设置此标记,即表示您确认此通知准确无误,且您有权代表应用的所有者行事。您了解,滥用此设置可能会导致您的 Google 账号被终止。
作为应用开发者,您可以在发出广告请求时表明是否希望 Google 将您的内容视为面向儿童的内容。如果您表明希望 Google 将您的内容视为面向儿童的内容,我们会采取相应措施,在该广告请求上停用针对用户兴趣投放广告和再营销广告。
您可以通过
setTagForChildDirectedTreatment()
:
使用
TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE
调用setTagForChildDirectedTreatment
,即表明您希望根据《儿童在线隐私保护法》(COPPA) 的规定将您的内容视为面向儿童的内容。这会阻止传输 Android 广告 ID (AAID)。使用
TAG_FOR_CHILD_DIRECTED_TREATMENT_FALSE
调用setTagForChildDirectedTreatment
,即表明您不希望根据《儿童在线隐私保护法》(COPPA) 的规定将您的内容视为面向儿童的内容。如果您不希望在广告请求中表明您想如何根据《儿童在线隐私保护法》(COPPA) 的规定来认定您的内容,请使用
TAG_FOR_CHILD_DIRECTED_TREATMENT_UNSPECIFIED
调用setTagForChildDirectedTreatment
。
以下示例表明您希望根据《儿童在线隐私保护法》(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 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 应用中的广告定位是如何实现的,请参阅广告定位示例。