文档Audience ManagerAudience Manager 用户指南

出站数据文件名：语法和示例 outbound-data-file-name-syntax-and-examples

Last update: Sat May 20 2023 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 位置，使用 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

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

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

NOTE
樣式元素(monospaced text， 斜體，括弧 [ ] ( )、等) 檔案中會指示程式碼元素和選項。 请参阅代码和文本元素的样式约定，以了解更多信息。

语法

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

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

参数

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

参数
描述
UUID
由指派的不重複使用者ID 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