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

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


其他格式要求

用户ID不能:

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

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

On this page

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now