傳出資料檔案名稱：語法與範例

描述用於命名出站資料檔案的必需欄位、語法和約定。

注意

樣式元素(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

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( 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

由分配的唯一用戶ID Audience Manager 。

<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

本頁內容