セットアップガイド › TikTok Events API (CAPI)
TikTok Events API (CAPI) 設定ガイド
TikTok広告からの友だち追加をコンバージョンとして計測し、広告の最適化精度を高めます。
TikTok広告のクリック時にURLに付与される
ttclid をLinetraceが自動キャプチャし、友だち追加・LINE内CV発生時にTikTok Events APIへ直接コンバージョンデータを送信します。Step 1|TikTok広告マネージャーで Pixel ID を確認する
- TikTok広告マネージャー にログイン
- 「ツール」→「イベントマネージャー」を開く
- 一覧から使う Pixel を選ぶ(まだ無い場合は、下の「Pixel を新しく作るとき」を参照)
- Pixel ID をコピー(英数字20文字ほど。Pixel の画面の上に「ピクセルID」として出ています)
Pixel の画面には「概要」「テストイベント」「診断」「変更履歴」「設定」のタブがあります。このマニュアルでは Step 2 で「設定」、Step 4 で「テストイベント」を使います。
Pixel を新しく作るとき
イベントマネージャーで Pixel を新しく作ると、次の7段階の画面が順に出ます。Linetrace はサーバーから TikTok に送るので、ここで迷いやすいところだけ書きます。
- ベースコードをインストールする:サイトに貼る TikTok のタグです。Linetrace の送信には使いません(ほかの目的でサイトに入れるかはご自由です)
- 設定を管理する
- イベントを設定する
- ピクセル設定を確認する
- ビジネスファネルを設定する:テンプレート(「Eコマース」など)を選ぶ画面です。Linetrace の送信には影響しないので、どれを選んでもかまいません
- イベントAPIを実装する:「1. アクセス根拠の生成」の「アクセス権を作成する」ボタンを押すと、アクセストークン(Step 2 で使うもの)を作れます。翻訳が分かりにくいですが、「アクセストークンを作る」という意味です。ここで作らなくても、あとで Step 2 の手順で作れます
- eAPIの設定を確認する
Step 2|Events API のアクセストークンを発行
- TikTok広告マネージャーの「ツール」→「イベントマネージャー」→ Step 1 の 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広告マネージャーの「ツール」→「イベントマネージャー」→ Step 1 の Pixel →「テストイベント」タブを開き、Test Event Code をコピー
- Linetraceの TikTok Events API (CAPI) 設定画面の 「Test Event Code」 欄に貼り付け、「内容を保存してテスト送信」 をクリック(画面に入力した Pixel ID・Access Token・イベント名なども、このとき一緒に保存されます)
- 「テスト送信成功」と表示されたら、TikTok の「テストイベント」タブに 「フォームを送信」(右上に「コード: Lead」)が届いていることを確認。日本語の画面では、標準イベントの
Leadが「フォームを送信」と表示されます(イベント名を変えている場合は、その名前で届きます。友だち追加・LINE内CV・LINE経由Web CV の名前が違うときは、名前ごとに1件ずつ届きます)
Test Event Code はそのテスト送信の1回だけに使い、Linetrace には保存しません。テストのあとに欄を空にする必要はありません。
?ttclid=... が付いていると TikTok に送られます。連携を止める(一時停止)
広告を出さない月などは、Linetrace から送るのを止められます。
- Linetraceダッシュボード右上の「設定」→「TikTok広告にCVを返したい」→「TikTok CAPI 設定画面を開く」を押す
- 画面の上の「TikTok CAPI:稼働中」の横にある「一時停止」を押す(「TikTok CAPI を有効にする」をオンにして保存していると表示されます)
- 確認が出たら「OK」を押します。「TikTok CAPI:一時停止中」に変われば止まっています。再開するときは、同じ場所の「再開する」を押します
一時停止した請求期間の分は次回のご請求に含まれ、その次のご請求から連携費はかかりません(料金・請求の見方)。一時停止中も、計測とダッシュボードの表示は続きます。
よくあるご質問
Q. ttclid がURLに付かない場合は?
TikTok Ads Manager の自動タグ付与設定を確認してください。キャンペーン設定または広告グループ設定で、クリックURL への自動パラメータ付与が有効になっているか確認します。
Q. Access Token の期限は?
長期トークンの利用を推奨します。短期トークンを使用している場合は、期限切れ前にイベントマネージャーの Pixel の「設定」タブで再発行し、Linetraceダッシュボードで更新してください。
Q. LINE 内 CV / WebCV も同じ Pixel?
はい、同じ Pixel ID で計測できます。友だち追加・LINE内CV・WebCV は event_name で区別されます(デフォルトではすべて Lead として送信。日本語の画面では「フォームを送信」と表示されます)。
Q. イベント名を「Lead」以外に変えてもよいですか?
TikTok の標準イベント(Lead・Contact・CompleteRegistration など、TikTok があらかじめ決めている名前)なら、広告の最適化に使えます。それ以外の名前(カスタムイベント。例:LINE_friend)は、広告グループの最適化イベントには選べません(TikTok のレポートやオーディエンスには使えます)。名前は大文字・小文字も合わせて入力してください(「contact」は標準イベントになりません)。カスタムイベントの名前は、英字で始め、英字・数字・「_」「-」だけ(スペース不可・50文字まで)にする決まりがあります。
Q. 友だち追加と LINE内CV を、TikTok で分けて見たい・別々に最適化したいときは?
3つとも「Lead」のままだと、TikTok の上では区別できません。分けたいときは、それぞれ別の標準イベントにしてください。おすすめは次のとおりです。
- 友だち追加:
Lead(日本語の画面では「フォームを送信」) - LINE内CV:
Contact(ヘルプでの日本語名は「お問い合わせ」) - LINE経由Web CV:サイトでの成果に合うもの(申込みなら
SubmitApplication「申請の送信」、会員登録ならCompleteRegistration「登録完了」など)
どれも TikTok のヘルプでリード獲得の目的に使えるとされている標準イベントです。Linetrace の設定画面では、標準イベントを入れるとイベント名の欄の下に「最適化イベントに使えます」と出ます。「内容を保存してテスト送信」を押すと、名前の違うイベントを1件ずつ送るので、3つとも TikTok に届くかを「テストイベント」タブで確かめられます。広告グループで選べるイベントは、キャンペーンの目的によって変わります。
参考:TikTok 広告ヘルプ「標準イベント」「カスタムイベント」
設定完了
これでTikTok広告のコンバージョン計測が有効になりました。友だち追加・LINE内CVが発生するとTikTok Events APIにコンバージョンデータが自動送信されます。