Show Menu
主题×

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。 这些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_145442149.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

同步将DPUUID与UUID匹配

ID同步文件的目的是将您自己数据源 的DPUUID 与UUID同 Audience Manager 步。 同步将主 DPUUID站点及其相 DPID 关站点的 DPIDs映射到 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-Trj6E4njaMR38
67412682083411995725538770443620307584
XYZ3017BBR4DAFJWfM6D4Gb4lN_T5jk_f7rdEcqNs9wfnA7h70
89159024796760343733111707646026765593
XYZ3017PryPID8tzfhkEE-gE034LI-53Jde0utCYcIwd0A2OlM
66552757407517449462805881945288602094
XYZ3017QvBddD-bLJS28DPxiqUfmIBxE3_55bvQJMLwregJU2M
66184778222667870903738139438735041506
XYZ3017q9r60kuHPOca_Ek-btCN2iu1HyVaUe0rd412TzbyCMw
第1步:id sync进程将从12345 DPUUID开始 DPID 与左 Audience Manager 列中的 UUIDs同步。 请注意, DPID 文件名中的“0”表示 UUIDs。
文件2 (下 载示例文件 )
DPID 12345
DPID 67890
XYZ3017D_2kzkTOXkFYIAgwbajoqWRcqkXl-Trj6E4njaMR38
4598060374
XYZ3017BBR4DAFJWfM6D4Gb4lN_T5jk_f7rdEcqNs9wfnA7h70
4581274262
XYZ3017PryPID8tzfhkEE-gE034LI-53Jde0utCYcIwd0A2OlM
4392434426
XYZ3017QvBddD-bLJS28DPxiqUfmIBxE3_55bvQJMLwregJU2M
2351382994
XYZ3017q9r60kuHPOca_Ek-btCN2iu1HyVaUe0rd412TzbyCMw
4601584763
第2步:来 DPUUID自12345 DPID 的URL已在步骤1中与Audience manager同 UUID步。此ID同步的作用是将 DPUUID67890的 DPID s与步骤1中的Audience Manager UUID同步。

其他格式要求

用户ID不能:
  • 在ID本身中包含选项卡。 选项卡仅用于在数据文件中分隔单个ID。
  • 包含个人识别信息(PII)。
  • 使用 URL 编码。 仅传递未编码的ID。
任何以制表符或空格结尾的行都不会被处理或实现。 通常,请确保行末尾保持清晰。