出站数据文件名:语法和示例 outbound-data-file-name-syntax-and-examples
說明用來命名傳出資料檔案的必要欄位、語法和慣例。
語法和檔案名稱元素 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
SPLITNUM
整數。 識別分割成多個部分的檔案部分,以改善處理時間。 數字表示資料屬於原始檔案的哪個部分。
如果分割大小小於100個部分,則整數必須至少為3位數,前面加零。
原始檔案將不會有任何分割編號。 第一個分割檔案的結尾將會是001。 請參閱下列範例。
.gz (optional)
檔案名稱範例 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
說明用來組織傳出資料檔案中資訊的必要欄位、語法和慣例。 根據這些規格格式化您的資料。
语法
資料檔案中的欄位會以下列順序顯示:
UUID<SPACE>SEGMENT_1,SEGMENT_2<SPACE>REMOVED_SEGMENT_,...
参数
此表格會列出定義資料檔案內容的變數。
UUID
<SPACE>
SEGMENT_N
REMOVED_SEGMENT_N
範例:基本檔案格式
正確格式化的資料檔案看起來可能類似於以下範例。 此檔案專案表示使用者符合區段24、26和27的資格。 視需要,以空格分隔 UUID
和區段ID。 另一個空格會分隔區段ID集。 在此範例中,使用者屬於區段24、26和27。 區段25和28中的區段已加以移除。
59767559181262060060278870901087098252 24,26,27 25,28