定位

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

要查看广告定位的实际运作情况，请下载 Swift 或 Objective-C 的 iOS API 演示应用。

下载 API 演示

前提条件

完成入门指南。

GADRequestConfiguration

GADRequestConfiguration 对象通过 GADMobileAds 共享实例收集要全局应用的定位信息。您可以使用以下代码对其进行访问：

Swift

let requestConfiguration = GADMobileAds.sharedInstance().requestConfiguration

Objective-C

GADRequestConfiguration requestConfiguration = GADMobileAds.sharedInstance.requestConfiguration;

面向儿童的设置

为了遵守《儿童在线隐私保护法》(COPPA) 的规定，我们提供了 tagForChildDirectedTreatment 设置。

作为应用开发者，您可以在发出广告请求时表明是否希望 Google 将您的内容视为面向儿童的内容。如果您表明希望 Google 将您的内容视为面向儿童的内容，我们便会采取相应措施，针对该广告请求停用针对用户兴趣投放广告和再营销广告。 设置选项如下所示：

  • 将 tagForChildDirectedTreatment 设置为 YES，以表明您希望根据《儿童在线隐私保护法》(COPPA) 的规定将您的内容视为面向儿童的内容。这会阻止传输广告标识符 (IDFA)。
  • 将 tagForChildDirectedTreatment 设置为 NO，以表明您不希望根据《儿童在线隐私保护法》(COPPA) 的规定将您的内容视为面向儿童的内容。
  • 如果您不希望表明您希望根据《儿童在线隐私保护法》(COPPA) 处理您的内容，请不要设置 tagForChildDirectedTreatment。

以下示例表明您希望根据《儿童在线隐私保护法》(COPPA) 的规定将您的内容视为面向儿童的内容：

Swift

GADMobileAds.sharedInstance().requestConfiguration.tag(forChildDirectedTreatment: true)

Objective-C

[GADMobileAds.sharedInstance.requestConfiguration tagForChildDirectedTreatment:YES];

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

您可以对广告请求进行标记，确保针对未达到法定承诺年龄的欧洲经济区 (EEA) 用户进行处理。这项功能旨在帮助您遵守一般数据保护条例 (GDPR)。请注意，您可能还须承担 GDPR 规定的其他法律义务。具体请查看欧盟的指南和您自己的法律顾问。另外请注意，Google 的工具旨在协助客户遵守法规，并不能免除任何特定发布商按照法律规定所需承担的义务。 详细了解 GDPR 给发布商带来了哪些影响。

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

通过对 GADMobileAds.requestConfiguration 对象调用 tagForUnderAgeOfConsent 方法并传入 YES，此设置可用于所有版本的 Google 移动广告 SDK。

  • 将 tagForUnderAgeOfConsent 设置为 YES 或 true，以表明您希望按适合未达到法定承诺年龄的用户的方式处理广告请求。这也会阻止传输广告标识符 (IDFA)。
  • 未设置 tagForUnderAgeOfConsent 即表明您不希望按适合未达到法定承诺年龄的用户的方式处理广告请求。

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

Swift

GADMobileAds.sharedInstance().requestConfiguration.tagForUnderAgeOfConsent(true);

Objective-C

[GADMobileAds.sharedInstance.requestConfiguration tagForUnderAgeOfConsent:YES];

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

广告内容过滤

应用可以使用 GADRequestConfiguration 的 maxAdContentRating 属性为所有广告请求设置广告内容分级上限。此设置适用于该会话剩余部分未来的所有广告请求。此属性可能的值依数字内容标签分类而定，并应该是以下常量之一：

  • GADMaxAdContentRatingGeneral
  • GADMaxAdContentRatingParentalGuidance
  • GADMaxAdContentRatingTeen
  • GADMaxAdContentRatingMatureAudience

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

Swift

GADMobileAds.sharedInstance().requestConfiguration.maxAdContentRating =
    GADMaxAdContentRatingGeneral

Objective-C

GADMobileAds.sharedInstance.requestConfiguration.maxAdContentRating =
    GADMaxAdContentRatingGeneral;

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";

FAQ

广告自动刷新时会使用什么定位条件？
在广告刷新时，之前指定的 GADRequest 对象会再次用于定位。要设置新的定位，请使用新的 GADRequest 对象明确调用 GADBannerView 上的 loadRequest。
如何将额外的定位参数传递给中介广告联盟？
如需了解如何向中介广告联盟发送定位条件，请参阅中介。