介绍用于基于文件的ID同步的必填字段、语法和命名约定。 根据这些规范命名并组织文件内容。
文本样式(monospaced text
、斜体、括号 [ ]
( )
等)本文档中指示了代码元素和选项。 请参阅代码和文本元素的样式约定,以了解更多信息。
ID文件名包含以下必需和可选元素:
[adobe_id_]
[c2c_id_]
MASTERDPID_DPID
[_DPID]
_TIMESTAMP.sync
[.SPLIT_NUMBER]
[.gz]
参数 | 描述 |
---|---|
|
用于将文件标识为ID同步文件的静态前缀。 将设备ID与其他设备ID或客户ID(DPUUID)匹配时,请使用此前缀。 |
|
一个静态前缀,用于将文件标识为基于人员的目标的ID同步文件。 将客户ID(DPUUID)与基于人员的目标的经过哈希处理的电子邮件地址进行匹配时,请使用此前缀。 |
MASTERDPID |
主控数据提供程序ID是文件名中DPID的父ID。 此外,数据文件中的第一个用户ID对应于主控ID。 后续DPID是属于主控的其他标识符。 同步会将文件名中的DPID映射到文件中的UUID。 此DPID必须只包含设备ID,例如AAM UUID、GAID、IDFA等。 它不能包含DPUUID。 这样做可能会导致同步不正确。 |
|
数据提供程序ID。 这些ID表示与主控DPID关联的实体或数据源。 同步会将文件名中的DPID映射到文件中的UUID。 文件名中的DPID数量必须与数据文件中的UUID数量匹配。 例如,假设您的文件名包含主控DPID和3个DPID。 您的数据文件必须包含4个相应的UUID列,格式如下文件内容部分中所述。 |
timestamp |
以秒为单位的10位UNIX时间戳。 时间戳有助于使每个文件名都是唯一的。 |
|
表示正常的完全同步。 |
|
整数。 将大文件拆分为多个小文件时使用。 这有助于缩短处理时间。 数字表示您发送的原始文件的哪个部分。 请参阅下面的文件名示例。 |
|
指定使用可选的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。 这样做可能会导致同步不正确。
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不能:
任何以制表符或空格结尾的行将不被处理或实现。 作为规则,请确保清除行末尾。