メインコンテンツまでスキップ

TikTok 広告コネクタリファレンス

備考

ベータ版

この機能はベータ版です。

この記事では、サポートされているテーブル、ディメンション、メトリクスなど、TikTok Ads コネクタの参考情報を提供します。

サポートされているソーステーブル​

TikTok Ads コネクタは、次のソース テーブルをサポートしています。

広告主スコープのテーブルの場合は、source_schema を TikTok 広告主 ID に設定します。business_center に対して、 source_schema を defaultに設定します。

増分更新をサポートするテーブル​

次のレポート・テーブルは増分インジェストをサポートしています:

  • campaign_report_daily
  • campaign_report_hourly
  • adgroup_report_daily
  • adgroup_report_hourly
  • ad_report_daily
  • ad_report_hourly
  • campaign_age_gender_report
  • campaign_country_report
  • campaign_language_report
  • campaign_platform_report
  • ad_age_gender_report
  • ad_country_report
  • ad_language_report
  • ad_platform_report
  • custom_report query_lifetime の場合 false

バッチ更新のみをサポートするテーブル(非増分)​

パイプラインの更新ごとに次のテーブルが更新されます。

  • campaign
  • ad_group
  • ad
  • business_center
  • campaign_report_lifetime
  • adgroup_report_lifetime
  • ad_report_lifetime
  • custom_report query_lifetime の場合 true

作成済みのレポート​

事前構築済みレポートは、一般的なレポート要件に対応する固定されたディメンションとメトリクスを備えた、事前構成済みのレポート クエリーです。

レポート(source_table)

ディメンション

データレベル

レポートの種類

campaign_report_daily

campaign_id, stat_time_day

AUCTION_CAMPAIGN

BASIC

campaign_report_hourly

campaign_id, stat_time_hour

AUCTION_CAMPAIGN

BASIC

campaign_report_lifetime

campaign_id

AUCTION_CAMPAIGN

BASIC

adgroup_report_daily

adgroup_id, stat_time_day

AUCTION_ADGROUP

BASIC

adgroup_report_hourly

adgroup_id, stat_time_hour

AUCTION_ADGROUP

BASIC

adgroup_report_lifetime

adgroup_id

AUCTION_ADGROUP

BASIC

ad_report_daily

ad_id, stat_time_day

AUCTION_AD

BASIC

ad_report_hourly

ad_id, stat_time_hour

AUCTION_AD

BASIC

ad_report_lifetime

ad_id

AUCTION_AD

BASIC

campaign_age_gender_report

campaign_id、stat_time_day、age、 gender

AUCTION_CAMPAIGN

AUDIENCE

campaign_country_report

campaign_id、stat_time_day、 country_code

AUCTION_CAMPAIGN

AUDIENCE

campaign_language_report

campaign_id、stat_time_day、 language

AUCTION_CAMPAIGN

AUDIENCE

campaign_platform_report

campaign_id、stat_time_day、 platform

AUCTION_CAMPAIGN

AUDIENCE

ad_age_gender_report

ad_id、stat_time_day、age、 gender

AUCTION_AD

AUDIENCE

ad_country_report

ad_id、stat_time_day、 country_code

AUCTION_AD

AUDIENCE

ad_language_report

ad_id、stat_time_day、 language

AUCTION_AD

AUDIENCE

ad_platform_report

ad_id、stat_time_day、 platform

AUCTION_AD

AUDIENCE

レポート(source_table)

ディメンション

データレベル

レポートの種類

campaign_report_daily

campaign_id, stat_time_day

AUCTION_CAMPAIGN

BASIC

campaign_report_hourly

campaign_id, stat_time_hour

AUCTION_CAMPAIGN

BASIC

campaign_report_lifetime

campaign_id

AUCTION_CAMPAIGN

BASIC

adgroup_report_daily

adgroup_id, stat_time_day

AUCTION_ADGROUP

BASIC

adgroup_report_hourly

adgroup_id, stat_time_hour

AUCTION_ADGROUP

BASIC

adgroup_report_lifetime

adgroup_id

AUCTION_ADGROUP

BASIC

ad_report_daily

ad_id, stat_time_day

AUCTION_AD

BASIC

ad_report_hourly

ad_id, stat_time_hour

AUCTION_AD

BASIC

ad_report_lifetime

ad_id

AUCTION_AD

BASIC

campaign_age_gender_report

campaign_id、stat_time_day、age、 gender

AUCTION_CAMPAIGN

AUDIENCE

campaign_country_report

campaign_id、stat_time_day、 country_code

AUCTION_CAMPAIGN

AUDIENCE

campaign_language_report

campaign_id、stat_time_day、 language

AUCTION_CAMPAIGN

AUDIENCE

campaign_platform_report

campaign_id、stat_time_day、 platform

AUCTION_CAMPAIGN

AUDIENCE

ad_age_gender_report

ad_id、stat_time_day、age、 gender

AUCTION_AD

AUDIENCE

ad_country_report

ad_id、stat_time_day、 country_code

AUCTION_AD

AUDIENCE

ad_language_report

ad_id、stat_time_day、 language

AUCTION_AD

AUDIENCE

ad_platform_report

ad_id、stat_time_day、 platform

AUCTION_AD

AUDIENCE

メトリクスグループ​

各事前構築済みレポートに対して返されるメトリクスは、そのレポートタイプによって異なります。

「**BASIC レポート**」は次のメトリクスを返します。

グループ

メトリクス

コアのパフォーマンス

spend、impressions、clicks、cpc、cpm、ctr、reach、cost_per_1000_reached、 frequency

動画再生

video_play_actions、video_watched_2s、video_watched_6s、video_views_p25、video_views_p50、video_views_p75、video_views_p100、average_video_play、 average_video_play_per_user

エンゲージメント

likes、comments、shares、follows、profile_visits、 profile_visits_rate

アトリビューション

conversion、cost_per_conversion、conversion_rate、real_time_conversion、real_time_cost_per_conversion、real_time_conversion_rate、 total_complete_payment_rate

アプリ内イベント

app_install、cost_per_app_install、registration、cost_per_registration、purchase、cost_per_purchase、app_event_add_to_cart、cost_per_app_event_add_to_cart、checkout、 cost_per_checkout

ページイベント

page_event_search、cost_per_page_event_search、complete_payment、 cost_per_complete_payment

TikTok Shop イベント

product_details_page_browse、initiate_checkout、live_views、 live_product_clicks

SKAdNetwork(SKAN)

skan_conversion、skan_cost_per_conversion、skan_app_install、skan_cost_per_app_install、skan_purchase、skan_cost_per_purchase、skan_registration、 skan_cost_per_registration

グループ

メトリクス

コアのパフォーマンス

spend、impressions、clicks、cpc、cpm、ctr、reach、cost_per_1000_reached、 frequency

動画再生

video_play_actions、video_watched_2s、video_watched_6s、video_views_p25、video_views_p50、video_views_p75、video_views_p100、average_video_play、 average_video_play_per_user

エンゲージメント

likes、comments、shares、follows、profile_visits、 profile_visits_rate

アトリビューション

conversion、cost_per_conversion、conversion_rate、real_time_conversion、real_time_cost_per_conversion、real_time_conversion_rate、 total_complete_payment_rate

アプリ内イベント

app_install、cost_per_app_install、registration、cost_per_registration、purchase、cost_per_purchase、app_event_add_to_cart、cost_per_app_event_add_to_cart、checkout、 cost_per_checkout

ページイベント

page_event_search、cost_per_page_event_search、complete_payment、 cost_per_complete_payment

TikTok Shop イベント

product_details_page_browse、initiate_checkout、live_views、 live_product_clicks

SKAdNetwork(SKAN)

skan_conversion、skan_cost_per_conversion、skan_app_install、skan_cost_per_app_install、skan_purchase、skan_cost_per_purchase、skan_registration、 skan_cost_per_registration

SKAdNetwork(SKAN)メトリクスは、日次およびライフタイムのBASICレポートで返されますが、時間次レポートでは返されません。

オーディエンス レポート は、次のメトリクスを返します:

グループ

メトリクス

コアのパフォーマンス

spend、impressions、clicks、cpm、cpc、ctr、conversion、cost_per_conversion、conversion_rate、conversion_rate_v2、frequency、reach、real_time_conversion、real_time_cost_per_conversion、real_time_conversion_rate、real_time_conversion_rate_v2、result、result_rate、cost_per_result、real_time_result、real_time_cost_per_result、 real_time_result_rate

ページイベント

total_landing_page_view、cost_per_landing_page_view、 landing_page_view_rate

グループ

メトリクス

コアのパフォーマンス

spend、impressions、clicks、cpm、cpc、ctr、conversion、cost_per_conversion、conversion_rate、conversion_rate_v2、frequency、reach、real_time_conversion、real_time_cost_per_conversion、real_time_conversion_rate、real_time_conversion_rate_v2、result、result_rate、cost_per_result、real_time_result、real_time_cost_per_result、 real_time_result_rate

ページイベント

total_landing_page_view、cost_per_landing_page_view、 landing_page_view_rate

カスタム レポート​

事前構築済みレポートに加えて、パイプライン仕様でsource_tableをcustom_reportに設定し、connector_options.tiktok_ads_optionsの下でcustom_report_optionsを指定することにより、カスタムレポートを作成できます。

JSON
{
"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 フィールド​

フィールド

説明

dimensions

含めるディメンションのリスト(例:["stat_time_day", "ad_id"])。

metrics

返すメトリクスフィールドのリスト。

report_type

レポートタイプ:BASICまたはAUDIENCE。

data_level

集計レベル:AUCTION_CAMPAIGN、AUCTION_ADGROUP、またはAUCTION_AD。

query_lifetime

trueの場合、日付範囲なしでライフタイム合計を返します。defaultはfalseです。

フィールド

説明

dimensions

含めるディメンションのリスト(例:["stat_time_day", "ad_id"])。

metrics

返すメトリクスフィールドのリスト。

report_type

レポートタイプ:BASICまたはAUDIENCE。

data_level

集計レベル:AUCTION_CAMPAIGN、AUCTION_ADGROUP、またはAUCTION_AD。

query_lifetime

trueの場合、日付範囲なしでライフタイム合計を返します。defaultはfalseです。

カスタムレポートには、次の要件があります。

  • 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 で、次のオプションを構成できます。

フィールド

説明

sync_start_date

取り込みを開始する日付(YYYY-MM-DD形式)。日付に将来の日付を指定することはできません。このオプションは、初期同期にのみ影響します。省略した場合、日次レポートとオーディエンスレポートは過去730日分を取り込み、時間単位のレポートは過去365日分を取り込みます。

lookback_window_days

増分更新中に再読み込みする直近の日数。7 から 365 までの範囲です。defaultは7です。このウィンドウを再読み込みすると、遅延したアトリビューションと更新されたメトリクスがキャプチャされます。

フィールド

説明

sync_start_date

取り込みを開始する日付(YYYY-MM-DD形式)。日付に将来の日付を指定することはできません。このオプションは、初期同期にのみ影響します。省略した場合、日次レポートとオーディエンスレポートは過去730日分を取り込み、時間単位のレポートは過去365日分を取り込みます。

lookback_window_days

増分更新中に再読み込みする直近の日数。7 から 365 までの範囲です。defaultは7です。このウィンドウを再読み込みすると、遅延したアトリビューションと更新されたメトリクスがキャプチャされます。

レポートの日付は、広告主アカウントの固定GMTオフセットを使用します。TikTokの広告主オフセットは、アカウントのタイムゾーンが地域名で表されている場合でも、夏時間に合わせて変更されることはありません。