此页面由 Cloud Translation API 翻译。

定位

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

前提条件

完成入门指南。

`RequestConfiguration`

RequestConfiguration 是一个结构体，用于收集要通过 SetRequestConfiguration() 全局函数进行全局应用。

如需更新请求配置，请先获取当前配置，执行任何所需的更新，并按如下所示进行设置：

  firebase::gma::RequestConfiguration retrieved_configuration =
    firebase::gma::GetRequestConfiguration();

  // .. apply your changes, then:

  firebase::gma::SetRequestConfiguration(request_configuration);

“面向儿童”的设置

为了遵守《儿童在线隐私保护法》 (COPPA)，有一个名为“标记为面向儿童的内容”的设置通过设置标记，即表示您确认此通知准确无误，且您有权代表应用所有者执行操作。您了解，滥用此设置我们可能会终止您的 Google 账号。

作为应用开发者，您可以指明是否希望 Google 将您的则将其指定为面向儿童的内容。如果您表明希望 Google 将您的内容视为面向儿童的内容，我们会采取措施以针对该广告请求投放 IBA 和再营销广告。

可以通过分配 RequestConfiguration 结构体的 tag_for_child_directed_treatment 个成员更改为下列枚举值之一：

将RequestConfiguration::tag_for_child_directed_treatment分配给 RequestConfiguration::kChildDirectedTreatmentTrue以指明根据《儿童在线隐私保护法》(COPPA) 的规定，您的内容会被视为面向儿童的内容。
将RequestConfiguration::tag_for_child_directed_treatment分配给 RequestConfiguration::kChildDirectedTreatmentFalse来表明您并不希望根据《儿童在线隐私保护法》(COPPA) 的规定将您的内容视为面向儿童的内容。
将RequestConfiguration::tag_for_child_directed_treatment分配给 RequestConfiguration::kChildDirectedTreatmentUnspecified如果您不想使用以表明您希望如何根据《儿童在线隐私保护法》(COPPA) 。

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

  firebase::gma::RequestConfiguration request_configuration =
    firebase::gma::GetRequestConfiguration();

  request_configuration.tag_for_child_directed_treatment =
    firebase::RequestConfiguration::kChildDirectedTreatmentTrue;

  firebase::gma::SetRequestConfiguration(request_configuration);

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

未达到同意年龄的用户

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

使用此功能时，用于表示欧洲境内用户未达到同意年龄的标记 (TFUA) 参数将包含在广告请求中。此参数会停用个性化广告，包括再营销。它还会禁止向第三方广告供应商（如广告衡量像素和第三方广告服务器

与面向儿童的设置一样，RequestConfiguration 中也有一个成员配置 TFUA 参数：tag_for_under_age_of_consent。该参数可能是并配置了以下枚举值：

将RequestConfiguration::tag_for_under_age_of_consent分配给 RequestConfiguration::kUnderAgeOfConsentTrue，以表示您想要针对欧洲经济区 (EEA) 用户投放的广告请求未达到同意年龄。
将RequestConfiguration::tag_for_under_age_of_consent分配给 RequestConfiguration::kUnderAgeOfConsentFalse，以表示您想要广告请求未得到针对欧洲经济区用户进行处理（欧洲经济区 [EEA]）内的用户未达到同意年龄。
将RequestConfiguration::tag_for_under_age_of_consent分配给 RequestConfiguration::kUnderAgeOfConsentUnspecified来表明您尚未指明是否应按用户标准来处理该广告请求欧洲经济区 (EEA) 内的用户，未达到同意年龄。

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

  firebase::gma::RequestConfiguration request_configuration =
    firebase::gma::GetRequestConfiguration();

  request_configuration.tag_for_under_age_of_consent =
    firebase::RequestConfiguration::kUnderAgeOfConsentTrue;

  firebase::gma::SetRequestConfiguration(request_configuration);

用于启用“面向儿童”设置和未达到同意年龄的用户的代码不应同时设置为 true。如果已启用，则面向儿童设置优先顺序

广告内容过滤

应用可通过 RequestConfiguration::max_ad_content_rating field.AdMob 广告返回的时间配置的内容分级等于或低于该级别。可能出现的取决于数字内容标签分类，下列枚举值之一：

RequestConfiguration::kMaxAdContentRatingG
RequestConfiguration::kMaxAdContentRatingPG
RequestConfiguration::kMaxAdContentRatingT
RequestConfiguration::kMaxAdContentRatingMA

以下代码会配置一个 RequestConfiguration 结构体来指定该广告返回的内容对应的数字内容标签标识为“否” 高于 G：

  firebase::gma::RequestConfiguration request_configuration =
    firebase::gma::GetRequestConfiguration();

  request_configuration.max_ad_content_rating =
    firebase::RequestConfiguration::kMaxAdContentRatingG;

  firebase::gma::SetRequestConfiguration(request_configuration);

`AdRequest`

AdRequest 对象可收集随广告一起发送的定位信息请求。

内容网址

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

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

  // AdRequest with content URL:
  firebase::admob::AdRequest ad_request(/*content_url=*/"https://www.example.com");

  // AdRequest without content URL:
  firebase::admob::AdRequest ad_request();