受眾最佳化報表的資料檔案和可操作的記錄檔 data-files-for-audience-optimization-reports
資料檔案包含印象、按一下或轉換資料。 格式正確後,可將此資料導入Audience Manager,以在 Audience Optimization報告 並通過 可操作的日誌檔案。 根據本節中的這些規範設定資料檔案的格式。
概述 overview
通過正確命名和格式化的資料檔案,您可以將印象、按一下或轉換資料 Audience Optimization報告。 在與未與整合的合作夥伴合作時,此功能非常有用 Audience Manager 而且你想在報告套件中處理他們的資料。 此過程需要單獨的檔案來記錄、按一下和轉換資料。 不要將這些事件混合到單個檔案中。
資料檔案必須與元資料檔案相伴。 元資料檔案內容將資料檔案資訊與報告菜單中的相關、可人讀標籤匹配。 有關詳細資訊,請參見 元資料檔案的概述和映射。
資料檔案的命名約定 naming-conventions
以下語法定義格式良好的資料檔案名的結構。 注意, 斜體 指示根據檔案內容而更改的變數佔位符。
語法:
事件類型_yyymmd
在檔案名中:
- 事件類型表示檔案包含印刷、按一下或轉換。 為每個事件類型建立單獨的檔案。
- 下划線將事件類型和年月日期時間戳分開。
- 在上載之前,請使用gzip壓縮檔案,然後使用
.gz
檔案副檔名。
根據這些要求,根據資料檔案的內容命名如下:
- 印象資料:
印象yyymmd.gz
- 按一下資料:
按一下yyymmd.gz
- 轉換資料:
轉換yyymmd.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
將您的印象、按一下或轉換資料檔案上載到AmazonS3目錄 Audience Manager 帳戶。 有關傳遞/目錄路徑、檔案處理時間和更新的資訊,請參閱本節。
傳遞路徑語法和示例
資料儲存在一個獨立的命名空間中,每個客戶都位於 Amazon S3 的子菜單。 檔案路徑遵循下面所示的語法。 注意, 斜體 指示變數佔位符。 其他元素是常數或鍵,不更改。
語法:
…/log_ingestion/pid= IDAAM/dpid= d_src/logs/ 檔案類型_yyymmd
下表定義了檔案傳遞路徑中的每個元素。
.../log_ingestion/
pid=AAM ID
dpid=d_src
logs
file type_yyyymmdd
示例上載路徑和檔案名
上載檔案時,路徑將類似於以下內容:
.../log_ingestion/pid=1234/dpid=567/logs/impressions_20150902
檔案處理時間和更新
每天處理4次資料檔案,間隔不定。
要更新資料,請發送包含特定日期所有印象、按一下或轉換的檔案。 在這種情況下,一天是從午夜到下一個午夜的24小時。 作為最佳做法,您可能希望使用UTC時間定義日間隔。
後續步驟 next-steps
查看命名和建立元資料檔案的要求。 要開始,請參閱 元資料檔案的概述和映射。