Audience Optimization 报表的数据文件以及可操作的日志文件 data-files-for-audience-optimization-reports
資料檔案包含曝光數、點按數或轉換資料。 格式正確後,您可以將此資料匯入Audience Manager,以便在 Audience Optimization報表 並透過以下方式使用資料建立特徵: 可操作的記錄檔. 依照本節中的這些規格來格式化您的資料檔案。
概述 overview
正確命名和格式化的資料檔案可讓您將曝光數、點選數或轉換資料匯入 Audience Optimization報表. 在與未整合的合作夥伴合作時,此功能會很有用 Audience Manager 而且您想要在該報表套裝中處理其資料。 此程式需要不同的曝光數、點按數和轉換資料檔案。 請勿在單一檔案中混合使用這些事件。
資料檔案必須隨附中繼資料檔案。 中繼資料檔案內容會將資料檔案資訊與報表功能表中人工可讀的相關標籤相符。 如需詳細資訊,請參閱 中繼資料檔案的概述與對應.
資料檔案的命名慣例 naming-conventions
下列語法定義格式正確的資料檔案名稱的結構。 注意, 斜體 表示會根據檔案內容而變更的變數預留位置。
语法:
事件型別_yyyymmdd
在檔案名稱中:
- 事件型別會指出檔案包含曝光、點按或轉換。 為每個事件型別建立個別的檔案。
- 事件型別與年 — 月 — 日時間戳記之間以底線分隔。
- 上傳前,請先使用gzip壓縮檔案,然後使用
.gz
副檔名。
基於這些需求,請根據資料檔案的內容為檔案命名,如下所示:
- 曝光資料:
曝光次數_yyyymmdd.gz
- 按一下資料:
點按次數_yyyymmdd.gz
- 轉換資料:
轉換_yyyymmdd.gz
資料檔案的內容格式 content-format
下列語法會定義格式正確的資料檔案中的內容結構。 注意, 斜體 表示變數預留位置,並在實際資料檔案中以標籤取代。
语法:
頁首標籤1 | 頁首標籤2 … 頁首標籤n | 版本
在檔案內容中:
-
頁首標籤必須依照下表所示的順序顯示。 曝光次數和點按次數使用相同的標籤。 轉換檔案包含額外的標頭。
-
如果您沒有特定欄的資料,請以該欄位填入
-1
. -
檔案 必須 以版本編號結尾。 目前的版本是1.1。
-
以非列印ASCII 001字元分隔檔案標題和內容。 如果您無法使用ASCII 001,請使用定位字元分隔標題和資料。 由於這些是非列印字元,上述語法範例顯示一個垂直號
"|"
僅供顯示之用。
欄位標籤
下表列出並說明資料檔案的欄標題。 標頭區分大小寫,且必須依表格中的順序顯示。 除非另有指示,否則所有資料型別均為整數(INT)。
yyyy-MM-dd HH:mm:ss
格式。轉換事件中出售的專案數。
僅適用於轉換資料檔案。
購買或其他轉換金額。 資料型別:浮點數。
僅適用於轉換資料檔案。
轉換登陸頁面的URL。 数据类型:字符串.
僅適用於轉換資料檔案。
轉換型別。 指出是否符合轉換。 选项包括:
0
: 印象1
: 单击-1
:未歸因或未知
僅適用於轉換資料檔案。
資料檔案的傳送方法 delivery-methods
將您的印象、點選或轉換資料檔案上傳至Amazon S3目錄,以供 Audience Manager 帳戶。 請參閱本節以瞭解有關傳送/目錄路徑、檔案處理時間和更新的資訊。
傳遞路徑語法和範例
資料會儲存在中每個客戶的個別名稱空間中, 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
檢閱命名和建立中繼資料檔案的需求。 若要開始使用,請參閱 中繼資料檔案的概述與對應.