受眾最佳化報表的資料檔案和可操作的記錄檔 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)。

標籤
說明
時間戳
UTC的印象、按一下或轉換事件的日期和時間。 使用 yyyy-MM-dd HH:mm:ss 的子菜單。
用戶ID
站點訪問者的ID,也稱為 資料提供程式唯一用戶ID 或DPUUID。
廣告商ID
您的廣告商的資料源ID或整合代碼。
BU-ID
業務單位ID。
市場活動ID
行銷活動 ID.
創意ID
創作 ID.
站點ID
網站 ID.
放置ID
廣告伺服器的數字放置ID。
插入順序ID
插入順序ID。
戰術ID
戰術ID
垂直ID
行業垂直或類別的ID。
數量

在轉換事件中銷售的物料數。

僅用於轉換資料檔案。

收入

採購或其他轉換金額。 資料類型:浮起來。

僅用於轉換資料檔案。

其他資料

轉換登錄頁的URL。 資料類型: 字串.

僅用於轉換資料檔案。

事件類型

轉換類型。 指示轉換是否匹配。 選項包括:

  • 0: 曝光
  • 1: 按一下
  • -1:未屬性或未知

僅用於轉換資料檔案。

版本
在印象、按一下或轉換資料檔案中每行末尾顯示的必需版本號。 當前版本為1.1。

資料檔案的傳遞方法 delivery-methods

將您的印象、按一下或轉換資料檔案上載到AmazonS3目錄 Audience Manager 帳戶。 有關傳遞/目錄路徑、檔案處理時間和更新的資訊,請參閱本節。

IMPORTANT
與Audience Manager顧問或客戶服務人員聯繫以開始並設定 Amazon S3 的子菜單。

傳遞路徑語法和示例

資料儲存在一個獨立的命名空間中,每個客戶都位於 Amazon S3 的子菜單。 檔案路徑遵循下面所示的語法。 注意, 斜體 指示變數佔位符。 其他元素是常數或鍵,不更改。

語法:

…/log_ingestion/pid= IDAAM/dpid= d_src/logs/ 檔案類型_yyymmd

下表定義了檔案傳遞路徑中的每個元素。

檔案參數
說明
.../log_ingestion/
這是目錄儲存路徑的開始。 設定完全時,您將收到完整路徑。
pid=AAM ID
此鍵值對包含 Audience Manager 客戶ID。
dpid=d_src
此鍵值對包含在事件調用中傳遞的資料源ID。 它標識資料來自的機構,並將資料與支援的元資料檔案關聯起來。
logs
資料檔案的更高級別目錄。
file type_yyyymmdd
一種檔案類型名稱,它指示它包含的資料類型和傳遞時間戳。

示例上載路徑和檔案名

上載檔案時,路徑將類似於以下內容:

.../log_ingestion/pid=1234/dpid=567/logs/impressions_20150902

檔案處理時間和更新

每天處理4次資料檔案,間隔不定。

要更新資料,請發送包含特定日期所有印象、按一下或轉換的檔案。 在這種情況下,一天是從午夜到下一個午夜的24小時。 作為最佳做法,您可能希望使用UTC時間定義日間隔。

後續步驟 next-steps

查看命名和建立元資料檔案的要求。 要開始,請參閱 元資料檔案的概述和映射

recommendation-more-help
de293fbf-b489-49b0-8daa-51ed303af695