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

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

注意

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

本頁內容

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now