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

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

注意

樣式元素(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" 檔案內容中包含第三方使用者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

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

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

注意

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

本頁內容