ご注意ください

この記事は、リニューアル後のKARTE Signalsコネクタに関する内容です。現在ご利用のUIが旧バージョンの場合は、リニューアル前のサポート記事(https://support.karte.io/post/6aeab86c98fcc7700f6c820d )をご確認ください。

できること

KARTE Signalsでは、TikTok Events APIを使用してTikTok広告にオフラインコンバージョンを送信することができます。ここではその連携方法について説明します。

事前準備

下記の事前準備を完了していることをご確認ください

広告APIの設定

その他の機能 > 広告API > 作成から、TikTok Events API を選択します。
名前を入力します。必須です。説明は任意です。
事前準備で用意したTikTok広告アカウントの認証トークンを入力し、接続する を押します。
画面が遷移します。承認を押して、接続を完了させてください。

コネクタの設定

1.目的の選択

目的で 入札最適化 を選びます。テンプレート一覧から、TikTok Events APIにオフラインコンバージョンを送る(v1) を選択してください。一度保存されたテンプレートは変更できません。

2.接続先

広告APIで作成した接続先を選択してください。必須です。未作成の場合は、横の作成から広告APIを作成できます。

オフラインイベントセットIDを設定します。TikTok広告管理画面で作成したイベント名を入力してください。
個人情報をハッシュ済み：使用するデータの個人情報をすでにハッシュ化している場合のみチェックをつけてください。

3.利用するデータ

オフラインコンバージョンデータ と 個人情報データ は、データライブラリで作成したものを選択します。未作成の場合は、横の作成から作成できます。コンバージョンデータの元データは、事前に接続したオフラインデータです。

オフラインコンバージョンデータ

フィールド名	必須	推奨	説明
user_id	○	KARTEのuser_idを選択してください	ユーザーを識別するためのID
transaction_id		トランザクションIDを選択してください	コンバージョンを識別するためのID
sync_date	○	コンバージョンが発生した日付を指定してください	コンバージョンの発生日時
store_id		店舗IDがある場合は選択してください	オフラインの店舗情報
item_id		商品IDがある場合は選択してください	商品を識別するためのID
item_quantity		数量情報がある場合は選択してください	購入した商品の数量
item_price		価格情報がある場合は選択してください	商品の価格
currency		通貨情報がある場合は選択してください	価格の通貨単位
item_name		商品名がある場合は選択してください	商品の名称
item_category		商品カテゴリがある場合は選択してください	商品のカテゴリ情報
item_brand		ブランド情報がある場合は選択してください	商品のブランド情報

個人情報データ

email と phone のいずれかが必須です。

フィールド名	必須	推奨	説明
user_id	○	KARTEのuser_idを選択してください	ユーザーを識別するためのID
email	email または phone	メールアドレス情報がある場合は選択してください	ユーザーのメールアドレス
phone	email または phone	電話番号情報がある場合は選択してください	ユーザーの電話番号
first_name		名前情報がある場合は選択してください	ユーザーの名
last_name		苗字情報がある場合は選択してください	ユーザーの姓
gender		性別情報がある場合は選択してください	ユーザーの性別
birthday		生年月日情報がある場合は選択してください	ユーザーの生年月日
pref		都道府県情報がある場合は選択してください	ユーザーの都道府県
city		市区町村情報がある場合は選択してください	ユーザーの市区町村
zip_code		郵便番号情報がある場合は選択してください	ユーザーの郵便番号
country		国情報がある場合は選択してください	ユーザーの国
street_address		住所情報がある場合は選択してください	ユーザーの住所
idfa		iOSのIDFA情報がある場合は選択してください	iOSデバイスID
aaid		AndroidのAAID情報がある場合は選択してください	AndroidデバイスID

4.パラメータ

パラメータ名	説明
製品タイプ	媒体に送る製品タイプを選択します。「送らない」「製品」「製品グループ」から選択してください
TikTokイベント名	媒体管理画面のイベント設定で作成したイベント名を指定してください
データ利用時間	媒体に送信するデータを作成するための期間です。現在から入力した時間前までの期間が抽出されます

5.データ確認

送信スケジュールの前に データ確認 があります。コネクタを保存するまでは、「コネクタを保存するとデータを確認できます」と表示されます。

6.送信スケジュール

送信頻度は 単発送信 と 定期送信 から選びます。

単発送信 の場合は、送信日時 を指定します。現在時刻以前を設定すると即時実行されます。
定期送信 の場合は、実行間隔を設定してください。毎時の分は「50分」と表示されます。外部データを使う場合は、その連携頻度や連携時間に合わせてください。

7.基本情報

名前は必須です。テンプレートIDと時刻が入った値が初期値として入っています。説明は任意です。

8.送信

右上に 無効状態で保存 と 有効状態で保存 が並んでいます。

有効状態で保存 を押すと、「コネクタを送信」の確認が出ます。確認すると送信まで進みます。
無効状態で保存 を押すと送信されず、状態は「無効」になります。「下書き」という表示はありません。

TikTok広告へオフラインコンバージョンを連携する