Audience Optimization報表的資料檔案和可操作的記錄檔 data-files-for-audience-optimization-reports
資料檔案包含曝光數、點選數或轉換資料。 格式正確後,您可以將此資料匯入Audience Manager,以便在Audience Optimization報表中檢視資料,並透過可操作的記錄檔使用資料建立特徵。 根據本節中的這些規格來格式化您的資料檔案。
概述 overview
正確命名和格式化的資料檔案可讓您將曝光數、點選數或轉換資料匯入Audience Optimization報表。 如果合作夥伴未與Audience Manager整合,而您想要在該報表套裝中處理其資料,此功能會很有用。 此程式需要不同的檔案,用於曝光、點按和轉換資料。 請勿在單一檔案中混合使用這些事件。
資料檔案必須隨附中繼資料檔案。 中繼資料檔案內容比對資料檔案資訊與報表功能表中相關且人類看得懂的標籤。 如需詳細資訊,請參閱中繼資料檔案的概述與對應。
資料檔案的命名慣例 naming-conventions
下列語法定義格式正確的資料檔案名稱的結構。 請注意,斜體 表示變數預留位置,會根據檔案內容而變更。
語法:
事件型別_yyyymmdd
在檔案名稱中:
- 事件型別會指出檔案包含曝光、點按或轉換。 為每種事件型別建立個別的檔案。
- 事件型別與年 — 月 — 日時間戳記之間以底線分隔。
- 上傳前,請先使用gzip壓縮檔案,再以
.gz
副檔名儲存。
基於這些需求,請根據資料檔案的內容命名您的資料檔案,如下所示:
-
曝光資料:
code language-none 曝光數_yyyymmdd.gz
-
按一下資料:
code language-none 點按_yyyymmdd.gz
-
轉換資料:
code language-none 轉換_yyyymmdd.gz
資料檔案的內容格式 content-format
下列語法定義格式正確的資料檔案中的內容結構。 請注意,斜體 表示變數預留位置,在實際資料檔案中會以標籤取代。
語法:
標頭標籤1 | 標頭標籤2 … 標頭標籤n | 版本
在檔案內容中:
-
標題標籤必須依下表所示的順序出現。 曝光次數和點按次數使用相同的標籤。 轉換檔案包含額外的標頭。
-
如果您沒有特定欄位的資料,請以
-1
填入該欄位。 -
檔案 必須 以版本編號結尾。 目前的版本是1.1。
-
以非列印ASCII 001字元分隔檔案標題和內容。 如果您無法使用ASCII 001,請使用定位字元分隔標題和資料。 由於這些是非列印字元,上述語法範例顯示僅供顯示用的直立線符號
"|"
。
欄位標籤
下表列出並說明資料檔案的欄標題。 標頭區分大小寫,且必須依表格中的順序顯示。 除非另有指示,否則所有資料型別都是整數(INT)。
yyyy-MM-dd HH:mm:ss
格式。轉換事件中出售的專案數。
僅供轉換資料檔使用。
購買或其他轉換金額。 資料型別: Float。
僅供轉換資料檔使用。
轉換登陸頁面的URL。 資料型別:字串。
僅供轉換資料檔使用。
轉換型別。 指出是否符合轉換。 選項包括:
0
:印象1
:按一下-1
:未歸因或不明
僅供轉換資料檔使用。
資料檔案的傳送方法 delivery-methods
將您的曝光數、點選數或轉換資料檔案上傳至Audience Manager帳戶的Amazon S3目錄。 請參閱本節以瞭解有關傳送/目錄路徑、檔案處理時間和更新的資訊。
傳遞路徑語法和範例
資料儲存在Amazon S3目錄中每個客戶的個別名稱空間中。 檔案路徑會遵循下列語法。 請注意,斜體 表示變數預留位置。 其他元素為常數或索引鍵,不會變更。
語法:
…/log_ingestion/pid= AAM ID/dpid= d_src/logs/ 檔案型別_yyyymmdd
下表定義檔案傳送路徑中的各個元素。
.../log_ingestion/
pid=AAM ID
dpid=d_src
logs
file type_yyyymmdd
範例上傳路徑和檔案名稱
上傳檔案時,路徑將類似於以下所示:
.../log_ingestion/pid=1234/dpid=567/logs/impressions_20150902
檔案處理時間和更新
資料檔案會定期每日處理四次。
若要更新資料,請傳送包含特定日期的所有曝光數、點按數或轉換數的檔案。 在此情況下,一天是從一午夜到下一個午夜的24小時期間。 作為最佳實務,您可能想要使用UTC時間來定義天間隔。
後續步驟 next-steps
檢閱命名和建立中繼資料檔案的需求。 若要開始使用,請參閱中繼資料檔案的概述與對應。