文件Audience ManagerAudience Manager 使用手冊

傳出資料檔案名稱：語法與範例 outbound-data-file-name-syntax-and-examples

Last update: Sat Jul 20 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • 主題：

說明用來命名傳出資料檔案的必要欄位、語法和慣例。

NOTE
樣式元素（monospaced text、斜體、括弧[ ] ( )等） 檔案中會指示程式碼元素和選項。 如需詳細資訊，請參閱程式碼與文字元素的樣式慣例。

語法和檔案名稱元素 syntax-file-name

輸出檔案名稱包含下列元素。 以下所有元素皆為選用元素。

[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索引鍵為：

  • 20914 - Google廣告商ID （原始、未雜湊）
  • 20915 — 廣告商的 Apple ID （原始、未雜湊）
  • 廠商ID — 第三方使用者ID （網頁/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位置的檔案，在檔案內容( Vendor ID=45454)中包含​ PID_ALIAS="XYZCustomer" ​和協力廠商使用者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

傳出資料檔案內容：語法和引數 outbound-contents-syntax

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

NOTE
樣式元素（monospaced text、斜體、括弧[ ] ( )等） 檔案中會指示程式碼元素和選項。 如需詳細資訊，請參閱程式碼與文字元素的樣式慣例。

語法

資料檔案中的欄位會以下列順序顯示：

UUID<SPACE>SEGMENT_1,SEGMENT_2<SPACE>REMOVED_SEGMENT_,...

參數

此表格會列出定義資料檔案內容的變數。

參數
說明
UUID
由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