此页面由 Cloud Translation API 翻译。

定位

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

要查看广告定位的实际效果，请下载采用 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，则以“面向儿童的设置”为准。

广告内容过滤

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

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;

GAMRequest

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

内容网址

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

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

Swift

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

Objective-C

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

自定义定位

在 Ad Manager 界面中配置键值对后，与广告请求中的键值对相关联。定位到这些键的订单项然后才有资格针对该广告请求投放。定位多个值请以逗号分隔字符串的形式输入值。

Swift

let request = GAMRequest()
request.customTargeting = ["gender" : "male", "section" : "health,fitness"];

Objective-C

GAMRequest *request = [GAMRequest request];
request.customTargeting = @{@"gender" : @"male", @"section" : @"health,fitness"};

品牌保障（Beta 版）

如果应用针对不同的受众群体显示动态内容，通过 neighboringContentURLs 属性获取简短的网址列表。相邻项内容网址与 contentURL 属性的不同之处在于，前者仅用于。

假设您的应用在一个 Feed 中显示来自 4 个网址的内容，并且该网址还包含广告。您可以请求与这些网址采用相近的广告，方法是：传递它们的方式如下：

Swift

let request = GAMRequest()
request.neighboringContentURLs =
    ["https://www.example1.com", "https://www.example2.com",
    "https://www.example3.com", "https://www.example4.com"]

Objective-C

GAMRequest *request = [GAMRequest request];
request.neighboringContentURLs =
    @[@"https://www.example1.com", @"https://www.example2.com",
    @"https://www.example3.com", @"https://www.example4.com"];

发布商提供的标识符 (PPID)

您可以设置发布商提供的标识符 (PPID)，以用于频次上限受众群细分和定位、依序广告轮播以及基于受众群体的广告投放控制功能。

PPID 设置通过 GAMRequest 完成：

Swift

let request = GAMRequest()
request.publisherProvidedID = "AB123456789"

Objective-C

GAMRequest *request = [GAMRequest request];
request.publisherProvidedID = @"AB123456789";

有关发布商提供的实施方式，请参阅 Ad Manager PPID 示例 iOS API Demo 应用中的 PPID：

Swift Objective-C

发布商提供的信号

您可以将受众群体和情境数据作为发布商提供的信号 (PPS)。借助 PPS，您可以利用自己的用户数据来通过向广告主传达您的受众群体特征所有出价方交易类型，使用标准类目，无需共享用户标识符。你的观众特征可能包括行为数据和兴趣数据（ IAB 受众群体类目 1.1）和情境数据（ IAB 内容类目 2.2）。

Swift

let extras = GADExtras()
extras.additionalParameters = [
    // Set the demographic to an audience with an "Age Range" of 30-34 and an
    // interest in mergers and acquisitions.
    "IAB_AUDIENCE_1_1": [6, 284],
    // Set the content to sedan, station wagon and SUV automotive values.
    "IAB_CONTENT_2_2": [4, 5, 6]
]

let request = GAMRequest()()
request.register(extras)

Objective-C

GADExtras *extras = [[GADExtras alloc] init];
extras.additionalParameters = @{
    // Set the demographic to an audience with an "Age Range" of 30-34 and an
    // interest in mergers and acquisitions.
    @"IAB_AUDIENCE_1_1":@[@6, @284],
    // Set the content to sedan, station wagon and SUV automotive values.
    @"IAB_CONTENT_2_2":@[@4,@5,@6]
};

GAMRequest *request = [GAMRequest request];
[request registerAdNetworkExtras:extras];

常见问题解答

广告自动刷新时会使用什么定位条件？: 广告刷新时，之前指定的 GAMRequest 对象再次用于定位。要设置新的定位，请显式调用上的 loadRequest GAMBannerView 有新的 GAMRequest 对象。
如何将额外的定位参数传递给中介广告联盟？: 请参阅中介，了解如何将定位条件发送到中介广告联盟。