RequestConfiguration.Builder

public class RequestConfiguration.Builder


RequestConfiguration 的构建器。

摘要

公共构造函数

公共方法

RequestConfiguration

构建 RequestConfiguration

RequestConfiguration.Builder

设置受年龄限制的内容处理配置。

RequestConfiguration.Builder

设置广告内容分级上限。

RequestConfiguration.Builder

设置发布商隐私保护处理个性化状态。

RequestConfiguration.Builder

此方法已弃用。

请改用 setAgeRestrictedTreatment

RequestConfiguration.Builder

此方法已弃用。

请改用 setAgeRestrictedTreatment

RequestConfiguration.Builder

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

公共构造函数

Builder

public Builder()

公共方法

build

public RequestConfiguration build()

构建 RequestConfiguration

setAgeRestrictedTreatment

@CanIgnoreReturnValue
public RequestConfiguration.Builder setAgeRestrictedTreatment(
    @Nullable AgeRestrictedTreatment ageRestrictedTreatment
)

设置受年龄限制的内容处理配置。

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

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

参数
@Nullable AgeRestrictedTreatment ageRestrictedTreatment

年龄限制处理方式,用于指明广告请求应按面向儿童、青少年还是未指定年龄段的内容处理。

setMaxAdContentRating

@CanIgnoreReturnValue
public RequestConfiguration.Builder setMaxAdContentRating(
    @RequestConfiguration.MaxAdContentRating @Nullable String maxAdContentRating
)

设置广告内容分级上限。为您的应用返回的 AdMob 广告的内容分级会等于或低于该上限。有效值包括 MAX_AD_CONTENT_RATING_GMAX_AD_CONTENT_RATING_PGMAX_AD_CONTENT_RATING_TMAX_AD_CONTENT_RATING_MA

setPublisherPrivacyPersonalizationState

@CanIgnoreReturnValue
public RequestConfiguration.Builder setPublisherPrivacyPersonalizationState(
    RequestConfiguration.PublisherPrivacyPersonalizationState publisherPrivacyPersonalizationState
)

设置发布商隐私保护处理个性化状态。

setTagForChildDirectedTreatment

@CanIgnoreReturnValue
public RequestConfiguration.Builder setTagForChildDirectedTreatment(
    @RequestConfiguration.TagForChildDirectedTreatment int tagForChildDirectedTreatment
)

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

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

如果您将此方法设置为 TAG_FOR_CHILD_DIRECTED_TREATMENT_FALSE,则表明您的应用不应被视为面向儿童的内容,以遵守《儿童在线隐私保护法》(COPPA)。

如果您不设置此方法,或者将此方法设置为 TAG_FOR_CHILD_DIRECTED_TREATMENT_UNSPECIFIED,广告请求中将不会包含任何有关您希望如何根据《儿童在线隐私保护法》(COPPA) 的规定来认定您的应用的指示。

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

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

参数
@RequestConfiguration.TagForChildDirectedTreatment int tagForChildDirectedTreatment

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

setTagForUnderAgeOfConsent

@CanIgnoreReturnValue
public RequestConfiguration.Builder setTagForUnderAgeOfConsent(
    @RequestConfiguration.TagForUnderAgeOfConsent int tagForUnderAgeOfConsent
)

您可以使用此方法对应用进行标记,确保针对未达到同意年龄的欧洲经济区 (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
public RequestConfiguration.Builder setTestDeviceIds(@Nullable List<String> testDeviceIds)

设置与测试设备相对应的测试设备 ID 列表,这些测试设备将始终请求测试广告。当发出首个广告请求时,系统会在 Logcat 中记录当前设备的测试设备 ID。

参数
@Nullable List<String> testDeviceIds

测试设备 ID 的列表。传递 null 以清除列表。