This article has been updated in alignment with upcoming changes to Audience Solutions.
To adhere to the EU user consent policy and continue creating audience segments globally, publishers using batch upload must make updates to pass the required consent signals to Ad Manager by March 2024.
如需激活受众群体解决方案，您必须与发布商支持团队或销售团队联系。他们需要激活提供的列表，因此发布商需要过一段时间才能开始看见其细分受众群。
您可以创建一个包含标识符的文件，然后通过 Google Cloud 将其上传到 Google Ad Manager 中。可上传的标识符或 ID 包括 Cookie、移动广告 ID（AdID 或 IDFA）或 PPID。如果您需要一次性添加多个 ID，通过 Google Cloud 上传 ID 可以节省时间。
Cookie、PPID 和设备广告 ID 必须已包含在 Ad Manager 广告请求中，您才能将其添加到细分受众群中。您可以从数据传输报表（仅限 Google Ad Manager 360）中下载经过加密的标识符的列表，也可以从其他系统获取原始标识符（例如，移动应用日志中的原始设备广告 ID）。
批量上传的 PPID 的有效期上限为最后一次用户活动（或 PPID 在广告投放中最后一次显示）后的 180 天。对于设备 ID，有效期上限为其创建后的 540 天；换句话说，就是设备在广告投放中第一次显示后的 540 天。
请注意，同时使用基于事件 ping 的填充方式（例如，注册事件、预先填充）和基于 Cookie 上传的填充方式（即，提供的 CSV 列表）可能会产生冲突，因为被移除的 PPID 可能不会显示为已完全排除。
本文将介绍以下主题：
前提条件
在上传标识符之前，请先与您的客户经理一起完成以下工作：
- 找到并提交您的广告联盟代码。在 Ad Manager 中，依次点按管理、全局设置，在广告资源网代码下找到您的广告资源网代码。
- 确保您已创建一个有效的第一方细分受众群（您要将相应标识符与该细分受众群关联）。如果您不希望该细分受众群使用您自己的广告资源收集用户，请选择“由发布商管理”作为填充方法。
从创建细分受众群到您可以执行批量上传操作，最多需要等待 24 小时。 - 创建一个 Google 群组，其中包含所有有权上传和查看文件的 Google 账号。
在客户经理帮助您完成这些设置后，您便可以创建要上传的标识符文件了。
.fail 文件中看到以下消息：“Could not find the
<type of identifier> in our server, retry is not helpful”。创建上传文件
必需的意见征求代码
所有发布商都必须进行更新，才能将必需的意见征求信号传递给 Ad Manager。
若要确认已征求用户意见，请在任何上传文件的标头中添加 process_consent 标记。为了符合 CSV 标准，各行应包含此标头列的值，但不会影响处理；我们建议使用空字符串。任何缺少此词组的文件都会被视为未通过适当的方式征得用户同意，将无法由 Google 处理。
必须进行此更新：
- 对于所有用户，无论他们身在何处，这都是一项技术要求。
- 对于欧盟/欧洲经济区用户，这是为了遵守欧盟地区用户意见征求政策，并继续为欧洲经济区 (EEA) 的用户创建细分受众群。
关于标识符
批量上传流程支持多种不同类型的标识符。请务必使用正确的上传文件格式将各种类型的标识符上传到相应的细分受众群中。这些标识符分为以下两类：
- 经过加密的标识符：从 Google 系统获取的标识符
- 原始标识符：从外部系统或来源获取的标识符
经过加密的标识符是使用 cookie_encrypted 文件格式进行上传，而原始标识符是使用各类型专用的上传文件格式进行上传。
经过加密的标识符和 PPID 只能用于特定的广告联盟。因此，您无法通过批量上传将从一个广告联盟获取的 PPID 或经过加密的标识符上传到另一个广告联盟中。也就是说，通过广告联盟 A 的数据传输报表获取的用户标识符无法批量上传到广告联盟 B 中。相比之下，设备标识符不是广告联盟专用的。
下表总结了可用的标识符及其上传方法：
| 标识符 | 说明 | 来源 | 上传为 |
|---|---|---|---|
| Cookie | Cookie 标识符 | 数据传输UserId |
cookie_encrypted |
| 原始（外部来源） | 无（Cookie 必须经过加密才能上传） | ||
| PPID | 发布商提供的标识符 | 数据传输PublisherProvidedID |
cookie_encrypted |
| 原始（外部来源） | ppid |
||
| IDFA | 广告标识符 | 数据传输UserId |
cookie_encrypted |
| 原始（外部来源） | cookie_idfa |
||
| AdID | Android TV 标识符 | 数据传输UserId |
cookie_encrypted |
| 原始（外部来源） | cookie_adid |
||
| Roku ID | Roku 标识符 | 数据传输UserId |
cookie_encrypted |
| 原始（外部来源） | cookie_rida |
||
| tvOS ID | Apple TV 标识符 | 数据传输UserId |
cookie_encrypted |
| 原始（外部来源） | cookie_tvos |
||
| Vizio IFA | Vizio 标识符 | 数据传输UserId |
cookie_encrypted |
| 原始（外部来源） | cookie_vida |
||
| 三星 TIFA | 三星标识符 | 数据传输UserId |
cookie_encrypted |
| 原始（外部来源） | cookie_tifa |
使用文本编辑器创建一个纯文本文件，然后以任意文件名保存此文件。您可以使用任意文件扩展名保存该文件，也可以不使用文件扩展名。
Google Cloud 文件名会公开显示。请勿在文件名中添加任何机密信息。
文件内容要求
- 务必用英文逗号分隔文件内容。
- 第一行必须如下所示：
- 对于通过数据传输报告（仅限 Google Ad Manager 360）中获取的经过加密的 Cookie 和经过加密的标识符：
cookie_encrypted,list_id,process_consent - 对于原始 Apple IDFA：
cookie_idfa,list_id,process_consent - 对于原始 Android AdID：
cookie_adid,list_id,process_consent - 对于原始 PPID：
ppid,list_id,process_consent - 对于原始 Roku ID：
cookie_rida,list_id,process_consent - 对于原始 tvOS ID：
cookie_tvos,list_id,process_consent
- 对于通过数据传输报告（仅限 Google Ad Manager 360）中获取的经过加密的 Cookie 和经过加密的标识符：
- 接下来的每行都应该包含一个标识符、一个英文逗号以及应与此标识符关联的细分受众群的 ID。
- 每行都应该以 Unix 行尾类型的换行符 (
LF) 结尾，而不是回车符 (CR)。行尾类型可能是在文本编辑器或生成相应文件的程序中设置，具体视您生成上传文件时使用的方法而定。 - 发布商可以通过数据传输报表（仅限 Google Ad Manager 360）获取经过加密的标识符。如需获取细分受众群 ID，您可以先登录您的 Google Ad Manager 账号，然后依次选择广告资源和细分受众群。
- “process_consent”列应为上传文件中的最后一列。
- “process_consent”中的单元格可以留空。不过，请务必添加标头值设为“process_consent”的列。
- 批量上传文件的大小不得超过 1GB。系统可能无法正确处理大于 1GB 的文件。
经过加密的 Cookie ID 的文件内容示例：
cookie_encrypted,list_id,process_consent
ScpJKu-yV8je93qkd32MOA,3153490,
w2gsrUcwxF-OiJTRmQswQA,3153490,
原始 AdID 的文件内容示例：
cookie_encrypted,list_id,process_consent
ScpJKu-yV8je93qkd32MOA,3153490,
w2gsrUcwxF-OiJTRmQswQA,3153490,
批量删除标识符
您可以使用同一个上传文件批量删除标识符，只需添加“delete”列即可。对于您想从相应的细分受众群中删除的每个标识符，请在“delete”列中输入 1；对于您想在相应的细分受众群中保留的每个 ID，请在“delete”列中输入 0。
1 或 0。否则上传会失败。在下面的示例中，第一个 Cookie 会保留在 ID 为 3153490 的细分受众群中，而第二个 Cookie 会与此细分受众群解除关联。
cookie_encrypted,list_id,delete,process_consent
ScpJKu-yV8je93qkd32MOA,3153490,0,
w2gsrUcwxF-OiJTRmQswQA,3153490,1,
在以下示例中，第一个广告标识符 (IDFA) 会与细分受众群解除关联，但第二个 IDFA 会保留在该细分受众群中。
cookie_idfa,list_id,delete,process_consent
ScpJKu-yV8je93qkd32MOA,3153490,1,
w2gsrUcwxF-OiJTRmQswQA,3153490,0,
每行内包含的以英文逗号分隔的字段必须与标题中一样多。请注意，标识符中绝不会包含英文逗号或与 CSV 格式不一致的其他字符。
请注意，无论您是要添加还是删除标识符，Ad Manager 都需要花费几个小时的时间才能处理完标识符的上传。您必须先等待系统处理完您添加的标识符，然后才能再使用上传文件将其删除。
上传文件
创建好文件后，您需要将其上传到 Google 存储桶中（允许使用子文件夹）。您可通过 3 种方法访问 Ad Manager 云存储桶。下文按照从易到难的顺序列出了这些方法：
- 通过网页：访问
https://console.developers.google.com/storage/browser/gdfp_cookieupload_[Ad Manager 广告资源网代码]/ - gsutil 是一种基于 Python 的命令行工具，可提供与 Unix 类似的命令，以便与相应的存储桶交互。存储桶身份验证的抽象化和处理都是自动进行的。
- Google Cloud Storage API 是一种用于操控存储桶的全功能 API，可通过 JSON 或 XML RESTful 网络界面使用。API 客户端库可用于许多常用的编程环境，包括 Java、JavaScript、Python 和 Objective-C。如果您需要以编程方式操控存储桶，从而与 Google App Engine 应用或 Java Web 应用进行集成，则这种方法最有效。
在 24 小时内，您的 Google 存储空间账号中将会生成一个日志文件，其名称为您的文件名加上一个后缀，该后缀用于表明文件中的所有标识符是否均已成功处理。
例如，如果文件名为 1234_20130115_1，那么生成的文件会命名为 1234_20130115_1.success 或 1234_20130115_1.fail。此类文件中不仅会列出已成功处理的标识符的数量，还会针对无法处理的标识符提供详细的错误消息。您可以下载此日志文件，以获取详细的状态信息。
结果文件名将显示在您的 Google 存储空间账号的以下文件夹中：
https://console.developers.google.com/storage/gdfp_cookieupload_result_[Ad Manager 广告联盟代码]/
上传完成后，系统在定位广告资源时，便会将您文件中已成功处理的标识符视为关联细分受众群的成员。
.fail 或 .success 文件仅表明该文件是否已成功解析，并不提供与名单规模净增加/减少有关的有意义信息。仅当每个标识符均已成功上传时，系统才会为对应文件名添加 .success 后缀。不过，在大多数情况下，都至少会有一项失败，因此输出文件的名称会带有 .fail 后缀。
批量上传的标识符的有效期
通过“批量上传”操作上传的标识符需遵守通过 Ad Manager 界面对细分受众群配置的过期设置。
如果您为细分受众群配置的有效期值为 X 天，但标识符在上传后的 X 天内都没有满足细分受众群的成员资格条件，则此标识符会在 X 天后过期，并无法用于该细分受众群。每次上传操作都会重置已上传的标识符的细分受众群成员资格和过期倒计时。
有关批量上传的最佳做法
文件结构
最大限度地减少用于上传的文件数量。请注意，文件中的每行都指定了列表 ID，因此可使用一个文件将标识符上传到多个列表中。
上传处理量
在上传文件时，必须遵守以下限制：
- 每 24 小时最多上传 500 个文件
- 每个批量上传文件的大小不得超过 1GB
- 每 24 小时上传的批量上传文件总大小不得超过 5GB
递增/完整上传
- 为了避免不必要的处理，我们建议一般采用递增（增量）上传的做法来上传标识符。也就是说，您只需添加或删除自上一次上传以来在细分受众群中的成员资格发生变化的标识符即可，而无需上传完整的细分受众群标识符列表。
- 您可以时不时（不必过于频繁，每周不超过一次即可，但仍需遵循上述上传处理量限制）完整上传所有细分受众群标识符数据。执行完整上传操作之后，之前退出细分受众群的任何成员的细分受众群成员资格都会相应地进行更新。
- 您应该通过其他系统来跟踪标识符的“新鲜度”，还应采用某种方法从更新后的上传文件中排除已失效的标识符（这些标识符应该不会在投放中再次派上用场）。
处理时间
从批量上传到所有批量更改都在投放中体现出来最多需要等待 24 小时。换言之，如果您需要在广告投放中使用某些细分受众群，应至少提前 24 小时上传文件。
此外，完成批量上传后，可能最多需要过 48 小时，相应更改才会显示在 Ad Manager 界面中。
