受眾最佳化報表的資料檔案和可操作的記錄檔

資料檔案包含曝光、點按或轉換資料。 格式正確後,您可將此資料匯入Audience Manager,以在Audience Optimization報表中檢視,並透過可操作的記錄檔使用資料建立特徵。 依照本節中的這些規範設定資料檔案的格式。

概述

命名正確且格式正確的資料檔案可讓您將曝光數、點按次數或轉換資料匯入Audience Optimization報表中。 與未與Audience Manager整合的合作夥伴合作,且您想要使用該報表套裝中的其資料時,這個用法很有幫助。 此程式需要個別的檔案,才能顯示曝光、點按和轉換資料。 請勿將這些事件混合在單一檔案中。

資料檔案必須附有中繼資料檔案。 元資料檔案內容將資料檔案資訊與報告菜單中相關、人類可讀的標籤匹配。 如需詳細資訊,請參閱中繼資料檔案的概述和對應

資料檔案的命名慣例

以下語法定義格式良好的資料檔案名稱的結構。 請注意, 斜體​表示變數預留位置,該預留位置會根據檔案內容而改變。

語法:

事件類型_yyyymmdd

在檔案名中:

  • 事件類型表示檔案包含曝光數、點按或轉換。 為每個事件類型建立個別檔案。
  • 底線可分隔事件類型和年月日時間戳記。
  • 在上傳之前,請使用gzip壓縮您的檔案,並以.gz副檔名儲存。

根據這些需求,請根據資料檔案的內容為其命名,如下所示:

  • 曝光資料:
    impressions_yyyymmdd.gz
  • 按一下資料:
    clicks_yyyymmdd.gz
  • 轉換資料:
    conversions_yyyymmdd>gz

資料檔案的內容格式

下列語法定義格式良好的資料檔案中的內容結構。 請注意, 斜體​表示變數預留位置,並以實際資料檔案中的標籤取代。

語法:

標題標籤1 |標 題標籤2標題標籤n |版 

在檔案內容中:

  • 標題標籤必須依順序顯示,如下表所示。 曝光次數和點按次數使用相同的標籤。 轉換檔案包含額外的標題。

  • 如果您沒有特定欄的資料,請以-1填入該欄位。

  • 檔案​必須​以版本號結束。 目前版本為1.1。

  • 以非打印ASCII 001字元分隔檔案標題和內容。 如果您無法使用ASCII 001,請以索引標籤分隔字元分隔標題和資料。 由於這些是非列印字元,上述語法範例只顯示垂直號"|"以供顯示之用。

欄位標籤

下表列出並說明資料檔案的欄標題。 標題區分大小寫,且必須依表格中的順序顯示。 除非另有指示,否則所有資料類型均為整數(INT)。

標籤 說明

時間戳記

曝光、點按或轉換事件的UTC日期和時間。 使用 yyyy-MM-dd HH:mm:ss格式。

User-ID

網站訪客的ID,也稱為資料提供者唯一使用者ID或DPUUID。

廣告商 — ID

廣告商的資料來源ID或整合代碼。

BU-ID

業務單位ID。

Campaign-ID

行銷活動 ID.

Creative-ID

創作 ID.

網站ID

網站 ID.

Placement-ID

來自廣告伺服器的數值位置ID。

Insertion-Order-ID

插入訂單ID。

Tactic-ID

戰術ID。

垂直ID

垂直或類別的ID。

數量

轉換事件中銷售的項目數。

僅適用於轉換資料檔案。

收入

購買或其他轉換金額。 資料類型:漂浮。

僅適用於轉換資料檔案。

其他資料

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

僅適用於轉換資料檔案。

事件類型

轉換類型。 指出轉換是否相符。 選項包括:

  • 0: 曝光數
  • 1: 按一下
  • -1:未歸因或未知

僅適用於轉換資料檔案。

版本

顯示在曝光、點按或轉換資料檔案中每一列結尾的必要版本號碼。 目前版本為1.1。

資料檔案的傳送方法

將您的曝光數、點按或轉換資料檔案上傳至Audience Manager帳戶的Amazon S3目錄。 如需傳遞/目錄路徑、檔案處理時間和更新的相關資訊,請參閱本區段。

重要

請連絡您的Audience Manager顧問或客戶服務,以開始使用並設定資料檔案的Amazon S3目錄。

傳遞路徑語法與範例

資料儲存在Amazon S3目錄中每個客戶的獨立命名空間中。 檔案路徑遵循下列語法。 注意, 斜體​表示變數預留位置。 其他元素為常數或索引鍵,不會變更。

語法:

…/log_ingestion/pid= AAM ID/dpid= d_src/logs/ 檔案類型_yyyymmdd

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

檔案參數 說明

.../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

檔案處理時間和更新

每天會處理資料檔案四次,定期間。

若要更新資料,請傳入包含特定日期所有曝光數、點按或轉換的檔案。 在此案例中,一天是從午夜1點到下一點的24小時期間。 最佳實務是,您可能想使用UTC時間來定義日間隔。

後續步驟

檢閱命名和建立中繼資料檔案的需求。 若要開始使用,請參閱中繼資料檔案的概述和對應

本頁內容