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)。

標籤
說明
時間戳記
曝光、點按或轉換事件的UTC日期和時間。 使用 yyyy-MM-dd HH:mm:ss格式。
使用者ID
您的網站訪客識別碼,也稱為資料提供者唯一使用者ID或DPUUID。
Advertiser-ID
廣告商的資料來源ID或整合代碼。
BU-ID
業務單位ID。
Campaign-ID
促銷活動ID。
Creative-ID
創作ID。
Site-ID
網站ID。
Placement-ID
來自廣告伺服器的數值位置ID。
Insertion-Order-ID
插入訂單ID。
戰術ID
策略ID。
垂直ID
垂直產業或類別的ID。
數量

轉換事件中出售的專案數。

僅供轉換資料檔使用。

收入

購買或其他轉換金額。 資料型別: Float。

僅供轉換資料檔使用。

其他資料

轉換登陸頁面的URL。 資料型別:字串。

僅供轉換資料檔使用。

Event-Type

轉換型別。 指出是否符合轉換。 選項包括:

  • 0:印象
  • 1:按一下
  • -1:未歸因或不明

僅供轉換資料檔使用。

版本
必要的版本編號,會出現在印象、點選或轉換資料檔案的每一列結尾。 目前的版本是1.1。

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

將您的曝光數、點選數或轉換資料檔案上傳至Audience Manager帳戶的Amazon S3目錄。 請參閱本節以瞭解有關傳送/目錄路徑、檔案處理時間和更新的資訊。

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

傳遞路徑語法和範例

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

語法:

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

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

檔案引數
說明
.../log_ingestion/
這是目錄儲存路徑的開頭。 一切設定完成後,您將會收到完整路徑。
pid=AAM ID
此機碼值組包含您的Audience Manager客戶識別碼。
dpid=d_src
此機碼值組包含傳入事件呼叫的資料來源ID。 它會識別資料來自的機構,並將該資料繫結至支援的中繼資料檔案。
logs
資料檔案的較高層級目錄。
file type_yyyymmdd
一種檔案型別名稱,可指出其包含的資料排序和傳送時間戳記。

範例上傳路徑和檔案名稱

上傳檔案時,路徑將類似於以下所示:

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

檔案處理時間和更新

資料檔案會定期每日處理四次。

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

後續步驟 next-steps

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

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