ID同步文件的名称和内容要求 name-and-content-requirements-for-id-synchronization-files
介绍用于基于文件的ID同步的必填字段、语法和命名约定。 根据这些规范命名并组织文件内容。
文件名语法和示例 file-name-syntax
ID文件名包含以下必需元素和可选元素:
[adobe_id_]
[c2c_id_]
MASTERDPID_DPID
[_DPID]
_TIMESTAMP.sync
[.SPLIT_NUMBER]
[.gz]
adobe_id
c2c_id
MASTERDPID
主数据提供程序ID是文件名中DPID的父ID。 此外,数据文件中的第一个用户ID对应于主ID。 后续DPID是属于主数据库的其他标识符。 同步会将文件名中的DPID映射到文件中的UUID。
此DPID必须仅包含设备ID,如AAM UUID、GAID、IDFA等。 它不能包含DPUUID。 这样做可能会导致不正确的同步。
DPID
数据提供程序ID。 这些ID表示与主DPID关联的实体或数据源。 同步会将文件名中的DPID映射到文件中的UUID。
文件名中的DPID数量必须与数据文件中的UUID数量匹配。 例如,假设您的文件名包含一个主DPID和3个DPID。 您的数据文件必须包含4个对应的UUID列,其格式如下面的文件内容部分中所述。
timestamp
.sync
[.SPLIT_NUMBER]
[.gz]
文件名示例
以下示例显示格式正确的文件名。 您的文件名可能类似。
adobe_id_111_222_333_444_1454442149.sync
adobe_id_123_898_456_1454442149.sync.1.gz
adobe_id_123_898_456_1454442149.sync.2.gz
c2c_id_123_898_1454442149.sync.gz
文件内容语法和示例 file-content-syntax
ID文件的内容包括以下元素:
UUID
<tab>
UUID
<tab>
UUID
<tab>
UUID
该文件包含用户ID (UUID)。 在每行中,使用制表符分隔ID。 以下示例显示了格式正确的ID文件。 您的内容可能类似。
abc123 def456 ghi789 xyz987
文件内容注意事项 considerations
创建入站文件时,请确保第一列仅填充设备ID,如AAM UUID、GAID、IDFA等。 有关Audience Manager支持的ID的详细说明,请参阅Audience Manager🔗中的ID索引。
同步将DPUUID与UUID匹配 sync-matches-dpuuids-uuids
ID同步文件的用途是从您自己的数据源将DPUUID与Audience Manager个UUID同步。 同步将DPUUID从母版DPID及其相关DPID映射到Audience Manager UUID。在文件名和正文中放置ID的位置决定了这些标识符如何相互映射。 例如,下面显示了两个示例文件:
-
文件1:
adobe_id_0_12345_1476312152.sync
-
文件2:
adobe_id_12345_67890_1476312876.sync
给定示例名称和内容,ID将如下所示映射到一起:
文件1 (下载样本文件)
步骤1:ID同步过程将从DPID12345将DPUUID与左列中的Audience Manager UUID同步。 请注意,文件名中的DPID“0”表示Audience Manager UUID。
文件2 (下载样本文件)
步骤2: DPID中的DPUUID12345已在步骤1中与Audience ManagerUUID同步。此ID同步将执行步骤1中将DPID67890的DPUUID与步骤1中的Audience ManagerUUID同步。
其他格式要求 other-format-reqs
用户ID不能:
- 在ID本身中具有选项卡。 制表符仅用于分隔数据文件中的各个ID。
- 包含个人身份信息(PII)。
- 使用URL编码。 仅传入未编码的ID。
将不会处理或实现任何以制表符或空格结尾的行。 通常,请确保清除行的结尾。