出站数据文件名:语法和示例 outbound-data-file-name-syntax-and-examples

介绍用于命名出站数据文件的必填字段、语法和约定。

NOTE
样式元素(monospaced text斜体、括号[ ] ( )等) 本文档中说明了代码元素和选项。 请参阅代码和文本元素的样式约定,以了解更多信息。

语法和文件名元素 syntax-file-name

出站文件名包含以下元素。 以下所有元素都是可选的。

[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 (原始,未哈希)
  • 供应商ID — 第三方用户ID (Web/Cookie)

有关更多详细信息,请参阅全局数据源

PID_ALIAS
来自第三方平台的客户标识符。
SYNC_MODE

同步模式是一个宏占位符,它根据同步类型向文件名添加标签。 同步类型包括完整同步和增量同步。 它们将在文件名中显示为 iter full

  • iter :表示“迭代”同步或增量同步。 增量文件仅包含自上次同步以来收集的新数据。
  • full :表示“完全”同步。 完全同步的文件包含自上次同步以来收集的旧数据和任何新数据。
TIMESTAMP
以UTC时区表示的13位数UNIX时间戳(以毫秒为单位)。
SPLITNUM

整数。 标识被拆分为多个部分的文件部分,以缩短处理时间。 数字表示数据属于原始文件的哪个部分。

如果拆分大小小于100份,则整数必须至少包含3位数字,前面加零。

原始文件将不具有任何拆分编号。 第一个拆分文件将以001结尾。 请参阅下面的示例。

.gz (optional)
GZIP压缩。

文件名示例 file-name-examples

场景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位置,在文件内容(Vendor ID=45454)中具有​ PID_ALIAS="XYZCustomer" ​和第三方用户ID:

例如,增量文件:

  • 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

出站数据文件内容:语法和参数 outbound-contents-syntax

介绍用于在出站数据文件中组织信息的必填字段、语法和约定。 根据这些规范格式化数据。

NOTE
样式元素(monospaced text斜体、括号[ ] ( )等) 本文档中说明了代码元素和选项。 请参阅代码和文本元素的样式约定,以了解更多信息。

语法

数据文件中的字段按以下顺序显示:

UUID<SPACE>SEGMENT_1,SEGMENT_2<SPACE>REMOVED_SEGMENT_,...

参数

该表列出了定义数据文件内容的变量。

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

示例:基本文件格式

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

59767559181262060060278870901087098252  24,26,27  25,28
recommendation-more-help
de293fbf-b489-49b0-8daa-51ed303af695