セットアップガイド › TikTok Events API (CAPI)
TikTok Events API (CAPI) 設定ガイド
TikTok広告からの友だち追加をコンバージョンとして計測し、広告の最適化精度を高めます。
仕組みの概要：
TikTok広告のクリック時にURLに付与される
TikTok広告のクリック時にURLに付与される
ttclid をLinetraceが自動キャプチャし、友だち追加・LINE内CV発生時にTikTok Events APIへ直接コンバージョンデータを送信します。Step 1｜TikTok Business Center でイベント Pixel を作成
- TikTok Business Center にログイン
- 「アセット」→「イベント」を開き、「ウェブイベント」を選択
- Pixel名に「Linetrace」と入力して作成
- 発行された Pixel ID をコピー
注意：Pixel IDは第三者に開示しないでください。Linetraceでは暗号化して保存されます。
Step 2｜Events API のアクセストークンを発行
- TikTok Business Center の「イベント」→ 作成した Pixel を選択
- 「設定」タブ → 「Events API」セクションを開く
- 「アクセストークンを生成」をクリック
- 表示された Access Token をコピー
アクセストークンは 長期トークン を推奨します。短期トークンの場合は期限切れに注意してください。
Step 3｜Linetraceに設定を入力する
- Linetraceダッシュボード右上の「設定」→「TikTok広告にCVを返したい」→ Step 3 から TikTok Events API (CAPI) 設定 を開く
- Step 1で取得した Pixel ID を入力
- Step 2で取得した Access Token を入力
- 「TikTok CAPI を有効にする」トグルをONにして「設定を保存」をクリック
Step 4｜動作を確認する
- TikTok Ads Manager の「イベント」→ 該当 Pixel → 「テストイベント」タブを開く
- 表示された Test Event Code をコピーし、Linetraceダッシュボードの TikTok CAPI 設定画面に入力
- TikTok広告で配信中の広告をクリックしてLPに遷移（URLに
?ttclid=...が付くことを確認） - LP上でLINE友だち追加を実行
- TikTok Ads Manager の「テストイベント」画面でイベントが受信されていることを確認
- 確認後、Test Event Code を空欄に戻して保存（本番計測に切り替え）
注意：Test Event Code を入力したままだと本番のコンバージョン計測には反映されません。動作確認後は必ず空欄に戻してください。
よくあるご質問
Q. ttclid がURLに付かない場合は？
TikTok Ads Manager の自動タグ付与設定を確認してください。キャンペーン設定または広告グループ設定で、クリックURL への自動パラメータ付与が有効になっているか確認します。
Q. Access Token の期限は？
長期トークンの利用を推奨します。短期トークンを使用している場合は、期限切れ前にTikTok Business Center で再発行し、Linetraceダッシュボードで更新してください。
Q. LINE 内 CV / WebCV も同じ Pixel？
はい、同じ Pixel ID で計測できます。友だち追加・LINE内CV・WebCV は event_name で区別されます（デフォルトではすべて Lead として送信）。
参考：TikTok Events API の詳細は TikTok Events API 公式ドキュメント をご確認ください。
設定完了
これでTikTok広告のコンバージョン計測が有効になりました。友だち追加・LINE内CVが発生するとTikTok Events APIにコンバージョンデータが自動送信されます。