本指南介绍了如何向 Google 移动 广告 SDK。
有关有效示例,请下载 Android API Demo 应用。前提条件
- 完成入门指南。
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)。使用以下号码致电
setTagForChildDirectedTreatment
:TAG_FOR_CHILD_DIRECTED_TREATMENT_FALSE
,以表明您不希望 根据 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) 内的用户,未达到同意年龄。使用以下号码致电
setTagForUnderAgeOfConsent()
:TAG_FOR_UNDER_AGE_OF_CONSENT_UNSPECIFIED
,表明您 指明了广告请求是否应该按照 欧洲经济区 (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 应用中广告定位的实现。