Adobe Experience League

ID 同步文件的名称和内容要求

介绍用于基于文件的ID同步的必填字段、语法和命名约定。根据这些规范命名和组织您的文件内容。

注意

文本样式（monospaced text、斜体、括号 [ ] ( ) 等）在此文档中，指示代码元素和选项。请参阅代码和文本元素的样式约定，以了解更多信息。

文件名语法和示例

ID文件名包含以下必需和可选元素：

[adobe_id_] [c2c_id_]MASTERDPID_DPID[_DPID]_TIMESTAMP.sync[.SPLIT_NUMBER][.gz]

参数	描述
`adobe_id`	将文件标识为ID同步文件的静态前缀。将设备ID与其他设备ID或客户ID(DPUUID)匹配时，请使用此前缀。
`c2c_id`	一个静态前缀，将文件标识为基于人的目标的ID同步文件。将客户ID(DPUUID)与基于人员的目标的散列电子邮件地址匹配时，请使用此前缀。
`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`	10位的UNIX时间戳（秒）。时间戳有助于使每个文件名都是唯一的。
`.sync`	表示正常的完全同步。
`[.SPLIT_NUMBER]`	整数。将大文件拆分为多个小文件时使用。这有助于缩短处理时间。数字指示要发送的原始文件的哪个部分。请参阅下面的文件名示例。
`[.gz]`	指定使用可选的gzip压缩来压缩文件。

文件名示例

以下示例显示格式正确的文件名。您的文件名可能看起来类似。

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

注意

有关基于人员的目标的ID同步文件命名（c2c前缀），请参阅工作流A — 基于所有联机活动与脱机数据组合的个性化或工作流B — 基于脱机数据的个性化。

文件内容语法和示例

ID文件的内容包括以下元素：

UUID <tab>UUID<tab>UUID<tab>UUID

文件包含用户ID(UUID)。在每行中，用选项卡分隔ID。以下示例显示格式正确的ID文件。您的内容可能看起来类似。

abc123 def456 ghi789 xyz987

文件内容注意事项

创建入站文件时，请确保第一列仅填充设备ID，如AAM UUID、GAID、IDFA等。有关Audience Manager支持的ID的详细说明，请参阅Audience Manager中ID的索引。

重要

请勿在第一列上使用DPUUID。这样做可能会导致同步不正确。

同步将DPUUID与UUID匹配

ID同步文件的用途是将您自己的数据源中的 DPUUID与Audience Manager UUID同步。同步将主控DPID的DPUUID和其相关的DPIDs映射到Audience Manager UUIDs。将ID放在文件名和正文中的位置决定了这些标识符如何相互映射。例如，取下此处显示的两个示例文件：

文件1: adobe_id_0_12345_1476312152.sync
文件2: adobe_id_12345_67890_1476312876.sync

给定示例名称和内容后，ID会以如下方式一起映射：

文件1 ( 下载示例文件)

DPID 0 = Adobe Audience Manager UUID	DPID 12345
68079982765673198504052656074456196039	XYZ3017D_2kzkTOXkFYIAgwbajoqWRcqkXl-TTrj6E4njaMR.38
67412682083411995725538770443620307584	XYZ3017BBR4DAFJWfM6D4Gb4lN_T5jk_f7rdEcqNs9wfnA7h70
89159024796760343733111707646026765593	XYZ3017PryPID8tzfhkEE-gE034LI-53Jde0utCYcIwd0A2OlM
66552757407517449462805881945288602094	XYZ3017QvBddD-bLJS28DPxiqUfmIBxE3_55bvQJMLwregJU2M
66184778222667870903738139438735041506	XYZ3017q9r60kuHPOca_Ek-btCN2iu1HyVaUe0rd412TzbyCMw

第1步：ID同步过程将从DPID 12345与左列中的Audience Manager UUIDs同步DPUUIDs。请注意，文件名中的DPID "0"表示Audience Manager UUIDs。

文件2 ( 下载示例文件)

DPID 12345	DPID 67890
XYZ3017D_2kzkTOXkFYIAgwbajoqWRcqkXl-TTrj6E4njaMR.38	4598060374
XYZ3017BBR4DAFJWfM6D4Gb4lN_T5jk_f7rdEcqNs9wfnA7h70	4581274262
XYZ3017PryPID8tzfhkEE-gE034LI-53Jde0utCYcIwd0A2OlM	4392434426
XYZ3017QvBddD-bLJS28DPxiqUfmIBxE3_55bvQJMLwregJU2M	2351382994
XYZ3017q9r60kuHPOca_Ek-btCN2iu1HyVaUe0rd412TzbyCMw	4601584763