メインコンテンツまでスキップ
に最終更新

TikTok広告からデータを取り込む

備考

ベータ版

この機能はベータ版です。ワークスペース管理者は、 プレビュー ページからこの機能へのアクセスを制御できます。「Databricks プレビューの管理」を参照してください。

このページでは、 LakeFlow Connectを使用してマネージド TikTok Ads 取り込みパイプラインを作成する方法を説明します。

要件​

  • 取り込みパイプラインを作成するには、まず次の要件を満たす必要があります。

    • ワークスペースでUnity Catalogが有効になっている必要があります。

    • ワークスペースでサーバレスコンピュートを有効にする必要があります。 「サーバレス コンピュート要件」を参照してください。

    • 新しい接続を作成する場合：メタストアに対してCREATE CONNECTION権限が必要です。Unity Catalogの「権限の管理」を参照してください。

      コネクタが UI ベースのパイプライン オーサリングをサポートしている場合、管理者はこのページのステップを完了することで、接続とパイプラインを同時に作成できます。 ただし、パイプラインを作成するユーザーが API ベースのパイプライン オーサリングを使用している場合、または管理者以外のユーザーである場合、管理者はまずカタログ エクスプローラーで接続を作成する必要があります。 「管理対象取り込みソースへの接続」を参照してください。

    • 既存の接続を使用する場合: 接続オブジェクトに対するUSE CONNECTION権限またはALL PRIVILEGESが必要です。

    • ターゲット カタログに対するUSE CATALOG権限が必要です。

    • 既存のスキーマに対するUSE SCHEMAおよびCREATE TABLE権限、またはターゲット カタログに対するCREATE SCHEMA権限が必要です。

  • TikTok Ads から取り込むには、まず Databricks からの認証を構成する必要があります。管理された取り込みのために TikTok 広告を構成するを参照してください。

取り込みパイプラインを作成する​

宣言型自動化バンドルを使用して、TikTok広告パイプラインをコードとして管理します。バンドルにはジョブとタスクの YAML 定義を含めることができ、 Databricks CLIを使用して管理でき、さまざまなターゲット ワークスペース (開発、ステージング、本番運用など) で共有して実行できます。 詳細については、 「宣言的オートメーション バンドルとは何ですか?」を参照してください。 。

  1. Databricks CLIを使用してバンドルを作成します。

    Bash
    databricks bundle init

  2. バンドルに 2 つの新しいリソース ファイルを追加します。

    • パイプライン定義ファイル (例: resources/tiktok_ads_pipeline.yml )。パイプライン.ingestion_定義を参照してください。 および例。
    • データ取り込みの頻度を制御するジョブ定義ファイル (例: resources/tiktok_ads_job.yml )。

  3. Databricks CLI を使用してパイプラインをデプロイします。

    Bash
    databricks bundle deploy

例​

宣言型自動化バンドルのデプロイには、パイプライン定義ファイルとジョブ定義ファイルに以下のテンプレートを使用してください。

パイプライン定義ファイル​

YAML
resources:
  pipelines:
    tiktok_ads_pipeline:
      name: tiktok_ads_pipeline
      catalog: 'main'
      target: 'tiktok_ads_data'
      ingestion_definition:
        connection_name: tiktok_ads_connection
        objects:
          - table:
              source_schema: '<your_advertiser_id>'
              source_table: 'campaign_report_daily'
              destination_catalog: 'main'
              destination_schema: 'tiktok_ads_data'
              destination_table: 'campaign_report_daily'

宣言型自動化バンドルのジョブ定義ファイル​

YAML
resources:
  jobs:
    tiktok_ads_job:
      name: tiktok_ads_job
      schedule:
        quartz_cron_expression: '0 0 0 * * ?'
        timezone_id: 'UTC'
      tasks:
        - task_key: tiktok_ads_ingestion
          pipeline_task:
            pipeline_id: ${resources.pipelines.tiktok_ads_pipeline.id}

事前構築済みレポートとカスタム レポート​

標準のTikTok Adsオブジェクトに加えて、作成済みのレポートを取り込み、カスタムレポートを定義できます。

作成済みのレポートを取り込む​

source_table をレポート名に設定します。コネクタは、作成済みのレポートそれぞれに固定スキーマを使用します。

JSON
{
  "ingestion_definition": {
    "connection_name": "<connection-name>",
    "objects": [
      {
        "table": {
          "source_schema": "<your-ad-account-id>",
          "source_table": "ad_report_daily",
          "destination_catalog": "<destination-catalog>",
          "destination_schema": "<destination-schema>"
        }
      }
    ]
  }
}

事前構築済みレポートとそのスキーマの完全なリストについては、事前構築済みレポートを参照してください。

カスタムレポートを取り込む​

source_tableをcustom_reportに設定し、connector_options.tiktok_ads_optionsの下でcustom_report_optionsを指定します。カスタムレポートにはdestination_tableが必須です。

JSON
{
  "ingestion_definition": {
    "connection_name": "<connection-name>",
    "objects": [
      {
        "table": {
          "source_schema": "<your-ad-account-id>",
          "source_table": "custom_report",
          "destination_catalog": "<destination-catalog>",
          "destination_schema": "<destination-schema>",
          "destination_table": "my_custom_report",
          "connector_options": {
            "tiktok_ads_options": {
              "lookback_window_days": 7,
              "sync_start_date": "2024-01-01",
              "custom_report_options": {
                "dimensions": ["stat_time_day", "ad_id"],
                "metrics": ["spend", "impressions", "clicks"],
                "report_type": "BASIC",
                "data_level": "AUCTION_AD",
                "query_lifetime": false
              }
            }
          }
        }
      }
    ]
  }
}

custom_report_optionsの詳細については、カスタムレポートを参照してください。

一般的なパターン​

高度なパイプライン構成については、 「管理された取り込みパイプラインの一般的なパターン」を参照してください。

次のステップ​

パイプラインを開始、スケジュールし、アラートを設定します。一般的なパイプラインメンテナンスタスクを参照してください。

その他のリソース​

このページの見出し