與 YouTube 整合 (DV360)

本頁面說明必要設定，可透過 Display & Video 360 (DV360) 做為 Cortex Framework Data Foundation 行銷工作負載的資料來源，從 YouTube 匯入資料。

DV360 是 Google 廣告平台，可管理 YouTube 廣告和其他數位管道，讓廣告主更有效率地掌控行銷活動。

下圖說明如何透過 Cortex Framework Data Foundation 的行銷工作負載取得 DV360 資料：

圖 1：DV360 資料來源。

注意： 如要存取 DV360 資料來源的設定檔、分析檢視區塊和模型，請參閱資料來源目錄。

設定檔

config.json 檔案會設定連線至資料來源所需的設定，以便從各種工作負載轉移資料。這個檔案包含下列 DV360 參數：

   "marketing": {
        "deployDV360": true,
        "DV360": {
            "deployCDC": true,
            "datasets": {
                "cdc": "",
                "raw": "",
                "reporting": "REPORTING_DV360"
            }
        }
   }

下表說明各個行銷參數的值：

參數	意義	預設值	說明
marketing.deployDV360	部署 DV360	true	執行 DV360 資料來源的部署作業。
marketing.DV360.deployCDC	為 DV360 部署 CDC 指令碼	true	產生 DV360 CDC 處理指令碼，在 Cloud Composer 中以 DAG 形式執行。
marketing.DV360.datasets.cdc	DV360 適用的 CDC 資料集	-	DV360 適用的 CDC 資料集。
marketing.DV360.datasets.raw	DV360 原始資料集	-	DV360 的原始資料集。
marketing.DV360.datasets.reporting	DV360 報表資料集	REPORTING_DV360	DV360 的報表資料集。

資料模型

本節將使用實體關係圖 (ERD)，說明 YouTube (搭配 DV360) 資料模型。

圖 2：YouTube (搭配 DV360)：實體關係圖。

報表資料檢視

ERD 中的藍色物件代表包含匯總指標的報表檢視區塊。請參閱src/marketing/src/DV360/src/reporting/ddls中的指令碼。

設定 DV360 原始資料擷取功能

Cortex Framework 會使用即時報表功能與 DV360 整合。 即時報表 是 DV360 內建的可靠功能，可節省成本，並允許儲存、排定及下載較大且複雜的報表至檔案和不同位置。 每個報表都會定期在 BigQuery 中建立匯出資料表，這些資料表具有相同設定的資料表名稱前置字元，且包含所選日期範圍的資料，並以所選頻率更新。

注意： Google 將於 2024 年 7 月開始，將所有離線報表遷移至即時報表。「匯出至 BigQuery」功能在這兩種報表類型中的運作方式相同。您必須負責管理所有即時報表。 Cortex Framework 不會設定或控管其行為。

權限

如要使用即時報表從 DV360 順利匯出原始資料，您必須具備下列權限：

• DV360：
  • 所選夥伴或廣告主的標準存取權。
• Google Cloud：
  • 指派給 DV360 服務帳戶的 BigQuery User 角色。
  • 指派給 DV360 服務帳戶的 BigQuery Data Editor 角色。

設定

請按照下列步驟，從 DV360 設定原始資料表匯出功能。

1. 查看「連結 BigQuery 匯出工具帳戶」權限詳細資料部分，找出 DV360 BigQuery 匯出工具所需的服務帳戶。詳情請參閱圖 2。
   圖 2. 在「連結 BigQuery Exporter 帳戶」中找出服務帳戶
2. 取得 Google Cloud 權限。具有 BigQuery Administrator 角色的使用者需要將 BigQuery User 和 BigQuery Data Editor 角色授予上一個步驟中識別的 DV360 服務帳戶。
3. 將 BigQuery 連結至 DV360，並指定您打算在過程中使用的原始資料集。按照「離線報表」 >「啟用 BigQuery」一節中的操作說明進行。

4. 前往「即時報表」，然後為下表中的每一列建立一份報表，並完全按照顯示方式設定資料欄。如要進一步瞭解 src/DV360/config/table_schema 下的詳細資料欄結構定義檔案，請參閱「原始資料到 CDC 資料表結構定義」一節。

   1. 新增至少一個「合作夥伴」或「廣告主」篩選器。請確認這與步驟 3 中 BigQuery 連結的權限一致。
   注意： 如果匯出多個合作夥伴或廣告主，可能需要設定多份報表或匯出項目。
   1. 將報表時區設定為「廣告主時區」。詳情請參閱下節「其他注意事項」。
   注意： 如果您的帳戶或 BigQuery 連結只有廣告主存取權，就無法加入合作夥伴篩選條件，否則「匯出至 BigQuery」選項會停用，直到移除合作夥伴篩選條件為止。

   資料表前置字串	要納入的欄位
   lineitem_details	日期 委刊項編號 委刊項 廣告活動 ID 廣告活動 委刊項類型 委刊項開始日期 委刊項結束日期	曝光次數
   lineitem_insights	日期 委刊項編號 裝置類型 瀏覽器 環境 國家/地區 合作夥伴 ID 合作夥伴 合作夥伴幣別 廣告主 ID 廣告主 廣告主所用幣別 廣告活動 ID 廣告活動 插入委刊單編號 廣告訂單 委刊項 委刊項類型 委刊項開始日期 委刊項結束日期	曝光次數 點擊次數 收益 (美元) 參與 收益 (合作夥伴幣別) 收益 (廣告主所用幣別) TrueView：觀看
   adgroup_insights_by_age_gender	日期 YouTube 廣告群組 ID 年齡 (YouTube) 性別 委刊項編號 合作夥伴 ID 合作夥伴 合作夥伴幣別 AdvertiserID 廣告主 廣告主所用幣別 插入委刊單編號 廣告訂單 委刊項 YouTube 廣告群組	收益 (美元) 曝光次數 點擊次數 參與次數 (YouTube) 收益 (合作夥伴幣別) 收益 (廣告主所用幣別) TrueView：觀看
   adgroup_insights_by_audience	日期 YouTube 廣告群組 ID 目標對象區隔 目標對象區隔類型 委刊項編號 合作夥伴 ID 合作夥伴 PartnerCurrency 廣告主 ID 廣告主 廣告主所用幣別 插入委刊單編號 廣告訂單 委刊項	曝光次數 點擊次數 YouTube 廣告群組 收益 (美元) 參與次數 (YouTube) 收益 (合作夥伴幣別) 收益 (廣告主所用幣別) TrueView：觀看
   adgroup_insights_by_adformat	日期 YouTube 廣告群組 ID YouTube 廣告格式 委刊項編號 合作夥伴 ID 合作夥伴 合作夥伴幣別 廣告主 ID 廣告主 廣告主所用幣別 插入委刊單編號 廣告訂單 委刊項	曝光次數 點擊次數 YouTube 廣告群組 收益 (美元) 參與次數 (YouTube) 收益 (合作夥伴幣別) 收益 (廣告主所用幣別) TrueView：觀看
   adgroup_insights_by_placement	日期 YouTube 廣告群組 ID 刊登位置 (所有 YouTube 頻道) 刊登位置名稱 (所有 YouTube 頻道) 委刊項編號 PartnerID 合作夥伴 合作夥伴幣別 廣告主 ID 廣告主 廣告主所用幣別 插入委刊單編號 廣告訂單 委刊項	曝光次數 YouTube 廣告群組 收益 (美元) 參與次數 (YouTube) 收益 (合作夥伴幣別) 收益 (廣告主所用幣別) TrueView：觀看
   adgroup_insights_by_adtype	日期 YouTube 廣告群組 ID YouTube 廣告類型 委刊項編號 合作夥伴 ID 合作夥伴 合作夥伴幣別 廣告主 ID 廣告主 廣告主所用幣別 插入委刊單編號 廣告訂單 委刊項	曝光次數 點擊次數 YouTube 廣告群組 收益 (美元) 參與次數 (YouTube) 收益 (合作夥伴幣別) 收益 (廣告主所用幣別) TrueView：觀看
   ad_insights	日期 YouTube 廣告 ID 委刊項編號 合作夥伴 ID 合作夥伴 合作夥伴幣別 廣告主 ID 廣告主 AdvertiserCurrency 插入委刊單編號 廣告訂單 委刊項 YouTube 廣告群組 ID YouTube 廣告群組 YouTube 廣告	曝光次數 點擊次數 收益 (美元) 參與次數 (YouTube) 收益 (合作夥伴幣別) 收益 (廣告主所用幣別) TrueView：觀看

5. 設定時間表並填入歷來資料。請務必使用與步驟 1 中設定的相同 BigQuery 連結，以及與上表完全相同的資料表前置字串。詳情請參閱下節「其他注意事項」。

6. • 手動觸發補充作業，或等待排定的匯出作業開始。無論採用哪種方式，資料都會自動匯入為 BigQuery 連結設定的原始資料集。

其他事項

時區選取注意事項：

• 設定匯出時，您可以選擇廣告主時區或世界標準時間時區，但僅適用於部分報表類型。不過，YouTube 相關報表僅支援廣告主時區。因此，設定匯出時，請務必選取「廣告主」時區設定。

• 由於報表匯出作業會預先彙整每日資料，Cortex Framework 會直接使用提供的日期，不進行時區轉換。您必須負責解讀所回報的時區資訊。

排定時間和補充歷來資料：

• 建議選取「最近 7 天」做為匯出日期範圍，並選取「每日」做為匯出頻率。選取匯出日期範圍和匯出頻率時，請務必兼顧資料準確度和儲存空間成本，但無論選擇哪種設定，都能搭配我們的 CDC 程序使用。

• 匯出至 BigQuery 時，即時報表最多可匯出 14 天的資料，但 DV360 偶爾可能會在報表日期後 31 天內，對資料進行小幅更新。如果您為多個廣告主設定匯出功能，每個廣告主的日期都會採用各自的時區。

• 如果需要非排程的單次匯出作業，即時報表功能可直接將最多 2 年的資料匯出至 BigQuery 資料表。請務必至少手動透過 DV360 使用者介面執行一次這項操作。

資料更新間隔和延遲

一般來說，Cortex Framework 資料來源的資料更新頻率取決於上游連線允許的頻率，以及 DAG 的執行頻率。調整 DAG 執行頻率，以配合上游頻率、資源限制和業務需求。

使用 DV360 即時報表時，資料更新間隔取決於設定 BigQuery Export 時的匯出頻率，可能是每日、每週或每月。

設定

本節說明資料處理的設定。

Cloud Composer 連線

在 Cloud Composer 中建立下列連線。詳情請參閱 Cloud Composer 說明文件。

連線名稱	目的
dv360_cdc_bq	原始資料集 > CDC 資料集移轉。
dv360_reporting_bq	將 CDC 資料集轉移至報表資料集。

原始資料到 CDC 資料表的結構定義

目錄 src/DV360/config/table_schema 包含從 DV360 匯出的每組資料表 (以相同前置字元識別) 各一個結構定義檔案。每個結構定義檔案都包含兩個資料欄：ColumnName 和 ColumnDataType。

注意： 如果您的使用案例在即時報表匯出資料中包含其他資料欄，請務必在對應的結構定義檔案中一併加入這些資料欄。

內容攝入設定

檔案 src/DV360/config/ingestion_settings.yaml 包含可控管「來源到 CDC」資料管道的其他設定。

來源到 CDC 資料表

本節包含的項目可控管 DV360 匯出資料表的擷取方式，以及相關的 CDC 程序行為。每個項目都對應一份即時報表，並以匯出前置字元識別。

下列參數可控制每個項目的 Source to CDC 設定：

參數	說明
base_table	CDC 資料集中的資料表，用於儲存 CDC 轉換後的原始資料 (例如 customer)。
load_frequency	這個實體的 DAG 執行頻率，用於填入 CDC 資料表。如要進一步瞭解可能的值，請參閱 Airflow 說明文件。
raw_table_prefix	對應的即時報表用於設定這個 BigQuery Export 的前置字元。
row_identifiers	以逗號分隔的資料欄，這些資料欄會構成這個資料表的專屬記錄。
partition_details	選用：如要根據效能考量分割這個表格，詳情請參閱「資料表分區」。
cluster_details	選用：如要叢集這個資料表以提升效能，請參閱「叢集設定」一節瞭解詳情。

報表設定

您可以使用報表設定檔 src/DV360/config/reporting_settings.yaml，設定及控管 Cortex Framework 如何為 DV360 最終報表層產生資料。這個檔案會控管報表層 BigQuery 物件 (資料表、檢視區塊、函式或預存程序) 的產生方式。

詳情請參閱「自訂報表設定檔」。

後續步驟

• 如要進一步瞭解其他資料來源和工作負載，請參閱「資料來源和工作負載」一文。
• 如要進一步瞭解在正式環境中部署的步驟，請參閱 Cortex Framework Data Foundation 部署作業的必要條件。