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

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

注意

样式元素（monospaced text、斜体、括号[ ] ( )等） 在此文档中指示代码元素和选项。 请参阅代码和文本元素的样式约定，以了解更多信息。

语法和文件名元素

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

[SYNC_TYPE][_DID][_MASTER_DPID][_PID_ALIAS][_SYNC-MODE][_TIMESTAMP]SPLITNUM.sync[.gz]

参数

表定义出站数据文件名中的元素。

文件名元素 描述

SYNC_TYPE

指数据传输方法。 传输方法包括：

  • FTP —— 使用SFTP传输
  • AmazonS3 -转让到 AmazonAWS

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

13位数的UNIX时间戳（以毫秒为单位，以UTC时区为单位）。

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( 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的条件。 根据需要，空格将UUID和段ID分隔开。 另一个空格分隔段ID集。 在此示例中，用户属于区段24、26和27。 它们已从第25和28个细分中删除。

59767559181262060060278870901087098252  24,26,27  25,28

在此页面上