Audience Optimization 报表的数据文件以及可操作的日志文件

上次更新: 2023-05-20
  • 主题:
  • Log Files
    查看有关此主题的更多信息

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

概述

正確命名和格式化的資料檔案可讓您將曝光數、點選數或轉換資料匯入 Audience Optimization報表. 在與未整合的合作夥伴合作時,此功能會很有用 Audience Manager 而且您想要在該報表套裝中處理其資料。 此程式需要不同的曝光數、點按數和轉換資料檔案。 請勿在單一檔案中混合使用這些事件。

資料檔案必須隨附中繼資料檔案。 中繼資料檔案內容會將資料檔案資訊與報表功能表中人工可讀的相關標籤相符。 如需詳細資訊,請參閱 中繼資料檔案的概述與對應.

資料檔案的命名慣例

下列語法定義格式正確的資料檔案名稱的結構。 注意, 斜體 表示會根據檔案內容而變更的變數預留位置。

语法:

事件型別_yyyymmdd

在檔案名稱中:

  • 事件型別會指出檔案包含曝光、點按或轉換。 為每個事件型別建立個別的檔案。
  • 事件型別與年 — 月 — 日時間戳記之間以底線分隔。
  • 上傳前,請先使用gzip壓縮檔案,然後使用 .gz 副檔名。

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

  • 曝光資料:
    曝光次數_yyyymmdd.gz
  • 按一下資料:
    點按次數_yyyymmdd.gz
  • 轉換資料:
    轉換_yyyymmdd.gz

資料檔案的內容格式

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

语法:

頁首標籤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.

位置ID

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

Insertion-Order-ID

插入訂單ID。

戰術ID

策略ID。

Vertical-ID

垂直產業或類別的ID。

数量

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

僅適用於轉換資料檔案。

收入

購買或其他轉換金額。 資料型別:浮點數。

僅適用於轉換資料檔案。

Other-Data

轉換登陸頁面的URL。 数据类型:字符串.

僅適用於轉換資料檔案。

Event-Type

轉換型別。 指出是否符合轉換。 选项包括:

  • 0: 印象
  • 1: 单击
  • -1:未歸因或未知

僅適用於轉換資料檔案。

版本

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

資料檔案的傳送方法

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

重要

請聯絡您的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

檔案處理時間和更新

資料檔案會定期一天處理四次。

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

后续步骤

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

在此页面上