定位

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

前提条件

请求配置

RequestConfiguration 对象会收集每个广告请求的全局配置，并通过调用 MobileAds.SetRequestConfiguration() 进行应用。

以下示例使用包含测试设备 ID 的 RequestConfiguration 对象设置 MobileAds：

// Configure your RequestConfiguration with Test Device Ids.
MobileAds.SetRequestConfiguration(new RequestConfiguration
{
    TestDeviceIds = TestDeviceIds
});

为确保所有广告请求都应用请求配置更改，请在初始化 SDK 之前设置请求配置。

面向儿童的设置

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

作为应用开发者，您可以在发出广告请求时表明是否希望 Google 将您的内容视为面向儿童的内容。如果您表明希望 Google 将您的内容视为面向儿童的内容，SDK 会采取相应措施，在该广告请求上停用针对用户兴趣投放广告和再营销广告。

通过使用 RequestConfiguration.TagForChildDirectedTreatment)，该设置可用于所有版本的 Google Play 服务 SDK：

  • 使用 TagForChildDirectedTreatment.True 设置 TagForChildDirectedTreatment，以表明您希望根据《儿童在线隐私保护法》(COPPA) 的规定将您的内容视为面向儿童的内容。此设置可防止传输 Android 广告 ID (AAID)。

  • 使用 TagForChildDirectedTreatment.False 设置 TagForChildDirectedTreatment，即表明您不希望根据《儿童在线隐私保护法》(COPPA) 的规定将您的内容视为面向儿童的内容。

  • 如果您不希望在广告请求中表明您想如何根据《儿童在线隐私保护法》(COPPA) 的规定来认定您的内容，请使用 null 设置 TagForChildDirectedTreatment。

以下示例表明您希望根据《儿童在线隐私保护法》(COPPA) 的规定将您的内容视为面向儿童的内容：

MobileAds.SetRequestConfiguration(new RequestConfiguration
{
    TagForChildDirectedTreatment = TagForChildDirectedTreatment.True
});

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

使用此功能时，广告请求中会包含一个用于表示用户位于欧洲且未达到法定承诺年龄的标记 (TFUA) 参数。此参数会禁止针对所有广告请求投放个性化广告（包括再营销广告）。并且还会禁止向第三方广告供应商（例如广告衡量像素和第三方广告服务器）发送请求。

与面向儿童的设置一样，RequestConfiguration 中有用于设置 TFUA 参数的 TagForUnderAgeOfConsent 方法，其中包括以下选项。

  • 使用 TagForUnderAgeOfConsent.True 设置 TagForUnderAgeOfConsent，以表明您希望按适合未达到法定承诺年龄的欧洲经济区 (EEA) 用户的方式处理广告请求。此设置可防止传输 Android 广告 ID (AAID)。

  • 使用 TagForUnderAgeOfConsent.False 设置 TagForUnderAgeOfConsent，即表明您不希望按适合未达到法定承诺年龄的欧洲经济区 (EEA) 用户的方式处理该广告请求。

  • 使用 null 设置 TagForUnderAgeOfConsent，即表明您未明确是否按适合未达到法定承诺年龄的欧洲经济区 (EEA) 用户的方式处理该广告请求。

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

MobileAds.SetRequestConfiguration(new RequestConfiguration
{
    TagForUnderAgeOfConsent = TagForUnderAgeOfConsent.True
});

不应将用于启用面向儿童的设置的标记和 TagForUnderAgeOfConsent 同时设置为 true。如果同时设置为 true，则以“面向儿童的设置”为准。

广告内容过滤

为遵守 Google Play 的不当广告政策（其中包括广告中的相关优惠），应用中展示的所有广告及其相关优惠都必须符合应用的内容分级，即使广告内容本身符合 Google Play 政策也是如此。

“广告内容分级上限”等工具可让您更好地控制向用户展示的广告内容。您可以设置内容分级上限，以便遵守平台政策。

应用可以使用 MaxAdContentRating 字段为其广告请求设置广告内容分级上限。如果配置了此设置，所返回的 AdMob 广告的内容分级会等于或低于请求的内容分级。

此广告联盟额外参数可能的值依数字内容标签分类而定，并且必须是以下字符串之一：

  • MaxAdContentRating.G
  • MaxAdContentRating.PG
  • MaxAdContentRating.T
  • MaxAdContentRating.MA

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

MobileAds.SetRequestConfiguration(new RequestConfiguration
{
    MaxAdContentRating = MaxAdContentRating.G
});

如需详细了解内容分级上限，请参阅以下内容：

广告请求

AdManagerAdRequest 对象可收集广告请求的定位信息。

自定义定位

您可以通过 AdManagerAdRequest.AddCustomTargeting() 传递自定义键值对，以定位 Google Ad Manager 广告系列订单项：

以下示例将自定义定位年龄作为 25 传递：

// Example: Pass custom targeting "age=25".
AdManagerAdRequest newRequest = new AdManagerAdRequest
{
    CustomTargeting = new Dictionary<string, string>
    {
        { "age", "25"}
    }
};

以下示例定位的是年龄介于 24 到 26 周岁的用户：

AdManagerAdRequest newRequest = new AdManagerAdRequest
{
    CustomTargeting = new Dictionary<string, string>
    {
        { "age", "24, 25, 26"}
    }
};

类别排除

您可以使用 AdManagerAdRequest CategoryExclusion 字段向请求中添加广告位一级的类别排除级别：

AdManagerAdRequest newRequest = new AdManagerAdRequest
{
    CategoryExclusions = new HashSet<string>
    {
        "automobile",
        "boat"
    }
};

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

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

以下示例设置了 PPID：

AdManagerAdRequest newRequest = new AdManagerAdRequest
{
    PublisherProvidedId = "AB123456789"
};

发布商提供的信号

您可以在广告请求中以发布商提供的信号 (PPS) 的形式发送受众群体和情境数据。借助 PPS，您可以使用用户数据，通过使用标准类目向所有交易类型的出价方传达受众群体特征，从而提升程序化变现效果，而无需分享用户标识符。受众群体特征可能包括行为数据和兴趣数据（IAB 受众群体类目 1.1）以及情境数据（IAB 内容类目 2.2）。

以下示例设置了受众群体细分：

AdManagerAdRequest newRequest = new AdManagerAdRequest
{
    Extras = new Dictionary<string, string>
    {
        // Set the demographic to an audience with an "Age Range" of 30-34
        // and an interest in mergers and acquisitions.
        { "IAB_AUDIENCE_1_1", "1, 2, 3, 4, 5"},
        // Set the content to sedan, station wagon and SUV automotive values.
        { "IAB_AUDIENCE_2_2", "6, 7, 8, 9, 10"},
    }
};