傳出資料檔案名稱:語法與範例 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傳輸
  • 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壓縮。

檔案名示例 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 位置,使用 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

出站資料檔案內容:語法和參數 outbound-contents-syntax

描述用於組織出站資料檔案中資訊的必填欄位、語法和約定。 根據這些規格格式化資料。

NOTE
樣式元素(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
recommendation-more-help
de293fbf-b489-49b0-8daa-51ed303af695