此页面由 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 将您的内容视为面向儿童的内容，我们会采取相应措施，在该广告请求上停用针对用户兴趣投放广告和再营销广告。

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

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

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

  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。如果同时设置为 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();