RequestConfiguration.Builder

class RequestConfiguration.Builder

RequestConfiguration 的构建器。

摘要

公共构造函数

公共函数
RequestConfiguration!

构建 RequestConfiguration。
RequestConfiguration.Builder!

设置年龄限制处理方式配置。
RequestConfiguration.Builder!

设置广告内容分级上限。
RequestConfiguration.Builder!

设置发布商隐私处理方式个性化状态。
RequestConfiguration.Builder!

此函数已废弃。

请改用 setAgeRestrictedTreatment。
RequestConfiguration.Builder!

此函数已废弃。

请改用 setAgeRestrictedTreatment。
RequestConfiguration.Builder!

设置与测试设备对应的测试设备 ID 列表，这些测试设备将始终请求测试广告。

公共构造函数

构建器

Builder()

公共函数

build

fun build(): RequestConfiguration!

构建 RequestConfiguration。

setAgeRestrictedTreatment

@CanIgnoreReturnValue
fun setAgeRestrictedTreatment(
    ageRestrictedTreatment: AgeRestrictedTreatment?
): RequestConfiguration.Builder!

设置年龄限制处理方式配置。

请咨询您自己的法律顾问，根据您的法律和监管要求，为用户确定年龄处理方式设置。如需详细了解此设置，请参阅 https://developers.google.com/admob/android/targeting#set_the_age_treatment

设置此属性，即表示您确认此通知准确无误，且您有权代表应用的所有者行事。您了解，滥用此设置可能会导致您的 Google 账号被终止。

参数
ageRestrictedTreatment: AgeRestrictedTreatment?

年龄限制处理方式，用于指明广告请求应被视为面向儿童、青少年还是未指定。

setMaxAdContentRating

@CanIgnoreReturnValue
fun setMaxAdContentRating(
    @RequestConfiguration.MaxAdContentRating maxAdContentRating: String?
): RequestConfiguration.Builder!

设置广告内容分级上限。为您的应用返回的 AdMob 广告的内容分级将等于或低于该上限。有效值包括 MAX_AD_CONTENT_RATING_G、MAX_AD_CONTENT_RATING_PG、MAX_AD_CONTENT_RATING_T 和 MAX_AD_CONTENT_RATING_MA。

setPublisherPrivacyPersonalizationState

@CanIgnoreReturnValue
fun setPublisherPrivacyPersonalizationState(
    publisherPrivacyPersonalizationState: RequestConfiguration.PublisherPrivacyPersonalizationState!
): RequestConfiguration.Builder!

设置发布商隐私处理方式个性化状态。

setTagForChildDirectedTreatment

@CanIgnoreReturnValue
fun setTagForChildDirectedTreatment(
    @RequestConfiguration.TagForChildDirectedTreatment tagForChildDirectedTreatment: Int
): RequestConfiguration.Builder!

借助此方法，您可以指定是否希望您的应用根据《儿童在线隐私保护法》(COPPA) 的规定被视为面向儿童的内容 - http://business.ftc.gov/privacy-and-security/childrens-privacy。

如果您将此方法设置为 TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE，则表示您希望 Google 根据《儿童在线隐私保护法》(COPPA) 的规定将您的应用视为面向儿童的内容。

如果您将此方法设置为 TAG_FOR_CHILD_DIRECTED_TREATMENT_FALSE，则表示您不希望 Google 根据《儿童在线隐私保护法》(COPPA) 的规定将您的应用视为面向儿童的内容。

如果您未设置此方法，或将此方法设置为 TAG_FOR_CHILD_DIRECTED_TREATMENT_UNSPECIFIED，则广告请求不会指明您希望 Google 根据《儿童在线隐私保护法》(COPPA) 的规定如何处理您的应用。

设置此方法，即表示您确认此通知准确无误，且您有权代表应用的所有者行事。您了解，滥用此设置可能会导致您的 Google 账号被终止。

注意：该标记可能要过一段时间才能在适用的 Google 服务中完全生效。

参数
@RequestConfiguration.TagForChildDirectedTreatment tagForChildDirectedTreatment: Int

设置为 true，以表明您的应用应被视为面向儿童的内容。设置为 false，以表明您的应用不应被视为面向儿童的内容。

setTagForUnderAgeOfConsent

@CanIgnoreReturnValue
fun setTagForUnderAgeOfConsent(
    @RequestConfiguration.TagForUnderAgeOfConsent tagForUnderAgeOfConsent: Int
): RequestConfiguration.Builder!

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

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

如果您将此方法设置为 TAG_FOR_UNDER_AGE_OF_CONSENT_TRUE，则表示您希望按适合未达到法定同意年龄的用户的方式处理您的应用。

如果您将此方法设置为 TAG_FOR_UNDER_AGE_OF_CONSENT_FALSE，则表示您不希望按适合未达到法定同意年龄的用户的方式处理您的应用。

如果您未设置此方法，或将此方法设置为 TAG_FOR_UNDER_AGE_OF_CONSENT_UNSPECIFIED，则您的应用不会指明您希望按适合未达到法定同意年龄的用户的方式处理您的应用。

setTestDeviceIds

@CanIgnoreReturnValue
fun setTestDeviceIds(testDeviceIds: (Mutable)List<String!>?): RequestConfiguration.Builder!

设置与测试设备对应的测试设备 ID 列表，这些测试设备将始终请求测试广告。当发出第一个广告请求时，当前设备的测试设备 ID 会记录在 logcat 中。

参数
testDeviceIds: (Mutable)List<String!>?

测试设备 ID 列表。传递 null 以清除列表。
返回
RequestConfiguration.Builder!

Builder