Google 會運用 AI 技術將內容翻譯成你偏好的語言，但可能會出錯。

與 TikTok 整合

本頁面說明必要設定，可將 TikTok 的資料做為 Cortex Framework 資料基礎行銷工作負載的資料來源。

TikTok 是熱門的社群媒體應用程式，以短篇影片聞名，Cortex Framework 可提供資料來分析整體行銷成效。結合 TikTok 和各種來源的資料，您就能更全面地瞭解目標對象，以及社群媒體廣告活動在不同平台上的成效。

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

TikTok 資料來源

圖 1：TikTok 資料來源。

設定檔

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

   "marketing": {
        "deployTikTok": true,
        },
        "TikTok": {
            "deployCDC": true,
            "datasets": {
                "cdc": "",
                "raw": "",
                "reporting": "REPORTING_TikTok"
            }
        }

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

參數	意義	預設值	說明
`marketing.deployTikTok`	部署 TikTok	`true`	執行 TikTok 資料來源的部署作業。
`marketing.TikTok.deployCDC`	為 TikTok 部署 CDC 指令碼	`true`	產生 TikTok CDC 處理指令碼，在 Managed Service for Apache Airflow 中以 DAG 形式執行。
`marketing.TikTok.datasets.cdc`	TikTok 的 CDC 資料集		TikTok 的 CDC 資料集。
`marketing.TikTok.datasets.raw`	TikTok 原始資料集		TikTok 的原始資料集。
`marketing.TikTok.datasets.reporting`	TikTok 報表資料集	`"REPORTING_TikTok"`	TikTok 的報表資料集。

資料模型

本節將使用實體關係圖 (ERD) 說明 TikTok 資料模型。

圖 2：TikTok：實體關係圖。

基本檢視

這些是 ERD 中的藍色物件，也是 CDC 資料表上的檢視畫面，除了部分資料欄名稱別名外，沒有任何轉換。請參閱src/marketing/src/TikTok/src/reporting/ddls中的指令碼。

報表資料檢視

這些是 ERD 中的綠色物件，也是包含匯總指標的報表檢視畫面。請參閱src/marketing/src/TikTok/src/reporting/ddls中的指令碼。

API 連線

Cortex Framework 使用 TikTok Reporting API (版本 v1.3) 做為 TikTok 資料的權威來源。Cortex Framework 使用同步模式，並呼叫 Basic Reporting API，以擷取廣告和廣告群組的成效指標。確保 Cortex Framework 能存取 TikTok 的最新資訊，進行有效的資料分析和報表製作。

如要進一步瞭解 API 連線，請參閱「TikTok 報表 API」。

帳戶驗證

如要設定 TikTok 帳戶和帳戶驗證，請按照下列步驟操作：

如果還沒有 TikTok 開發人員帳戶，請先設定。
建立應用程式，以便整合 Cortex Framework。詳情請參閱「TikTok API for Business」。請務必在應用程式的範圍中選取下列兩項：
- Ad Account Management/Ad Account Information
- Reporting/All
按照 TikTok 指南的說明，取得應用程式 ID、Secret和長期存取權杖，然後分別以以下名稱儲存在 Secret Manager 中：
- 應用程式 ID：cortex_tiktok_app_id
- 密碼：cortex_tiktok_app_secret
- 長期存取權杖：cortex_tiktok_access_token

資料更新間隔和延遲

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

使用 TikTok Marketing API，您幾乎可以即時取得所有資料 (轉換除外)。

Managed Airflow 連線

在 Managed Airflow 中建立下列連線。詳情請參閱管理 Airflow 連線說明文件。

連線名稱	目的
`tiktok_raw_dataflow`	適用於 TikTok API > BigQuery 原始資料集
`tiktok_cdc_bq`	針對原始資料集 > CDC 資料集移轉
`tiktok_reporting_bq`	如為 CDC 資料集，請移轉報表資料集

Managed Service for Apache Airflow 服務帳戶權限

將 Dataflow 權限授予 Managed Airflow 中使用的服務帳戶 (如 tiktok_raw_dataflow 連線中設定)。請參閱 Dataflow 說明文件中的操作說明。

此外，該服務帳戶也應具備 Secret Manager 存取者權限。

內容攝入設定

透過檔案 src/TikTok/config/ingestion_settings.yaml 中的設定，控制 Source to Raw 和 Raw to CDC 資料管道。本節將說明各個資料管道的參數。

來源到原始資料表

這個部分包含的項目可控管如何從 TikTok 擷取資料，以及資料在原始資料集中的最終位置。每個項目都對應到一個原始資料表，其中包含從 TikTok API 擷取的該實體資料。根據這些設定參數，Cortex Framework 會建立 Airflow DAG，執行 Dataflow 管道來處理 TikTok API 的資料。

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

參數	說明
`base_table`	原始資料集中的資料表，用於儲存實體的資料(例如「廣告」資料)。
`load_frequency`	系統為這個實體執行 DAG 的頻率，以處理資料。如要瞭解可能的值，請參閱 Airflow 說明文件。
`schema_file`	`src/table_schema` 目錄中的結構定義檔案，可將 API 回應欄位對應至目的地資料表的資料欄名稱。
`partition_details`	選用：如要基於效能考量分割這個資料表，詳情請參閱「資料表分區」。
`cluster_details`	選用：如要考量效能，可將這個表格叢集化。詳情請參閱「叢集設定」。

原始資料表到 CDC 資料表

本節包含的項目可控管資料從原始資料表移至 CDC 資料表的方式。每個項目都會對應至 CDC 表格 (而 CDC 表格又會對應至 Source to Raw table 中提及的實體)。

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

參數	說明
`base_table`	CDC 資料集中的資料表，用於儲存 CDC 轉換後的原始資料 (例如 `auction_ad_performance`)。
`load_frequency`	這個實體的 DAG 執行頻率，用於填入 CDC 資料表。詳情請參閱 Airflow 說明文件，瞭解可能的值。
`row_identifiers`	資料欄清單 (以半形逗號分隔)，這些資料欄會構成這個資料表的唯一記錄。
`partition_details`	選用：如要基於效能考量分割這個資料表，詳情請參閱「資料表分區」。
`cluster_details`	選用：如要根據效能考量，將這個表格叢集化，詳情請參閱「叢集設定」。

報表設定

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

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

後續步驟

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