Singular が TikTok For Business から広告コストデータを取得し、レポートに表示する方法をご説明します。Singular のダッシュボードでは、TikTok For Business のソースは TikTok Ads と表示されます。
概要情報
| データコネクタテクノロジー |
API (TikTok marketing API v. 1.3) |
| データの内訳（セグメンテーション） |
データは次のディメンションで分類されます:
国の内訳を使用しない場合、単一ターゲティングのキャンペーンには国の値が表示されますが、複数ターゲティングのキャンペーンは、アトリビューションデータに基づいて推定できない限り "N/A" と表示されます。 推定データは TikTok のデータと一致しない場合があります。次を参照してください: 「国別のコストはどのように計算されますか？」 |
| データの取得期間 | 7日間 |
| タイムゾーン | TikTok でアカウントに設定されているタイムゾーン |
| データはクリエイティブ（広告）レベルで利用できますか？ | はい |
| Singularはクリエイティブアセットを表示しますか？ | はい |
データマッピング
ヒント: Singular レポートの各フィールドの詳細については、次を参照してください: 指標とディメンションの用語集。また、TikTok のキャンペーン機能とレポート API フィールドのマッピングは こちらをご覧ください。
| Field in Singular UI | Field in Singular API | Field in TikTok API |
|---|---|---|
| Dimensions | ||
| Account ID | adn_account_id | (Taken from [advertiser/info]) |
| Account Name | adn_account_name | advertiser_name |
| App | app | app_name |
| App Site ID | app_site_id | (Taken from the [app_download_url]) |
| Bid Type | bid_type | bid_type |
| Campaign Objective | campaign_objective | objective_type |
| Campaign Status | campaign_status | opt_status |
| Campaign URL | adn_campaign_url | landing_page_url |
| Country | country_field | location |
| Date | date_field | stat_time_day |
| DMA ID | dma_id_field | dma.id |
| DMA Name | dma_name_field | dma.name |
| Network Campaign ID | adn_campaign_id | campaign_id |
| Network Campaign Name | adn_campaign_name | campaign_name |
| Network Creative ID | adn_creative_id | ad_id |
| Network Creative Name | adn_creative_name | ad_name |
| Network Sub Campaign ID | adn_sub_campaign_id | adgroup_id |
| Network Sub Campaign Name | adn_sub_campaign_name | adgroup_name |
| Original Bid Amount | original_bid_amount | bid |
| Original Bid Currency | original_metadata_currency | currency |
| Platform | platform |
|
| Public Id | site_public_id | mobile_app_id |
|
Region |
region_field |
region.name (State or Province; displayed if sub-campaign targets a single region) |
| Standardized Bid Type | standardized_bid_strategy | optimize_goal |
| Timezone | adn_timezone | timezone |
| Text | creative_text | ad_text |
| TikTok - Campaign Automation Type | tiktok_campaign_automation_type | campaign_automation_type |
| TikTok - SmartPlus Ad ID | tiktok_smartplus_ad_id | ad_id_v2 / smart_plus_ad_id |
| TikTok - SmartPlus Ad Name | tiktok_smartplus_ad_name | ad_id_v2 / smart_plus_ad_id |
| TikTok - Post ID | tiktok_post_id | post_id |
| Age | age | age |
| Gender | gender | gender |
| Metrics | ||
| Comments | comments | comments |
| Likes | likes | likes |
| Network Clicks | adn_clicks | clicks |
| Network Impressions | adn_impressions | impressions |
| Network Installs | adn_installs |
real_time_conversion (backup option: app_installs)
Note: If |
| Original Cost | adn_original_cost | stat_cost |
| Original Currency | adn_original_currency | currency |
|
Page Follows |
page_follows | follows |
|
Shares |
shares | shares |
| Video Views | video_views | total_play |
| Video Views - 25% | video_views_25pct | play_first_quartile |
| Video Views - 50% | video_views_50pct | play_midpoint |
| Video Views - 75% | video_views_75pct | play_third_quartile |
| Completed Video Views | completed_video_views | play_over |
Singular はこのパートナーのキャンペーンプロパティの取得にも対応しています。詳細は こちらをご覧ください。
設定手順
設定ステップ
TikTok For Business のデータコネクタを設定するには:
-
Singular アカウントで、次に移動します: Settings > Data Connectors。
-
Add New Connector をクリックし、"TikTok" と入力し始めます。表示されるリストから "TikTok Ads" を選択します。
-
開いた設定ウィンドウで、 Sign In with TikTok をクリックし、TikTok For Business アカウントにログインします。
-
TikTok プラットフォームで、Singular に TikTok データへのアクセス権限を付与するか確認されます。 Agree to the Platform Service Agreement チェックボックスをオンにして、 Confirmをクリックします。
- 権限を付与すると、Singular の設定ウィンドウに接続済みであることが表示されます。ウィンドウは閉じてかまいません。
-
TikTok がデータコネクタの一覧に表示されます。Singular が最初のデータ取得を実行している間、データコネクタのステータスは "Pending" です。最初のデータ取得が完了すると、ステータスは "Active" に変わります。
-
データコネクタが Singular へのデータ取得に成功すると、TikTok のデータを含むレポートを実行できるようになります。詳細については、 レポート FAQ、 Singular API リファレンス、または Singular データデスティネーション FAQを参照してください。
サンプルレポート:
追加の指標（コンバージョンイベント）
Singular は次から指標を取得します: TikTok For Business の指標リスト。デフォルトでは、通常のイベントは "in-app events metrics" セクションから、 SKAdNetwork イベントはリストの "Supported SKAN Metrics" セクションから取得されます。これらに加えて、Singular でコンバージョンイベントを作成することで任意の指標を取得できます。
コンバージョンイベントを作成するには:
- Singular で Settings > Eventsに移動します。 Custom Events と Conversion Events の両方のタブがある場合は、 Conversion Eventsを選択します。
- New Eventをクリックします。
-
TikTok Ads のドロップダウンから、目的の指標を選択します。
翌日、Singular がアカウントの日次データを取得する際に、完了数も併せて取得します。
- 新しいイベントにデータが入力されたら、 Reports ページでレポートを実行し、 Events ドロップダウンから作成したコンバージョンイベントを選択します。
TikTok Upgraded Smart+ キャンペーン
TikTok が自動化スイートを進化させるのに伴い、Singular はレポート機能を更新し、 Upgraded Smart+ キャンペーン構造を完全に可視化できるようにしています。TikTok は Smart Campaigns （まもなく提供終了予定）から Upgraded Smart+ モデルへ移行しています。
この更新の主な目的は、これらの新しい自動化タイプ全体で、詳細なデータと統合されたデータのバランスを提供することです。
何が変わりますか？
この移行に対応するため、2026年3月より以下のレポートフィールドを追加します:
- TikTok - Campaign Automation: このフィールドは使用されている自動化ロジックを識別し、キャンペーンを Manual、 Smart、または Upgraded Smart+のいずれかに分類します。
- TikTok - Upgraded Smart+ Ad ID & Name: これらのフィールドは、クリエイティブのすぐ上に位置する新しいレポート階層を表します。この階層は複数のクリエイティブを格納するコンテナとして機能します。
注: Upgraded Smart+ Ad ID と Name は ネットワーク側のフィールドのみです。これにより新しい構造階層が追加されますが、 クリエイティブデータ は総合的なパフォーマンストラッキングを確保するため、引き続き統合されます。