Targeting

请选择平台： Android iOS Unity Flutter Android（旧版）

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

准备工作

在继续操作之前，请设置 Google Mobile Ads Unity Plugin。

请求配置

RequestConfiguration 对象会收集每个广告请求的全局配置，该对象会由 MobileAds.SetRequestConfiguration() 应用。

MobileAds.SetRequestConfiguration(requestConfiguration);
RequestConfigurationSnippets.cs

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

设置年龄处理方式

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

您可以通过 RequestConfiguration 对象中的 AgeRestrictedTreatment 属性设置年龄处理方式。

以下示例展示了如何指明广告请求应按针对儿童的年龄处理方式进行处理：

RequestConfiguration requestConfiguration = new RequestConfiguration
{
    // Indicate that ad requests should have child age treatment.
    AgeRestrictedTreatment = AgeRestrictedTreatment.Child
};
MobileAds.SetRequestConfiguration(requestConfiguration);
RequestConfigurationSnippets.cs

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

• AgeRestrictedTreatment.Teen
• AgeRestrictedTreatment.Unspecified

使用此设置时，Google Mobile Ads Unity Plugin 会在广告请求中包含 tfat 参数。请咨询您的法律顾问，依据自身的法律及监管义务，为用户确定适用的年龄分级保护方式。如需了解详情，请参阅为广告请求添加年龄分级保护标记。

从 TFCD 和 TFUA 迁移到年龄处理方式

年龄分级保护设置取代了已弃用的 TagForChildDirectedTreatment (TFCD) 和 TagForUnderAgeOfConsent (TFUA) 属性。

下表列出了 TFCD 和 TFUA 相关设置及对等的年龄分级保护方式：

TFCD

TFCD	年龄处理方式
TagForChildDirectedTreatment.True	AgeRestrictedTreatment.Child
TagForChildDirectedTreatment.False	AgeRestrictedTreatment.Unspecified
TagForChildDirectedTreatment.Unspecified	AgeRestrictedTreatment.Unspecified
未指定价值	AgeRestrictedTreatment.Unspecified
（无对等处理方式）	AgeRestrictedTreatment.Teen

TFUA

TFUA	年龄处理方式
TagForUnderAgeOfConsent.True	AgeRestrictedTreatment.Child
TagForUnderAgeOfConsent.False	AgeRestrictedTreatment.Unspecified
TagForUnderAgeOfConsent.Unspecified	AgeRestrictedTreatment.Unspecified
未指定价值	AgeRestrictedTreatment.Unspecified
（无对等处理方式）	AgeRestrictedTreatment.Teen

了解年龄处理方式与 TFCD 和 TFUA 的相互作用

如果您同时设置了年龄分级保护方式和 TFCD/TFUA，Google 会采用最保守的处理方式。

注意：对于“亲子同乐”计划中“主要面向儿童”的应用，以及登录了由 Family Link 管理的 Google 账号的用户，系统会自动针对所有广告请求，将所有内容视为面向儿童的内容。

通过中介转发年龄处理信号

如果您使用 Google Mobile Ads Unity Plugin设置年龄处理方式，中介适配器会将年龄处理信号转发到集成的第三方广告来源。

下表列出了支持将受年龄限制的处理信号转发到集成的第三方广告来源的中介适配器版本：

中介适配器名称	支持的最低版本
AppLovin	8.7.4
BidMachine	1.4.2
Bigo	1.1.0
Chartboost	4.13.0
DTExchange (Fyber)	3.5.10
i-mobile	1.3.13
InMobi	5.3.0
IronSource	4.5.3
Liftoff Monetize (Vungle)	5.7.5
LY (Line)	2.1.1
maio	3.1.9
Meta (Facebook)	3.18.7
Mintegral	2.2.3
Moloco	3.8.0
MyTarget	3.39.0
Pangle	7.0.0
PubMatic	2.1.3

面向儿童的设置

警告：TagForChildDirectedTreatment 属性已弃用。请改为设置 AgeRestrictedTreatment 属性。

为了遵守《儿童在线隐私保护法》(COPPA) 的规定，我们提供了一项名为“面向儿童的内容”标记的设置。

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

作为应用开发者，您可以在发出广告请求时表明是否希望 Google 将您的内容视为面向儿童的内容。如果您表明希望 Google 将您的内容视为面向儿童的内容，Google Mobile Ads Unity Plugin会采取相应措施，在该广告请求上停用针对用户兴趣投放广告和再营销广告。对于所有版本的 Google Play 服务 SDK，请通过 RequestConfiguration.TagForChildDirectedTreatment 使用此设置：

• 将 TagForChildDirectedTreatment 设置为 TagForChildDirectedTreatment.True，即表明您希望 Google 根据《儿童在线隐私保护法》(COPPA) 的规定将您的内容视为面向儿童的内容。此设置会阻止传输 Android 广告标识符 (AAID)。

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

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

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

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

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

注意：对于“亲子同乐”计划中“主要面向儿童”的应用，以及登录了由 Family Link 管理的 Google 账号的用户，系统会自动针对所有广告请求，将所有内容视为面向儿童的内容。

未达到同意年龄的用户

警告：TagForUnderAgeOfConsent 属性已弃用。请改为设置 AgeRestrictedTreatment 属性。

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

详细了解 GDPR 给发布商带来的影响。

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

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

• 将 TagForUnderAgeOfConsent 设置为 TagForUnderAgeOfConsent.True，即表明您希望按适合未达到同意年龄的欧洲经济区 (EEA) 用户的方式处理该广告请求。此设置会阻止传输 Android 广告标识符 (AAID)。

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

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

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

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

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

广告内容过滤

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

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

通过使用 MaxAdContentRating 字段，应用可为其广告请求设置广告内容分级上限。如果配置了此设置，所返回的 AdMob 广告的内容分级将不会超过您在请求中设置的上限。

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

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

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

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

详细了解如何为每个广告请求设置内容分级上限。

注意：通过 Google Mobile Ads Unity Plugin指定的内容分级过滤条件设置会替换所有使用 Ad Manager 界面配置的设置。

广告请求

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

自定义定位

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

以下示例演示了如何将自定义定位参数“age”的值设为 25：

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

以下示例定位的是年龄介于 24 至 26 岁之间的人员：

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

类别排除

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

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

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

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

注意：此功能仅适用于部分发布商。如需了解详情，请参阅发布商提供的标识符简介。

以下示例会设置 PPID：

AdManagerAdRequest newRequest = new AdManagerAdRequest
{
    PublisherProvidedId = "AB123456789"
};
AdRequestSnippets.cs

发布商提供的信号

您可以在广告请求中，将受众群体和情境数据作为发布商提供的信号 (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" }
    }
};
AdRequestSnippets.cs