Show Menu
主題×

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

說明用於命名出站資料檔案的必填欄位、語法和慣例。
樣式元素( 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 for Advertisers(原始、 未雜湊)
  • 廠商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