TikTok Events コネクタ構成ガイド

API 情報

このコネクタは、次のベンダー API を使用します。

API 名：TikTok HTTP API
API バージョン：v1.3（Events 2.0）
API エンドポイント：https://business-api.tiktok.com/open_api/v1.3/event/track/
ドキュメント：TikTok Events 2.0

バッチ処理の上限

このコネクタは、ベンダーへの大量のデータ転送をサポートするため、リクエストをバッチ処理します。並列処理により、イベントが順不同でベンダーに到達する場合があります。順序が重要な場合は、イベントにシーケンス値を追加してください。詳細については、バッチアクションを参照してください。リクエストは、次のいずれかのしきい値に達するか、プロファイルがパブリッシュされるまでキューに格納されます。

リクエストの最大数：50
最も古いリクエストからの最大経過時間：5 分
リクエストの最大サイズ：1 MB

構成

コネクタマーケットプレイスに移動し、新しいコネクタを追加します。詳細については、コネクタについてを参照してください。

コネクタを追加した後、次の構成を構成します。

アクセストークン：TikTok のアクセストークン。
ピクセル ID：Web サイトに TikTok ピクセルをすでに統合している場合は、既存のピクセルコードを使用します。TikTok Ads Manager アカウントにログインして、pixel_codeを確認してください。Web サイトごとに 1 つのピクセルを作成します。

コネクタを構成したら、完了をクリックします。

重複排除

Tag Management アカウントの TikTok Pixel タグからイベント ID を受信するようにこのコネクタを構成するには、次の命名規則を使用するイベント属性を探します。

tiktok_event_id_<TIKTOK_EVENT>_<TAG_UID>

たとえば、UID が174のタグからのイベントは、次の属性を送信します。

tiktok_event_id_Checkout_174

タグ UID は、Tag Management のタグテーブルまたはタグの詳細画面で確認できます。

このイベント ID 形式に一致するイベント ID ごとに、個別のアクションを構成します。イベント固有のイベント ID 属性をEvent IDにマッピングし、対応するイベント名をEvent Nameにマッピングします。

例：

Tealium の属性／値	TikTok パラメータ
`tiktok_event_id_Checkout_174`	イベント ID
`Checkout`（カスタムテキスト）	イベント名

詳細については、TikTok Pixel タグ構成ガイドを参照してください。

自動重複排除

同じイベントソース ID（event_source_id）、イベントタイプ（例：AddToCart）、イベント ID（event_id）を持つ複数のイベントを受信した場合、TikTok は最初のイベントを使用し、そのイベントから 48 時間以内に受信した後続のイベントを破棄します。

最初のイベントから 5 分以内に後続のイベントを受信した場合、TikTok はそのデータを最初のイベントにマージします。たとえば、最初のイベントにユーザーのメールアドレス（user.email）が含まれていないものの、後で受信した重複イベント（5 分以内に受信）にこの情報が含まれている場合、TikTok はメールアドレスのデータを最初のイベントにマージします。

アクション

アクション名	訪問プロファイル	イベントデータ
トラックイベントを送信	✓	✓

Track エンドポイントを使用して、アプリ、Web、オフライン、または CRM イベントをレポートします。

アクションの名前を入力し、アクションタイプを選択します。

次のセクションでは、各アクションのパラメータとオプションを構成する方法について説明します。

トラックイベントを送信

パラメータ

パラメータ	説明
イベントソース	イベントソースを選択します。指定できる値は次のとおりです。 `WEB` `APP` `OFFLINE` `CRM`
イベントタイプ	コンバージョンイベント名。指定できる値は次のとおりです。 `Achieve a Level` `Add Payment Information` `Add to Cart` `Add to Wishlist` `Check Out` `Click Button` `Complete Payment` `Complete Registration` `Complete the Tutorial` `Contact` `Create a Group` `Create a Role` `Custom` `Download` `Generate a Lead` `Initiate Checkout` `Install the App` `In-app AD Click` `In-app AD Impression` `Join a Group` `Launch the App` `Load an Application` `Loan is Approved` `Loan is Disbursed` `Log in Successfully` `Place an Order` `Purchase` `Rate` `Search` `Spend Credits` `Start the Trial` `Submit Form` `Subscribe` `Unlock an Achievement` `View Content`
イベントソース ID	（必須）イベントを追跡するための ID。 `event_source`が`web`の場合、このフィールドにピクセルコードを指定します。 `event_source`が`offline`の場合、このフィールドにオフラインイベント ID を指定します。 `event_source`が`app`の場合、このフィールドに TikTok App ID を指定します。 `event_source`が`crm`の場合、このフィールドに CRM イベント ID を指定します。CRM イベント ID を取得するには、`/crm/list/`を使用します。
イベント時刻	（必須）イベントが発生した時刻を秒単位の Unix エポック形式で示すタイムスタンプ。タイムスタンプを指定しない場合、コネクタは現在のタイムスタンプを使用します。
カスタムイベント名	カスタムイベント名。イベントタイプドロップダウンからカスタムを選択した場合は必須です。
ピクセル ID の上書き	TikTok Events Managerのピクセル ID。この構成は、構成セクションで使用されるピクセル IDを上書きします。
アクセストークンの上書き	構成の値を上書きするカスタムアクセストークン。
イベント ID	一意のユーザーまたはセッションを識別できる任意のハッシュ化された ID。例：`SessionID_RandomNumber`。TikTok Pixel タグでイベント ID を生成を`true`に構成すると、この ID は TikTok の各トラッキングイベントに対して自動的に生成されます。
データ使用の制限	このフィールドは、イベントソースが`WEB`または`APP`の場合にのみサポートされます。制限付きデータ処理の構成です。データ使用制限機能の詳細については、TikTok：データ使用の制限を参照してください。
テストイベントコード	テストイベントを送信し、TikTok Events Manager（TTEM）の本番データから除外します。TTEM のテストイベントタブで`test_event_code`を取得します。

広告データ

パラメータ	説明
キャンペーン ID	キャンペーン ID。
広告 ID	広告グループ ID。
クリエイティブ ID	クリエイティブ ID。
リターゲティング	イベントがリターゲティング対象ユーザー向けかどうか。
アトリビューション済み	イベントがプロバイダーに帰属しているかどうか。
アトリビューションタイプ	アトリビューションのタイプ。
アトリビューションプロバイダー	アトリビューションプロバイダー名。

ページデータ

パラメータ	説明
参照元	ページの参照元。
URL	イベント発生時のページ URL。

ユーザーデータ

パラメータ	説明
ユーザーのメールアドレス	推奨。SHA256でハッシュ化したユーザーのメールアドレス。
ユーザーの電話番号	推奨。SHA256でハッシュ化したユーザーの電話番号。国番号を `+` とともに含め、数字の間にあるその他の文字（スペース、`-`）はすべて削除します（例：米国の場合は `+12125551212`）。国番号が `86` の場合は、国番号を含めないでください（例：`13800000000`）。
ユーザー外部ID	推奨。SHA256でハッシュ化した外部ユーザーID。
TikTokクリックID（ttclid）	推奨。Webサイト訪問のイベントとTikTok広告を照合するために使用されるTikTokクリックID。ハッシュ化しません。自動マッピングを無効にしない限り、このパラメータは `ttclid` Cookieから自動的にマッピングされ、見つからない場合は `ttclid` クエリパラメータが使用されます。明示的なマッピングは、自動マッピングされた値よりも優先されます。
Cookie ID	CookieのID。
IP	ブラウザーのハッシュ化されていないパブリックIPアドレス。Webサイト訪問のイベントとTikTok広告が照合される可能性を高めるため、IPとユーザーエージェントの両方を送信することをお勧めします。
ユーザーエージェント	ユーザーのデバイスから取得した、ハッシュ化されていないユーザーエージェント。Webサイト訪問のイベントとTikTok広告が照合される可能性を高めるため、IPとユーザーエージェントの両方を送信することをお勧めします。自動マッピングを無効にしない限り、このパラメータは訪問のユーザーエージェントに自動的にマッピングされます。
IDFA	広告主向けのiOS識別子。
IDFV	ベンダー向けのiOS識別子。
GAID	Google広告ID。
ロケール	`la-CO` 形式のロケール言語および地域。`la` は言語を表す2文字のコード、`CO` は国を表す2文字の大文字コードです。
ATTステータス	ユーザーまたはデバイスのトラッキングを目的としてモバイルアプリがアプリ関連データにアクセスすることを、ユーザーが許可しているかどうか。このフィールドはiOSにのみ適用されます。サポートされる値は `AUTHORIZED`、`DENIED`、`NOT_DETERMINED`、`NOT_APPLICABLE` です。
バーティカルの選択	プロパティデータの下にバーティカル固有のパラメータを表示するため、バーティカルを選択します。選択可能なオプションは `Hotel`、`Flight`、`Destination`、`No Vertical Selected` です。

プロパティデータ

パラメータ	説明
コンテンツタイプ	商品のタイプ。この値は、商品カタログのデータフィードの構成に応じて `product` または `product_group` にする必要があります。
通貨	3文字のISO 4217コード。例：`EUR`、`USD`、`JPY`。
値	注文または販売された商品の合計金額。
クエリ	検索クエリで使用されたテキスト。
説明	アプリイベントの説明。
注文ID	注文ID。
ショップID	ショップID。

ホテルバーティカル固有のパラメータ

パラメータ	説明
コンテンツID	SKUなど、イベントに関連付けられた商品ID。
都市	ホテルが所在する都市。
地域	ホテルが所在する地域。
国	ホテルが所在する国。
チェックイン日	ホテルのチェックイン日。
チェックアウト日	ホテルのチェックアウト日。
大人の人数	予約に含まれる大人の人数。
子どもの人数	予約に含まれる子どもの人数。
おすすめホテル	このユーザーにおすすめするホテル。文字列または文字列の配列を指定できます。

フライトバーティカル固有のパラメータ

パラメータ	説明
目的地の都市	目的地の都市名。
往路便の出発日	往路便の出発日。使用できる形式は `YYYYMMDD`、`YYYY-MM-DD`、`YYYY-MM-DDThh:mmTZD`、`YYYY-MM-DDThh:mm:ssTZD` です。例：`20180623`、`2018-06-23`、`2017-06-23T15:30GMT`、`2017-06-23T15:30:00GMT`。
復路便の出発日	復路便の出発日。使用できる形式は `YYYYMMDD`、`YYYY-MM-DD`、`YYYY-MM-DDThh:mmTZD`、`YYYY-MM-DDThh:mm:ssTZD` です。例：`20180623`、`2018-06-23`、`2017-06-23T15:30GMT`、`2017-06-23T15:30:00GMT`。
出発空港	出発空港のコード。例：`JFK`。
到着空港	到着空港のコード。例：`CDG`。
大人の人数	大人の人数。
子どもの人数	子どもの人数。
幼児の人数	幼児の人数。
搭乗クラス	航空券の搭乗クラス。この値は `economy`、`premium`、`business`、`first` のいずれかにする必要があります。
ユーザースコア	広告主にとっての、この見込み顧客の相対的な価値を表します。例：`50`。
希望する乗り継ぎ回数	希望する乗り継ぎ回数。

目的地バーティカル固有のパラメータ

パラメータ	説明
コンテンツID	SKUなど、イベントに関連付けられた商品ID。
都市	目的地の都市。
地域	目的地の地域。
国	目的地の国。
旅行開始日	ユーザーの旅行開始日。使用できる形式は `YYYYMMDD`、`YYYY-MM-DD`、`YYYY-MM-DDThh:mmTZD`、`YYYY-MM-DDThh:mm:ssTZD` です。例：`20180623`、`2018-06-23`、`2017-06-23T15:30GMT`、`2017-06-23T15:30:00GMT`。
旅行終了日	ユーザーの旅行終了日。使用できる形式は `YYYYMMDD`、`YYYY-MM-DD`、`YYYY-MM-DDThh:mmTZD`、`YYYY-MM-DDThh:mm:ssTZD` です。例：`20180623`、`2018-06-23`、`2017-06-23T15:30GMT`、`2017-06-23T15:30:00GMT`。
大人の人数	大人の人数。
子どもの人数	子どもの人数。
幼児の人数	幼児の人数。
おすすめの目的地	このユーザーに提案する目的地を表すIDのリスト。

コンテンツデータ

パラメータ	説明
価格	商品の価格。数値および数値の配列のデータ型をサポートします。
数量	商品の数量。整数および数値の配列のデータ型をサポートします。
コンテンツID	システム内の商品ID。文字列および文字列の配列のデータ型をサポートします。
コンテンツカテゴリ	ページまたは商品のカテゴリ。文字列および文字列の配列のデータ型をサポートします。
コンテンツ名	ページまたは商品の名前。文字列および文字列の配列のデータ型をサポートします。
ブランド	商品のブランド。文字列および文字列の配列のデータ型をサポートします。

アプリデータ

パラメータ	説明
アプリID	モバイルアプリのID。
アプリバージョン	アプリのバージョン番号。
アプリケーション名	アプリケーション名。

リードデータ

パラメータ	説明
リードID	TikTokリードのID。
リードイベントソース	リードイベントのソース。

自動重複排除

パラメータ	説明
自動マッピングを無効化	自動マッピングを無効にすると、自動的にマッピングされたパラメータはデフォルトではベンダーに送信されません。

コネクターは、デフォルトで次のパラメータを自動的にマッピングします。

TikTokクリックID（ttclid）： 最初に ttclid Cookieから読み取り、見つからない場合は ttclid クエリパラメータを使用し、data[].user.ttclid としてシリアル化します。
ユーザーエージェント： 訪問のユーザーエージェントから読み取ります。

自動マッピングを無効にするには、自動マッピングを無効化を true に構成します。自動的にマッピングされたパラメータはベンダーに送信されません。

カスタムイベント

このコネクターのカスタムイベントを選択するには、次の手順を実行します。

イベントタイプカテゴリで、コンバージョンイベント名に Custom を選択します。
カスタムイベント名フィールドにカスタムイベント名を入力し、+ マッピングを追加をクリックします。