Show Menu
主题×

出站数据文件名:语法和示例

描述用于命名出站数据文件的必填字段、语法和约定。
样式元素( monospaced text 、括 [ ]``( ) 号等)在本文档中指示代码元素和选项。 请参阅 代码和文本元素的样式约定 ,以了解更多信息。

语法和文件名元素

出站文件名包含以下元素。 以下所有元素都是可选的。
[SYNC_TYPE][_DID][_MASTER_DPID][_PID_ALIAS][_SYNC-MODE][_TIMESTAMP]SPLITNUM.sync[.gz]

参数

该表定义了出站数据文件名中的元素。
文件名元素 描述
SYNC_TYPE
指数据传输方法。 传输方法包括:
  • FTP —— 使用SFTP传输
  • Amazon S3 -传输到 Amazon AWS
DID
目标ID。
Audience Manager中,目 标是集成的实例,您可以在其中映射目标区段。 根据业务需求,客户可以有多个目标。
MASTER_DPID
数据提供者或数据源ID。 此ID标识文件内容中存在的用户ID的类型。 最常见的用户ID密钥有:
  • 20914 - Google广告商ID( 原始,未哈希)
  • 20915 - Apple ID for Advertisers(原始 、未哈希)
  • 供应商ID —— 第三方用户ID(Web/cookie)
有关更 多详细信息 ,请参阅全局数据源。
PID_ALIAS
来自第三方平台的客户标识符。
SYNC_MODE
同步模式是一个宏占位符,用于根据同步类型向文件名添加标签。 同步类型包括完全和增量。 它们将以或的形式出现在文件名 iter full
  • iter :表示“迭代”或增量同步。 增量文件仅包含自上次同步以来收集的新数据。
  • full :指示“完全”同步。 完全同步的文件包含旧数据和自上次同步以来收集的任何新数据。
TIMESTAMP
UTC时区中的13位UNIX时间戳(以毫秒为单位)。
SPLITNUM
整数。 识别被分割为多个部分的文件的一部分,以缩短处理时间。 数字指示数据所属的原始文件的哪一部分。
如果拆分大小小于100个部分,则该整数必须至少长3位,前面加零。
原始文件没有任何拆分号。 第一个拆分文件将以001结束。 请参阅以下示例。
.gz (optional)
GZIP压缩。

文件名示例

场景1

将文件发送到某个 Amazon S3 位置,包含文 PID_ALIAS="XYZCustomer" 件内 Google Advertiser IDs 容中的文件和内容。
例如,增量文件:
  • S3_1234_20914_XYZCustomer_iter_1486140844000.sync.gz
  • S3_1234_20914_XYZCustomer_iter_1486140844000001.sync.gz
  • S3_1234_20914_XYZCustomer_iter_1486140844000002.sync.gz
例如,完整文件:
  • S3_1234_20914_XYZCustomer_full_1486140844000.sync.gz
  • S3_1234_20914_XYZCustomer_full_1486140844000001.sync.gz

场景2

将文件发送到位 FTP 置,文件内 PID_ALIAS 容中 Apple Advertiser IDs 不包含和包含:
例如,增量文件:
  • ftp_1234_20915_iter_1486140843000.sync.gz
  • ftp_1234_20915_iter_1486140843000001.sync.gz
例如,完整文件:
  • ftp_1234_20915_full_1486140843000.sync.gz
  • ftp_1234_20915_full_1486140843000001.sync.gz
场景3 :将文件发送到位 FTP 置,文件内 PID_ALIAS="XYZCustomer" 容中包含第三方用户ID和第三方用户ID( Vendor ID=45454 ):
例如,增量文件:
  • ftp_1234_45454_XYZCustomer_iter_1486140843000.sync.gz
  • ftp_1234_45454_XYZCustomer_iter_1486140843000001.sync.gz
  • ftp_1234_45454_XYZCustomer_iter_1486140843000001.sync.gz
例如,完整文件:
  • ftp_1234_45454_XYZCustomer_full_1486140843200.sync.gz
  • ftp_1234_45454_XYZCustomer_full_1486140843200001.sync.gz

出站数据文件内容:语法和参数

描述用于组织出站数据文件中信息的必填字段、语法和约定。 根据这些规范设置数据格式。
样式元素( monospaced text 、括 [ ]``( ) 号等)在本文档中指示代码元素和选项。 请参阅 代码和文本元素的样式约定 ,以了解更多信息。

语法

数据文件中的字段按以下顺序显示:
UUID<SPACE>SEGMENT_1,SEGMENT_2<SPACE>REMOVED_SEGMENT_,...

参数

该表列出了定义数据文件内容的变量。
参数 描述
UUID
Audience Manager分配的唯一用户ID
<SPACE>
用空格分隔UUID和段数据
SEGMENT_N
访客所属的区段ID。 用逗号分隔多个区段。
REMOVED_SEGMENT_N
用户被取消资格的区段ID。 用逗号分隔多个区段。 通过完全同步,您可以忽略删除的区段,因为数据文件将包含用户当前区段的完整列表。 通常,您需要了解用户所属的区段,而不是已从中删除的区段。 另请参阅 出站数据文件名:语法和示例

示例:基本文件格式

格式正确的数据文件可能与以下示例类似。 此文件条目表示用户有资格使用区段24、26和27。 根据需要,空格将分隔ID UUID 和段ID。 另一个空格将区段ID集分开。 在此示例中,用户属于区段24、26和27。 它们已从第25和28个区段中删除。
59767559181262060060278870901087098252  24,26,27  25,28