定位

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

前提条件

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

以下示例表明您希望根据《儿童在线隐私保护法》(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。如果同时设置为 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();