TikTok 広告コネクタリファレンス
ベータ版
この機能はベータ版です。
この記事では、サポートされているテーブル、ディメンション、メトリクスなど、TikTok Ads コネクタの参考情報を提供します。
サポートされているソーステーブル
TikTok Ads コネクタは、次のソース テーブルをサポートしています。
広告主スコープのテーブルの場合は、source_schema を TikTok 広告主 ID に設定します。business_center に対して、 source_schema を defaultに設定します。
増分更新をサポートするテーブル
次のレポート・テーブルは増分インジェストをサポートしています:
campaign_report_dailycampaign_report_hourlyadgroup_report_dailyadgroup_report_hourlyad_report_dailyad_report_hourlycampaign_age_gender_reportcampaign_country_reportcampaign_language_reportcampaign_platform_reportad_age_gender_reportad_country_reportad_language_reportad_platform_reportcustom_reportquery_lifetimeの場合false
バッチ更新のみをサポートするテーブル(非増分)
パイプラインの更新ごとに次のテーブルが更新されます。
campaignad_groupadbusiness_centercampaign_report_lifetimeadgroup_report_lifetimead_report_lifetimecustom_reportquery_lifetimeの場合true
作成済みのレポート
事前構築済みレポートは、一般的なレポート要件に対応する固定されたディメンションとメトリクスを備えた、事前構成済みのレポート クエリーです。
レポート( | ディメンション | データレベル | レポートの種類 |
|---|---|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
メトリクスグループ
各事前構築済みレポートに対して返されるメトリクスは、そのレポートタイプによって異なります。
「**BASIC レポート**」は次のメトリクスを返します。
グループ | メトリクス |
|---|---|
コアのパフォーマンス |
|
動画再生 |
|
エンゲージメント |
|
アトリビューション |
|
アプリ内イベント |
|
ページイベント |
|
TikTok Shop イベント |
|
SKAdNetwork(SKAN) |
|
SKAdNetwork(SKAN)メトリクスは、日次およびライフタイムのBASICレポートで返されますが、時間次レポートでは返されません。
オーディエンス レポート は、次のメトリクスを返します:
グループ | メトリクス |
|---|---|
コアのパフォーマンス |
|
ページイベント |
|
カスタム レポート
事前構築済みレポートに加えて、パイプライン仕様でsource_tableをcustom_reportに設定し、connector_options.tiktok_ads_optionsの下でcustom_report_optionsを指定することにより、カスタムレポートを作成できます。
{
"table": {
"source_schema": "<your-ad-account-id>",
"source_table": "custom_report",
"destination_catalog": "<destination-catalog>",
"destination_schema": "<destination-schema>",
"destination_table": "<your-report-name>",
"connector_options": {
"tiktok_ads_options": {
"lookback_window_days": 7,
"sync_start_date": "<YYYY-MM-DD>",
"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 フィールド
フィールド | 説明 |
|---|---|
| 含めるディメンションのリスト(例: |
| 返すメトリクスフィールドのリスト。 |
| レポートタイプ: |
| 集計レベル: |
|
|
カスタムレポートには、次の要件があります。
source_tableがcustom_reportの場合、destination_tableを設定します。カスタムレポートは、テーブル検出では返されないため、明示的に構成する必要があります。dimensionsとmetricsの両方に少なくとも1つの値を指定してください。- 非ライフタイムレポートについては、
dimensionsにstat_time_dayまたはstat_time_hourのいずれかを含めてください。 - ライフタイムカスタムレポートは、パイプラインの更新ごとに完全に更新されます。ライフタイムレポートに
sync_start_dateまたはlookback_window_daysを構成しないでください。
レポート日のオプション
非ライフタイムレポートの connector_options.tiktok_ads_options で、次のオプションを構成できます。
フィールド | 説明 |
|---|---|
| 取り込みを開始する日付( |
| 増分更新中に再読み込みする直近の日数。 |
レポートの日付は、広告主アカウントの固定GMTオフセットを使用します。TikTokの広告主オフセットは、アカウントのタイムゾーンが地域名で表されている場合でも、夏時間に合わせて変更されることはありません。