資料檔案包含曝光、點按或轉換資料。 當格式正確時,您可將此資料匯入Audience Manager,以在對象最佳化報表中檢視,並透過可操作的記錄檔使用資料建立特徵。 依照本節中的這些規格設定資料檔案的格式。
正確命名和格式化的資料檔案可讓您將曝光、點按或轉換資料匯入對象最佳化報表。 當您與未與Audience Manager整合且您想要在該報表套裝中處理其資料的合作夥伴合作時,這項功能十分有用。 此程式需要個別的檔案,才能產生曝光、點按和轉換資料。 請勿將這些事件混合在單一檔案中。
資料檔案必須隨附中繼資料檔案。 中繼資料檔案內容會比對資料檔案資訊與報表選單中相關、人工可讀的標籤。 如需詳細資訊,請參閱中繼資料檔案的概述與對應。
下列語法定義格式良好的資料檔案名稱的結構。 請注意,斜體表示變數預留位置會依檔案內容而變更。
語法:
event type_yyyymmdd
在檔案名中:
.gz
副檔名儲存檔案。根據這些要求,請根據資料檔案的內容命名檔案,如下所示:
impressions_yyyymmdd.gz
clicks_yyyymmdd.gz
轉換_yyyymmdd.gz
下列語法定義格式良好的資料檔案的內容結構。 請注意,斜體表示變數預留位置,並以實際資料檔案中的標籤取代。
語法:
標題標籤1 |標 題標籤2 … 標題標籤n |版 本
在檔案內容中:
標題標籤必須依順序顯示,如下表所示。 印象和點按使用相同的標籤。 轉換檔案包含額外的標題。
如果您沒有特定欄的資料,請在該欄填入-1
。
檔案必須以版本號結尾。 目前版本為1.1。
使用非列印的ASCII 001字元來分隔檔案標題和內容。 如果您無法使用ASCII 001,請使用標籤分隔字元分隔標題和資料。 由於這些字元是非列印字元,上述語法範例只會顯示管道"|"
,以供顯示之用。
欄位標籤
下表列出並說明資料檔案的欄標題。 標題會區分大小寫,且必須依表格中的順序顯示。 除非另有指示,所有資料類型都是整數(INT)。
標籤 | 說明 |
---|---|
時間戳記 |
曝光、點按或轉換事件的UTC日期和時間。 使用 |
使用者ID |
您網站訪客的ID,也稱為資料提供者唯一使用者ID或DPUUID。 |
廣告商ID |
您廣告商的資料來源ID或整合代碼。 |
BU-ID |
業務單位ID。 |
促銷活動ID |
行銷活動 ID. |
Creative-ID |
創作 ID. |
網站ID |
網站 ID. |
位置ID |
來自廣告伺服器的數值位置ID。 |
插入順序ID |
插入順序ID。 |
Tactic-ID |
戰術ID。 |
垂直ID |
垂直或類別的產業ID。 |
數量 |
轉換事件中售出的項目數。 僅限轉換資料檔案。 |
收入 |
購買或其他轉換金額。 資料類型:漂浮。 僅限轉換資料檔案。 |
其他資料 |
轉換登陸頁面的URL。 資料類型: 字串. 僅限轉換資料檔案。 |
事件類型 |
轉換類型。 指出轉換是否相符。 選項包括:
僅限轉換資料檔案。 |
版本 |
在曝光、按一下或轉換資料檔案中每一列結尾顯示的必要版本號碼。 目前版本為1.1。 |
將您的曝光、點選或轉換資料檔案上傳至Audience Manager帳戶的Amazon S3目錄。 如需傳送/目錄路徑、檔案處理時間和更新的相關資訊,請參閱本節。
請連絡您的Audience Manager顧問或客戶服務以開始使用並設定資料檔案的Amazon S3目錄。
傳送路徑語法和範例
資料會儲存在Amazon S3目錄中每個客戶的個別命名空間中。 檔案路徑遵循下列語法。 請注意,斜體表示變數預留位置。 其他元素是常數或鍵,不會變更。
語法:
…/log_ingestion/pid= AAM ID/dpid= d_src/logs/ 檔案類型_yyyymmdd
下表定義了檔案傳送路徑中的每個元素。
檔案參數 | 說明 |
---|---|
|
這是目錄儲存路徑的開始。 一切就緒後,您將獲得完整的路徑。 |
|
此索引鍵值配對包含您的 Audience Manager客戶ID。 |
|
此金鑰值配對包含在事件呼叫中傳入的資料來源ID。 它會識別資料來源的機構,並將該資料系結至支援的中繼資料檔案。 |
|
資料檔案的更高層級目錄。 |
|
一種檔案類型名稱,它指示包含的資料類型和傳送時間戳。 |
上傳路徑和檔案名稱範例
上傳檔案時,路徑看起來類似:
.../log_ingestion/pid=1234/dpid=567/logs/impressions_20150902
檔案處理時間與更新
資料檔案每天會以定期間隔處理四次。
若要更新資料,請傳送包含特定日期所有印象、點按或轉換的檔案。 在此例中,一天是從午夜到下一個午夜的24小時時段。 作為最佳做法,您可能希望使用UTC時間定義您的日間隔。
檢視命名和建立中繼資料檔案的需求。 若要開始,請參閱中繼資料檔案的概述與對應。