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_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

同步将DPUUID与UUID匹配

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

  • 文件1: adobe_id_0_12345_1476312152.sync

  • 文件2: adobe_id_12345_67890_1476312876.sync


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

文件1 ( 下载示例文件)

DPID 0 =Adobe Audience ManagerUUID DPID 12345
68079982765673198504052656074456196039 XYZ3017D_2kzkTOXkFYIAgwbajoqWRcqkXl-TTrj6E4njaMR38
6741268208341199572553870443620307584 XYZ3017BBR4DAFJWfM6D4Gb4lN_T5jk_f7rdEcqNs9wfnA7h70
8915902479676034373311170764602676593 XYZ3017PryPID8tzfhkEE-gE034LI-53Jde0utCYcIwd0A2OlM
66552757407517449462805881945288602094 XYZ3017QvBddD-bLJS28DPxiqUfmIBxE3_55bvQJMLwregJU2M
6618477822667870903738139438735041506 XYZ3017q9r60kuHPOca_Ek-btCN2iu1HyVaUe0rd412TzbyCMw

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

文件2 ( 下载示例文件)

DPID 12345 DPID 小行星67890
XYZ3017D_2kzkTOXkFYIAgwbajoqWRcqkXl-TTrj6E4njaMR38 4598060374
XYZ3017BBR4DAFJWfM6D4Gb4lN_T5jk_f7rdEcqNs9wfnA7h70 4581274262
XYZ3017PryPID8tzfhkEE-gE034LI-53Jde0utCYcIwd0A2OlM 4392434426
XYZ3017QvBddD-bLJS28DPxiqUfmIBxE3_55bvQJMLwregJU2M 2351382994
XYZ3017q9r60kuHPOca_Ek-btCN2iu1HyVaUe0rd412TzbyCMw 4601584763

第2步:来自DPID 12345的DPUUIDs在步骤1中与Audience ManagerUUIDs同步。此ID同步的功能是将DPID 67890中的DPUUID与步骤1中的Audience ManagerUUID同步。


其他格式要求

用户ID不能:

  • 在ID本身中包含选项卡。 选项卡仅用于在数据文件中分隔单个ID。
  • 包含个人可识别信息(PII)。
  • 使用URL编码。 仅传递未编码的ID。

任何以制表符或空格结尾的行都不会得到处理或实现。 通常,确保行末保持清晰。

在此页面上