定位

本指南介绍如何向广告请求提供定位信息。

要查看广告定位的实际效果，请下载采用 Swift 或 Objective-C。

下载 API 演示

前提条件

完成使用入门指南。

GADRequestConfiguration

GADRequestConfiguration 是一个对象，用于收集通过 GADMobileAds 共享实例。您可以使用以下代码访问该实例：

Swift

let requestConfiguration = GADMobileAds.sharedInstance().requestConfiguration

Objective-C

GADRequestConfiguration requestConfiguration = GADMobileAds.sharedInstance.requestConfiguration;

“面向儿童”的设置

为了遵守《儿童在线隐私保护法》 (COPPA)， 有一项设置称为 tagForChildDirectedTreatment。

作为应用开发者，您可以指明是否希望 Google 将您的 则将其指定为面向儿童的内容。如果您表明 如果您希望 Google 将您的内容视为面向儿童的内容，Google 会采取一些措施 来停用针对该广告请求的针对用户兴趣投放广告和再营销广告。设置选项包括 如下所示：

• 将 tagForChildDirectedTreatment 设置为 true，以表明您想要 根据 COPPA 的规定将内容视为面向儿童的内容。这样可以防止 广告标识符 (IDFA) 的传输。
• 将 tagForChildDirectedTreatment 设置为 false，以表明您不需要 根据《儿童在线隐私保护法》(COPPA) 的规定，您的内容会被视为面向儿童的内容。
• 如果您不想指明这一点，请勿设置 tagForChildDirectedTreatment 您希望根据《儿童在线隐私保护法》(COPPA) 的规定来认定您的内容。

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

Swift

GADMobileAds.sharedInstance().requestConfiguration.tagForChildDirectedTreatment = true

Objective-C

GADMobileAds.sharedInstance.requestConfiguration.tagForChildDirectedTreatment = @YES;

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

未达到同意年龄的用户

您可以将广告请求标记为 未达到同意年龄的欧洲经济区 (EEA)。此功能 的宗旨是帮助遵守 数据保护条例 (GDPR)。请注意，您可能还有其他法律规定， GDPR 规定的任何义务。查看欧盟指南并咨询 咨询。请注意，Google 的工具旨在 也不会免除任何特定发布商按照 法律。 详细了解 GDPR 有何影响 发布商。

使用此功能时， 欧洲 (TFUA) 参数将包含在将来的所有广告请求中。 此参数会禁止针对以下对象投放个性化广告，包括再营销广告： 相应广告请求它还会禁止向第三方广告供应商 例如广告衡量像素和第三方广告服务器

此设置可用于所有版本的 Google 移动广告 SDK，具体方法是： 设置 tagForUnderAgeOfConsent 属性（位于 GADMobileAds.requestConfiguration 对象并传入 true。

• 将 tagForUnderAgeOfConsent 设置为 true，以表明您想要广告 请求以适合未满规定年龄的用户的方式进行处理 同意。这还可以防止通过 标识符 (IDFA)
• 未设置 tagForUnderAgeOfConsent 表示您不需要广告 请求以适合未满规定年龄的用户的方式进行处理 同意。

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

Swift

GADMobileAds.sharedInstance().requestConfiguration.tagForUnderAgeOfConsent = true

Objective-C

GADMobileAds.sharedInstance.requestConfiguration.tagForUnderAgeOfConsent = @YES;

用于启用面向儿童的设置的代码 不应同时将 tagForUnderAgeOfConsent 和 tagForUnderAgeOfConsent 设置为 true。 如果同时设置为 true，则以“面向儿童的设置”为准。

要点 ：此 tagForUnderAgeOfConsent 参数不会转发到 适用于第三方广告来源的中介适配器。您有责任 确保应用中的每个第三方广告联盟投放的广告 适用于未达到同意年龄的用户。

广告内容过滤

应用可以针对使用 GADRequestConfiguration 的 maxAdContentRating 属性。此设置适用 所有后续广告请求可能的值 基于数字内容标签 分类，并将其设置为 以下常量：

• GADMaxAdContentRatingGeneral
• GADMaxAdContentRatingParentalGuidance
• GADMaxAdContentRatingTeen
• GADMaxAdContentRatingMatureAudience

以下代码会配置所有广告请求 对应的数字内容标签标识应不高于 GADMaxAdContentRatingGeneral。

要点 ：通过 SDK 指定的内容分级过滤器设置会覆盖任何 使用 AdMob 界面配置的设置。

Swift

GADMobileAds.sharedInstance().requestConfiguration.maxAdContentRating =
    GADMaxAdContentRatingGeneral

Objective-C

GADMobileAds.sharedInstance.requestConfiguration.maxAdContentRating =
    GADMaxAdContentRatingGeneral;

发布商隐私权处理方式（Beta 版）

通过 发布商隐私保护处理 (PPT) API 是一个可选工具，可让应用指明是否关闭广告 针对使用 publisherPrivacyPersonalizationState GADRequestConfiguration 属性。使用此功能时 隐私保护处理 (PPT) 参数 会话的剩余部分

默认情况下，系统会向 Google 发送个性化广告请求。以下 会针对所有广告请求关闭广告个性化功能：

Swift

GADMobileAds.sharedInstance().requestConfiguration.publisherPrivacyPersonalizationState =
    .disabled

Objective-C

GADMobileAds.sharedInstance.requestConfiguration.publisherPrivacyPersonalizationState =
    GADPublisherPrivacyPersonalizationStateDisabled;

注意 ：对于包含多个用户隐私信号的广告请求，限制性最强 信号的优先级。请参阅 Publisher Privacy Treatment API 查看具体的示例文档。

GADRequest

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

内容网址

在请求广告时，应用可以传递自身正在投放的内容的网址。 这样，您就可以进行关键字定位，从而将广告与内容进行匹配。

例如，如果您的应用在显示 https://www.example.com，您可以传递此网址来定位相关的关键字：

Swift

let request = GADRequest()
request.contentURL = "https://www.example.com"

Objective-C

GADRequest *request = [GADRequest request];
request.contentURL = @"https://www.example.com";

常见问题解答

广告自动刷新时会使用什么定位条件？

广告刷新时，之前指定的 GADRequest 对象再次用于定位。 要设置新的定位，请显式调用 上的 loadRequest GADBannerView 有新的 GADRequest 对象。

如何将额外的定位参数传递给中介广告联盟？

请参阅中介，了解如何 将定位条件发送到中介广告联盟。