TikTok との連携

このページでは、Cortex Framework Data Foundation のマーケティング ワークロードのデータソースとして TikTok からデータを取得するために必要な構成について説明します。

TikTok は、短い動画で知られる人気のソーシャル メディア アプリです。Cortex Framework は、マーケティングの全体的なパフォーマンスを分析するためにデータを取得できます。TikTok とさまざまなソースのデータを取り込むことで、ターゲット オーディエンスと、さまざまなプラットフォームにおけるソーシャル メディア キャンペーンの効果をより包括的に把握できます。

次の図は、Cortex Framework Data Foundation のマーケティング ワークロードで TikTok データを利用できるようにする方法を示しています。

構成ファイル

config.json ファイルでは、さまざまなワークロードからデータを転送するためにデータソースに接続するために必要な設定を構成します。このファイルには、TikTok の次のパラメータが含まれています。

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

次の表に、各マーケティング パラメータの値を示します。

データモデル

このセクションでは、エンティティ リレーションシップ ダイアグラム（ERD）を使用して TikTok データモデルについて説明します。

ベースビュー

これらは ERD の青色のオブジェクトであり、CDC テーブルのビューで、一部の列名エイリアス以外の変換はありません。スクリプトは src/marketing/src/TikTok/src/reporting/ddls にあります。

レポートビュー

これらは ERD の緑色のオブジェクトであり、集計指標を含むレポートビューです。スクリプトは src/marketing/src/TikTok/src/reporting/ddls にあります。

API 接続

Cortex Framework は、TikTok データの信頼できるソースとして TikTok Reporting API バージョン v1.3 を使用します。Cortex Framework は同期モードを使用し、Basic Reporting API を呼び出して、広告と広告グループのパフォーマンス指標を取得します。これにより、Cortex Framework は TikTok の最新かつ正確な情報にアクセスできるため、効果的なデータ分析とレポート作成が可能になります。

API 接続の詳細については、TikTok Reporting API をご覧ください。

アカウント認証

TikTok アカウントとアカウント認証を設定するには、次の操作を行います。

1. TikTok デベロッパー アカウントを設定します（まだ設定していない場合）。
2. Cortex Framework 統合用のアプリを作成します。詳しくは、TikTok API for Business をご覧ください。アプリのスコープで次の 2 つを選択していることを確認します。
   • Ad Account Management/Ad Account Information
   • Reporting/All
3. TikTok ガイドに記載されている手順に沿って、アプリ ID、シークレット、長期アクセス トークンを取得し、それぞれ次の名前で Secret Manager に保存します。
   • アプリ ID: cortex_tiktok_app_id
   • シークレット: cortex_tiktok_app_secret
   • 長期アクセス トークン: cortex_tiktok_access_token

データの更新頻度と遅延

一般に、Cortex Framework データソースのデータの更新頻度は、アップストリーム接続で許可される頻度と DAG 実行の頻度によって制限されます。アップストリームの頻度、リソースの制約、ビジネスニーズに合わせて DAG の実行頻度を調整します。

TikTok Marketing API を使用すると、ほとんどのデータ（コンバージョンを除く）をほぼリアルタイムで利用できます。

Cloud Composer 接続

Cloud Composer で次の接続を作成します。詳細については、Airflow 接続を管理するドキュメントをご覧ください。

Cloud Composer サービス アカウントの権限

Cloud Composer で使用されるサービス アカウントに Dataflow 権限を付与します（tiktok_raw_dataflow 接続で構成されているように）。Dataflow のドキュメントの手順をご覧ください。

また、同じサービス アカウントに Secret Manager アクセサーのアクセス権も付与する必要があります。

取り込み設定

Source to Raw と Raw to CDC のデータ パイプラインは、ファイル src/TikTok/config/ingestion_settings.yaml の設定で制御します。このセクションでは、各データ パイプラインのパラメータについて説明します。

ソースから未加工テーブル

このセクションには、TikTok からのデータの取得方法と、元のデータセット内でのデータの最終的な配置を制御するエントリがあります。各エントリは、そのエンティティの TikTok API から取得されたデータを含む 1 つの未加工テーブルに対応しています。この構成パラメータに基づいて、Cortex Framework は、Dataflow パイプラインを実行して TikTok API のデータ処理を行う Airflow DAG を作成します。

次のパラメータは、各エントリの Source to Raw の設定を制御します。

元のテーブルから CDC テーブル

このセクションには、元のテーブルから CDC テーブルにデータが移動する方法を指定するエントリがあります。各エントリは CDC テーブルに対応しています（これは、Source to Raw table で指定されたエンティティに対応しています）。

次のパラメータは、各エントリの Raw to CDC の設定を制御します。

レポート設定

レポート設定ファイル src/TikTok/config/reporting_settings.yaml を使用して、Cortex Framework が TikTok 最終レポートレイヤ用にデータを生成する方法を構成して制御します。このファイルは、レポートレイヤの BigQuery オブジェクト（テーブル、ビュー、関数、ストアド プロシージャ）の生成方法を制御します。

詳細については、レポート設定ファイルのカスタマイズをご覧ください。

次のステップ

• その他のデータソースとワークロードの詳細については、データソースとワークロードをご覧ください。
• 本番環境にデプロイする手順の詳細については、Cortex Framework Data Foundation のデプロイの前提条件をご覧ください。