できること

KARTE Signalsでは、TikTok events APIを使用して TikTok広告のコンバージョン補完を実施することができます。ここではその連携方法について説明します。

事前準備

下記の事前準備を完了していることをご確認ください。
1.　 KARTE計測タグの設置
2.　 個人情報を広告媒体に送信する際の事前設定
3.　 コンバージョンの重複除外処理（推奨）
4.　 ピクセルIDの確認方法

広告APIの設定

  • その他の機能 > 広告API > 追加 から、TikTok Events APIを選択します。
  • 名前、説明は、適宜修正してください。
  • 認証トークンの「取得」ボタンを押してください。
  • 連携済みステータスになったことを確認して、「保存」ボタンを押してください。

コネクタの設定

1.テンプレートの選択

  • コネクタ > 作成 > テンプレートを選択 から、**TikTok Events API でコンバージョン補完する(v1)**を選択し、決定ボタンを押してください。

2.送信先の広告API

  • 広告媒体は、「広告APIの設定」で作成したものを選択します。
  • メールアドレスハッシュ済、電話番号ハッシュ済、外部IDハッシュ済
    • KARTEに既にハッシュ化された個人情報データを連携している場合に利用します。
    • ハッシュ化のルールが媒体側の規定に沿っているか確認してください。
  • 事前準備で取得したピクセルコードを入力します。

3.配信パラメータ

下記を参考に、配信パラメータを設定してください。

パラメーター名説明
TikTokのイベント名今回補完するイベント名を指定してください。
製品タイプ媒体に送る製品タイプ
商品IDを送信する場合は、「製品」を選択してください。
◯時間前までのデータを利用する媒体に送信するデータを作成するための期間を抽出します。
現在から[入力された時間]前までの期間が抽出されます。24時間以内に送信することを推奨します。
個人情報のハッシュ化独自に個人情報データをハッシュ対応している場合は、「個人情報をハッシュ化している」を選択してください。
広告接触から対象イベントまでの日数アトリビューションウィンドウです。
広告接触から[入力された日数]以内であれば対象イベントを送信します。

4.利用するデータ

コンバージョンデータ

  • TikTok広告に送信するコンバージョンデータを抽出します。
  • 利用するデータ
    • KARTEデータ/イベントデータを選択してください。
  • KARTEイベント
    • コンバージョン補完に利用するKARTEイベントを選択してください。
  • 必要に応じて、カラムマッピング、データを絞り込みを実施してください。
  • 保存ボタンを押すと、利用するデータのサンプルが表示されますので、意図通りのデータが抽出できているか確認してください。
    フィールド名必須推奨説明
    user_id○ユーザーID
    KARTEのuser_idを選択してください
    transaction_id○イベントの重複除外用ID
    重複除外設定で送信した項目を選択してください
    sync_date○※自動で取得されるため、変更不要です。
    revenueコンバージョン値
    値を送りたい場合に、選択してください。
    items製品IDと製品に関する情報
    イベントの付加的な情報を送りたい場合に、選択してください。
    session_id○※自動で取得されるため、変更不要です。
    pv_id○※自動で取得されるため、変更不要です。
    store_idショップID
    値を送りたい場合に、選択してください。
    currency通貨コード
    JPY以外を送りたい場合に、選択してください。

ttclid（クリックID）

  • TikTok広告に送信するttclid（クリックID）のデータを抽出します。
  • 作成ボタンを押したのち、何も変更せずに保存ボタンを押してください。

ttp（ブラウザーID）

  • TikTok広告に送信するttp（ブラウザーID）のデータを抽出します。
  • 作成ボタンを押したのち、何も変更せずに保存ボタンを押してください。

IPアドレス/ユーザーエージェント

  • TikTok広告に送信するIPアドレス/ユーザーエージェントのデータを抽出します。
  • 作成ボタンを押したのち、何も変更せずに保存ボタンを押してください。

個人情報データ

  • TikTok広告に送信する個人情報データを抽出します。
  • 利用するデータ
    • identifyイベントで個人情報データを取得している場合は、KARTEデータ/ユーザーマスタを選択してください。
    • 外部から連携している場合は、外部データから該当のデータを選択してください。
  • 必要に応じて、カラムマッピング、データを絞り込みを実施してください。
  • 保存ボタンを押すと、利用するデータのサンプルが表示されますので、意図通りのデータが抽出できているか確認してください。
    フィールド名必須推奨説明
    user_id○ユーザーID
    KARTEのuser_idを選択してください
    email○メールアドレス
    phone○電話番号
    first_name※Tiktokへの連携には使用しないため、設定不要です
    last_name※Tiktokへの連携には使用しないため、設定不要です
    gender※Tiktokへの連携には使用しないため、設定不要です
    birthday※Tiktokへの連携には使用しないため、設定不要です
    pref※Tiktokへの連携には使用しないため、設定不要です
    city※Tiktokへの連携には使用しないため、設定不要です
    zip_code※Tiktokへの連携には使用しないため、設定不要です
    country※Tiktokへの連携には使用しないため、設定不要です
    street_address※Tiktokへの連携には使用しないため、設定不要です

5.送信スケジュール

  • 定期的に連携する場合は、繰り返し実行の有効にするにチェックを入れて、実行間隔を設定してください。
  • 利用するデータで外部データを利用している場合は、その連携頻度/連携時間に合わせて設定してください。
  • ユーザーマスタを利用する場合は、送信スケジュールを「50分」に指定してください。

6.送信

  • 下書き保存ボタンをクリックした後、データを取得ボタンを押すと、実際に連携される件数とデータが確認できます。
  • 確認して問題なければ、送信ボタンを押してください。

送信確認