Targeting

通过定位功能，您可以向 Google Mobile Ads SDK for React Native 提供情境和受众群体信息，以便向用户投放相关广告。

您可以在以下级别配置定位条件：

  • 全局请求配置：将设置应用于应用中的所有广告请求，包括儿童和青少年年龄分级保护、广告内容分级上限、发布商隐私保护和测试设备 ID。
  • 按请求定位：使用广告请求对象（包括内容网址和广告联盟额外信息）自定义单个广告请求。

本指南介绍了如何向 Google Mobile Ads SDK for React Native 提供定位信息。

前提条件

在继续操作之前，请设置 Google Mobile Ads SDK for React Native。

设置请求配置

RequestConfiguration 对象用于收集在全局范围内应用于每个广告请求的定位信息。

如需应用第一个广告请求中的定位设置，请在调用 initialize 方法时设置 requestConfiguration 属性：

const requestConfiguration: RequestConfiguration = {
  maxAdContentRating: MaxAdContentRating.G,
  ageRestrictedTreatment: AgeRestrictedTreatment.CHILD,
  publisherPrivacyPersonalizationState:
    PublisherPrivacyPersonalizationState.DISABLED,
  testDeviceIds: ["TEST_DEVICE_HASHED_ID"],
};

initialize({requestConfiguration}, (_status: InitializationStatus) => {
  // SDK initialization is complete.
});

将 TEST_DEVICE_HASHED_ID 替换为经过哈希处理的测试设备 ID。此 ID 用于指定应接收测试广告的设备。

如需在初始化 Google Mobile Ads SDK for React Native 后更新定位设置，请调用 setRequestConfiguration 方法。setRequestConfiguration 方法会替换现有配置，并对后续广告请求生效。

以下示例使用更新后的定位设置修改 RequestConfiguration 对象，并将这些设置应用于广告请求：

const requestConfiguration: RequestConfiguration = {
  ...getRequestConfiguration(),
  maxAdContentRating: MaxAdContentRating.PG,
  ageRestrictedTreatment: AgeRestrictedTreatment.TEEN,
};

setRequestConfiguration(requestConfiguration);

设置年龄处理方式

为了帮助您遵守与儿童和青少年相关的适用隐私权法规，Google Mobile Ads SDK for React Native 提供了一项年龄处理方式设置。通过年龄分级保护方式设置，您可以指明 Google Mobile Ads SDK for React Native 是否应采用面向儿童、青少年或年龄不明用户的特定广告投放保护措施。

您可以在 RequestConfiguration 上使用 ageRestrictedTreatment 属性设置年龄处理方式。

以下示例表明广告请求应按适用于儿童的处理方式处理：

const requestConfiguration: RequestConfiguration = {
  // Indicate that ad requests should have child age treatment.
  ageRestrictedTreatment: AgeRestrictedTreatment.CHILD,
};

setRequestConfiguration(requestConfiguration);

如需指明面向青少年或年龄不明用户的年龄处理方式，请将 AgeRestrictedTreatment.CHILD 设置替换为以下内容：

使用此设置时，Google Mobile Ads SDK for React Native 会在广告请求中包含 tfat 参数。请咨询您的法律顾问，依据自身的法律及监管义务，为用户确定适用的年龄分级保护方式。如需了解详情，请参阅将应用发出的广告请求标记为受年龄限制的处理。

过滤广告内容

借助“广告内容分级上限”，您可以控制向用户展示的广告内容。设置内容分级上限可帮助您遵守平台政策。

您可以使用 RequestConfiguration 对象上的 maxAdContentRating 属性，为应用中的广告请求设置广告内容分级上限。配置此设置后，返回的广告的内容分级将不高于该上限。此设置的可选值取决于数字内容标签分类，并且必须是以下常量之一：

以下示例会配置 RequestConfiguration 对象，以指定返回的广告内容所对应的数字内容标签不得高于 G 常量：

const requestConfiguration: RequestConfiguration = {
  maxAdContentRating: MaxAdContentRating.G,
};

setRequestConfiguration(requestConfiguration);

有关详情，请参阅：

可选：设置 PPT API（Beta 版）

Publisher Privacy Treatment (PPT) API 可让您使用 RequestConfiguration 对象上的 publisherPrivacyPersonalizationState 属性表明是否针对所有广告请求关闭广告个性化设置。使用这项功能时，在当前会话的剩余时间内，Google Mobile Ads SDK for React Native 会在所有广告请求中包含一个 PPT 参数。

默认情况下，对于向 Google 发送的广告请求，系统会返回个性化广告。以下示例会针对所有广告请求关闭广告个性化设置：

const requestConfiguration: RequestConfiguration = {
  publisherPrivacyPersonalizationState:
    PublisherPrivacyPersonalizationState.DISABLED,
};

setRequestConfiguration(requestConfiguration);

设置 AdRequest 对象

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

与使用 setRequestConfiguration 方法设置的全局配置不同，AdRequest 对象会传递给广告格式类的 load 方法，例如，插页式广告的 InterstitialAd.load 或横幅广告的 BannerAd.load。

添加广告联盟额外信息

如需将广告资源网专用参数（例如可折叠广告的参数）传递给 Google Mobile Ads SDK for React Native，请使用 extras 属性。

以下示例设置了一个额外的参数键 collapsible（值为 bottom）：

const request: AdRequest = {
  adUnitId: AD_UNIT_ID,
  extras: {
    collapsible: 'bottom',
  },
};

提供内容网址

如需针对内容定位广告和品牌保障提供内容网址，请添加 contentUrl 属性：

const request: AdRequest = {
  adUnitId: AD_UNIT_ID,
  contentUrl: 'https://www.example.com',
};

内容网址不得超过 512 个字符。