ID同步文件的名称和内容要求

最近更新： 2025年5月5日
  • 主题：

介绍用于基于文件的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一个静态前缀，用于将文件标识为People-Based Destinations的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压缩来压缩文件。