最終更新日 : 2023/12/26

TiKTokAPI連携の設定方法

1.連携までの流れ

①TikTok広告マネージャーより、[ピクセルID]・[アクセストークン]・[イベント名]を取得する

②AFADの管理画面に取得情報を設定する

③記事LPを利用する場合は[グループ計測タグ]を設置する

④APIとピクセルタグを併用する場合は、重複除外対策を行う

⑤テストを行う

⑥良くある質問

2.用意して頂きたい情報

以下の情報をTiktok広告マネージャーより取得してください。
①ピクセルID ②アクセストークン ③イベント名

☆取得方法
①ピクセルID
 TikTok広告マネージャー ツール>イベント>イベント名下部>ID より取得頂けます。

Tiktok_AFAD_1.png

②アクセストークン
ツール>イベント>イベント名押下>設定>アクセストークンを作成 を押下すると取得頂けます

tiktok2.png

③イベント名
ツール>イベント>イベント名押下>概要 より、イベント名を閲覧頂けます

tiktok3.png

3.AFAD管理画面に取得情報を設定する

AFAD管理画面 パートナー管理>パートナーサイト登録 / 一覧>利用API 『TikTok』 をクリックします。

tiktok_AFAD_2.png

イベントの発火を行います
 *広告セットを行うために「イベントの有効化」が必須となります。
  作成したイベントは有効化しないと広告セットが出来ないため、弊社の有効化機能をご利用ください
  (既に運用開始されている方は不要です)

ログ集計>TikTokコンバージョンログ>通知>各情報を記入>リクエストを送信

Tiktok_AFAD_3.png

4.記事LPをご利用の場合

(記事LPをご利用でない場合は5へお進みください)
*TikTokが発行するセッションIDを記事内で引き継ぐ必要があります。
  必ず記事内にAFADのグループ計測タグを設置ください。

Tiktok_AFAD_4.png

● タグ管理>グループ計測タグ>コピー より取得いただけます

Tiktok_AFAD_5.png

5.重複除外対策

*ピクセルと弊社APIを併用される場合は、それぞれでCVをするため多重発火となります。
  そのため、片方の成果を除外する『重複除外設定』が必須になります。
  (弊社APIのみをご利用の場合は、不要になりますので、6へお進みください)

① ピクセルに追記が必要です
   , {eventID: '注文番号'});; を下図のように追記ください

Tiktok_4.png

② グループ成果タグの書き換え(タグ連携の場合)
 タグ管理>グループ成果タグ>JSタグ コピー よりグループ成果タグを取得します
 *既存でお使いになられているお客様もタグの記述が変わりますので再度成果タグを取得してください
 下図の様に&ttEventId=[注文番号]を追記してください

Tiktok_AFAD_7.png
tiktok_AFAD_8.png

③ ポストバックURL(ソケット)の書き換え(ポストバック連携の場合)
 タグ管理>グループ成果タグ>ソケットURL コピー よりポストバックURL(ソケット)を取得します
 下図の様に&ttEventId=[注文番号]を追記してください

Tiktok_AFAD_6.png

6.テスト方法

tiktok_AFAD_9.png

*プレビュー用のQRコード取得方法

メニュー 広告 > 広告タブを選択 > 名前の「 …」>「プレビュー配信を設定」を押下ください

Tiktok_AFAD_10.png

☆成果の確認方法

ログ集計>TikTokコンバージョンログ よりご確認いただけます

ttclid・イベント名が取得できているか、結果が『成功』になっているかご確認ください。

Tiktok_AFAD_11.png

7.注意点

● iOS ATTの仕様により、APIよりイベント通知した場合でも、イベント計測がされない場合が
  ございます。予めご了承ください。
 
● Cookie保存期間を7日間迄 としています。
  通常のクリックログ数に比べてサイズの多いデータとなる事が確認されているため、
  保存期間を現実的なラインで少ない閾値とさせていただいています。

● 現在TikTokAPIは、標準モードのイベント条件「ウェブ要素を追加」には対応しておりません。

● テスト実施する場合、通常「イベントページ プレビュー」に数値がカウントされますが、TikTokアプリのバージョンが低い場合「アトリビューションイベント」にカウントされる場合がございます。

8.良くある質問

Q1. 成果があがらない
A1. エラーログに情報が来ているかご確認ください