linetrace
ログイン2週間無料で試す

セットアップガイド › TikTok Events API (CAPI)

TikTok Events API (CAPI) 設定ガイド

TikTok広告からの友だち追加をコンバージョンとして計測し、広告の最適化精度を高めます。

仕組みの概要:
TikTok広告のクリック時にURLに付与される ttclid をLinetraceが自動キャプチャし、友だち追加・LINE内CV発生時にTikTok Events APIへ直接コンバージョンデータを送信します。

Step 1|TikTok広告マネージャーで Pixel ID を確認する

  1. TikTok広告マネージャー にログイン
  2. 「ツール」→「イベントマネージャー」を開く
  3. 一覧から使う Pixel を選ぶ(まだ無い場合は、下の「Pixel を新しく作るとき」を参照)
  4. Pixel ID をコピー(英数字20文字ほど。Pixel の画面の上に「ピクセルID」として出ています)

Pixel の画面には「概要」「テストイベント」「診断」「変更履歴」「設定」のタブがあります。このマニュアルでは Step 2 で「設定」、Step 4 で「テストイベント」を使います。

Pixel を新しく作るとき

イベントマネージャーで Pixel を新しく作ると、次の7段階の画面が順に出ます。Linetrace はサーバーから TikTok に送るので、ここで迷いやすいところだけ書きます。

  1. ベースコードをインストールする:サイトに貼る TikTok のタグです。Linetrace の送信には使いません(ほかの目的でサイトに入れるかはご自由です)
  2. 設定を管理する
  3. イベントを設定する
  4. ピクセル設定を確認する
  5. ビジネスファネルを設定する:テンプレート(「Eコマース」など)を選ぶ画面です。Linetrace の送信には影響しないので、どれを選んでもかまいません
  6. イベントAPIを実装する:「1. アクセス根拠の生成」の「アクセス権を作成する」ボタンを押すと、アクセストークン(Step 2 で使うもの)を作れます。翻訳が分かりにくいですが、「アクセストークンを作る」という意味です。ここで作らなくても、あとで Step 2 の手順で作れます
  7. eAPIの設定を確認する
注意:Pixel IDは第三者に開示しないでください。Linetraceでは暗号化して保存されます。

Step 2|Events API のアクセストークンを発行

  1. TikTok広告マネージャーの「ツール」→「イベントマネージャー」→ Step 1 の Pixel を開く
  2. 「設定」タブを開き、一番下の「Events API」へ
  3. 「アクセストークンを生成」をクリック
  4. 表示された Access Token をコピー
アクセストークンは 長期トークン を推奨します。短期トークンの場合は期限切れに注意してください。

Step 3|Linetraceに設定を入力する

  1. Linetraceダッシュボード右上の「設定」→「TikTok広告にCVを返したい」→ Step 3 から TikTok Events API (CAPI) 設定 を開く
  2. Step 1で取得した Pixel ID を入力
  3. Step 2で取得した Access Token を入力
  4. 「TikTok CAPI を有効にする」トグルをONにして「設定を保存」をクリック

Step 4|動作を確認する

  1. TikTok広告マネージャーの「ツール」→「イベントマネージャー」→ Step 1 の Pixel →「テストイベント」タブを開き、Test Event Code をコピー
  2. Linetraceの TikTok Events API (CAPI) 設定画面の 「Test Event Code」 欄に貼り付け、「内容を保存してテスト送信」 をクリック(画面に入力した Pixel ID・Access Token・イベント名なども、このとき一緒に保存されます)
  3. 「テスト送信成功」と表示されたら、TikTok の「テストイベント」タブに 「フォームを送信」(右上に「コード: Lead」)が届いていることを確認。日本語の画面では、標準イベントの Lead が「フォームを送信」と表示されます(イベント名を変えている場合は、その名前で届きます。友だち追加・LINE内CV・LINE経由Web CV の名前が違うときは、名前ごとに1件ずつ届きます)

Test Event Code はそのテスト送信の1回だけに使い、Linetrace には保存しません。テストのあとに欄を空にする必要はありません。

実際の広告から友だち追加があったときの送信には、Test Event Code は付きません。そのため実際の友だち追加は「テストイベント」タブではなく、通常のイベントとして届きます。広告のクリックで LP に来たとき、URL に ?ttclid=... が付いていると TikTok に送られます。

連携を止める(一時停止)

広告を出さない月などは、Linetrace から送るのを止められます。

  1. Linetraceダッシュボード右上の「設定」→「TikTok広告にCVを返したい」→「TikTok CAPI 設定画面を開く」を押す
  2. 画面の上の「TikTok CAPI:稼働中」の横にある「一時停止」を押す(「TikTok CAPI を有効にする」をオンにして保存していると表示されます)
  3. 確認が出たら「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 の上では区別できません。分けたいときは、それぞれ別の標準イベントにしてください。おすすめは次のとおりです。

どれも TikTok のヘルプでリード獲得の目的に使えるとされている標準イベントです。Linetrace の設定画面では、標準イベントを入れるとイベント名の欄の下に「最適化イベントに使えます」と出ます。「内容を保存してテスト送信」を押すと、名前の違うイベントを1件ずつ送るので、3つとも TikTok に届くかを「テストイベント」タブで確かめられます。広告グループで選べるイベントは、キャンペーンの目的によって変わります。

参考:TikTok 広告ヘルプ「標準イベント」「カスタムイベント」

参考:TikTok Events API の詳細は TikTok Events API 公式ドキュメント をご確認ください。

設定完了

これでTikTok広告のコンバージョン計測が有効になりました。友だち追加・LINE内CVが発生するとTikTok Events APIにコンバージョンデータが自動送信されます。

← セットアップガイドに戻る

まずは2週間無料で試す

クレジットカード不要・GTMタグ1行 / 約10分・いつでも解約可

2週間無料で試す料金を見る