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。

重要

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

同步将DPUUID与UUID匹配

ID同步文件的用途是将您自己数据源中的DPUUID与Audience Manager UUID同步。 同步将DPUUIDs从主控DPID及其相关的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-TTrj6E4njaMR38
67412682083411995725538770443620307584 XYZ3017BBR4DAFJWfM6D4Gb4lN_T5jk_f7rdEcqNs9wfnA7h70
89159024796760343733111707646026765593 XYZ3017PryPID8tzfhkEE-gE034LI-53Jde0utCYcIwd0A2OlM
66552757407517449462805881945288602094 XYZ3017QvBddD-bLJS28DPxiqUfmIBxE3_55bvQJMLwregJU2M
66184778222667870903738139438735041506 XYZ3017q9r60kuHPOca_Ek-btCN2iu1HyVaUe0rd412TzbyCMw

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

文件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 ManagerUUIDs同步。


其他格式要求

用户ID不能:

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

任何以制表符或空格结尾的行将不被处理或实现。 作为规则,请确保清除行末尾。

在此页面上