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

說明用於命名出站資料檔案的必填欄位、語法和慣例。

注意

樣式元素(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 Advertiser 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" 檔案內容( Vendor ID=45454)中有第三方使用者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

出站資料檔案內容:語法和參數

說明用於組織傳出資料檔案中資訊的必填欄位、語法和慣例。 根據這些規格格式化您的資料。

注意

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

本頁內容