指定目標

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

要查看广告定位的实际效果,请下载采用 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;

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

广告内容过滤

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

  • GADMaxAdContentRatingGeneral
  • GADMaxAdContentRatingParentalGuidance
  • GADMaxAdContentRatingTeen
  • GADMaxAdContentRatingMatureAudience

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

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;

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 对象。
如何将额外的定位参数传递给中介广告联盟?
请参阅中介,了解如何 将定位条件发送到中介广告联盟。