クイック詳細

データコネクタテクノロジー	API (TikTok marketing API v. 1.3)
データの内訳（セグメンテーション）	データは以下のディメンションで分類されます： プラットフォーム（デフォルト） 国 プレースメント DMA 重要：プラットフォーム以外の内訳を使用するには、Singularサポートにお問い合わせください。TikTokのAPIの制限により、キャンペーンレベルで複数のブレイクダウンからデータを引き出すことはできません。 カントリーブレイクダウンを使用しない場合、シングルターゲティングキャンペーンはカントリー値を表示しますが、マルチターゲティングキャンペーンはアトリビューションデータに基づいて推定できない限り「N/A」となります。 推定データはTikTokと同一でない場合があります。"国ごとのコストはどのように計算されますか？" をご覧ください。
データの取得期間	7日間
タイムゾーン	デフォルトではUTC
データはクリエイティブ（広告）レベルで利用できますか？	はい
Singularはクリエイティブアセットを表示しますか？	はい

データマッピング

Singular UIのフィールド	Singular APIのフィールド	TikTok APIのフィールド
ディメンション
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	platform app_type (If platform is empty) operating_system (If both are empty)
Public Id	site_public_id	mobile_app_id
Region	region_field	region.name
Standardized Bid Type	standardized_bid_strategy	optimize_goal
Timezone	adn_timezone	timezone
Text	creative_text	ad_text
Age	age	age
Gender	gender	gender
メトリクス
Average Frequency	frequency	frequency
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)
Original Cost	adn_original_cost	stat_cost
Original Currency	adn_original_currency	currency
Page Follows	page_follows	follows
Reach	reach	reach
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データコネクタをセットアップします：

1. Singularアカウントで、Settings > Data Connectors 。

   

2. Add New Connectorをクリックし、「TikTok」と入力します。表示されるリストから「TikTok Ads」を選択します。

   

3. 開いた設定ウィンドウで、Sign In with TikTokをクリックし、TikTok For Businessアカウントにログインします。

   

4. TikTokプラットフォームが、TikTokデータへのアクセス許可をSingularに付与するかどうかを尋ねます。プラットフォームサービス契約に同意する]チェックボックスをオンにし、[確認]をクリックします。

   

5. 許可を与えると、Singularの設定ウィンドウに接続されたことが表示されます。ウィンドウを閉じることができます。

6. データコネクターのリストにTikTokが表示されるようになりました。Singularが最初のデータプルを実行する間、データコネクタのステータスは「保留中」です。最初のデータ・プルが完了すると、ステータスは「アクティブ」に変わります。

   

7. データコネクタが正常にSingularにデータを取り込んだら、TikTokデータを含むレポートの実行を開始できます。詳細については、レポートFAQ、Singular APIリファレンス、またはSingularデータ送信先FAQをご覧ください。

   サンプルレポート

   

追加メトリクス（コンバージョンイベント）

SingularはTikTok for Businessのメトリクスリストからメトリクスを取得します。 デフォルトでは、通常のイベントは "in-app events metrics "セクションから、SKAdNetworkイベントはリストの "Supported SKAN Metrics "セクションからプルされます。これらに加えて、Singularでコンバージョンイベントを作成することで、任意のメトリックを引き出すことができます。

コンバージョンイベントを作成するには

1. Singularで、設定 > イベントと進みます。カスタムイベントと コンバージョンイベントの両方のタブがある場合は、コンバージョンイベントを選択します。
2. 新規イベントをクリックします。

3. TikTok Adsドロップダウンで、希望するメトリックを選択します。

   翌日、Singularがアカウントのデイリーデータをプルすると、完了数もプルされます。

4. 新しいイベントにデータが入力されたら、レポートページでレポートを実行し、イベントドロップダウンから作成したコンバージョンイベントを選択します。