TikTokイベントコネクタ構成ガイド
この記事では、TikTokイベントコネクタの構成方法について説明します。
API情報
このコネクタは以下のベンダーAPIを使用します：
- API名：TikTok HTTP API
- APIバージョン：v1.3（イベント2.0）
- APIエンドポイント：
https://business-api.tiktok.com/open_api/v1.3/event/track/ - ドキュメント：TikTokイベント2.0
バッチ制限
このコネクタは、ベンダーへの大量データ転送をサポートするためにバッチリクエストを使用します。詳細については、バッチアクションを参照してください。リクエストは、次のいずれかの閾値に達するか、プロファイルが公開されるまでキューに入れられます：
- 最大リクエスト数：50
- 最古のリクエストからの最大時間：5分
- リクエストの最大サイズ：1 MB
コネクタアクション
| アクション名 | AudienceStream | EventStream |
|---|---|---|
| トラックイベント送信 | ✓ | ✓ |
トラックエンドポイントを使用して、アプリ、Web、オフライン、またはCRMイベントを報告します。
構成
コネクタマーケットプレイスにアクセスし、新しいコネクタを追加します。コネクタを追加する一般的な手順については、コネクタについてを参照してください。
コネクタを追加した後、以下の構成を構成します：
- アクセストークン
TikTokで構成されたアクセストークン。 - ピクセルID
ウェブサイトにすでにTikTokピクセルが統合されている場合は、既存のピクセルコードを使用します。TikTok広告マネージャーアカウントにログインして、pixel_codeを見つけます。ウェブサイトごとに1つのピクセルを作成します。
重複排除
このコネクタを構成して、Tealium iQタグ管理アカウントのTikTokピクセルタグからイベントIDを受け取るには、次の命名規則を使用してイベント属性を探します：
tiktok_event_id_<TIKTOK_EVENT>_<TAG_UID>
例えば、UIDが174のタグからのイベントは、次の属性を送信します：
tiktok_event_id_Checkout_174
Tealium iQのタグテーブルまたはタグの詳細画面でタグのUIDを見つけます：
このイベントID形式に一致する各イベントIDについて、別のアクションを構成します。イベント固有のイベントID属性をEvent IDにマップし、対応するイベント名をEvent Nameにマップします。
例：
| Tealium属性/値 | TikTokパラメータ |
|---|---|
tiktok_event_id_Checkout_174 |
イベントID |
Checkout（カスタムテキスト） |
イベント名 |
詳細については、TikTokピクセルタグ構成ガイドを参照してください。
自動重複排除
同じイベントソースID（event_source_id）、イベントタイプ（例：AddToCart）、およびイベントID（event_id）を持つ複数のイベントが受信された場合、TikTokは最初のイベントを使用し、最初のイベントから48時間以内に受信された後のイベントは破棄します。
最初のイベントの受信から5分以内に後のイベントが受信された場合、TikTokはそのデータを最初のイベントにマージします。たとえば、最初のイベントにユーザーのメール（user.email）が含まれていないが、5分以内に受信された後の重複イベントにこの情報が含まれている場合、TikTokはメールデータを最初のイベントにマージします。
アクション
アクションの名前を入力し、ドロップダウンメニューからアクションタイプを選択します。
次のセクションでは、各アクションのパラメータとオプションの構成方法について説明します。
トラックイベント送信
パラメータ
| パラメータ | 説明 |
|---|---|
| イベントソース | イベントソースを選択します。
|
| イベントタイプ | 変換イベント名。
|
| イベントソースID | (必須) イベントを追跡するID。
|
| イベント時間 | (必須) イベントが発生した時のタイムスタンプ（ISO 8601形式 YYYY-MM-DDThh:mm:ssZ）。タイムスタンプを提供しない場合、コネクタは現在のタイムスタンプを使用します。 |
| カスタムイベント名 | カスタムをイベントタイプドロップダウンから選択した場合に必要です。 |
| ピクセルIDオーバーライド | TikTokイベントマネージャーで見つかるピクセルID。この構成は構成セクションで使用されるピクセルIDを上書きします。 |
| アクセストークンオーバーライド | 構成内の値を上書きするカスタムアクセストークン。 |
| イベントID | ユニークなユーザーまたはセッションを識別できる任意のハッシュID。例えば、SessionID_RandomNumber。TikTokピクセルタグでイベントIDを生成するをtrueに構成すると、このIDはTikTokトラッキングイベントごとに自動的に生成されます。 |
| データ使用制限 | このフィールドはイベントソースがWEBまたはAPPの場合にのみサポートされます。限定データ処理構成。限定データ使用機能について詳しくは、TikTok: 限定データ使用を参照してください。 |
| テストイベントコード | TikTokイベントマネージャー（TTEM）の本番データに含まれないテストイベントを送信します。test_event_codeはTTEMのTest Eventsタブから取得します。 |
広告データ
| パラメータ | 説明 |
|---|---|
| コールバック | TikTok広告とウェブサイト訪問イベントをマッチさせるために使用されるttclidの値。 |
| キャンペーンID | キャンペーンID。 |
| 広告ID | 広告グループID。 |
| クリエイティブID | 広告ID。 |
| リターゲティング | ユーザーがリターゲティングされているかどうか。 |
| 帰属 | イベントがプロバイダーに帰属しているかどうか。 |
| 帰属タイプ | 帰属のタイプ。 |
| 帰属プロバイダー | 帰属プロバイダーの名前。 |
ページデータ
| パラメータ | 説明 |
|---|---|
| リファラー | ページリファラー。 |
| URL | イベントが発生したときのページURL。 |
ユーザーデータ
| パラメータ | 説明 |
|---|---|
| ユーザーのメール | 推奨。ユーザーのメールアドレスをSHA256でハッシュ化。 |
| ユーザーの電話番号 | 推奨。ユーザーの電話番号をSHA256でハッシュ化。国コードは+を付け、その他の文字（スペース、-）は削除（例：アメリカの場合は+12125551212）。国コードが86の場合は、国コードを含めない（例：13800000000）。 |
| ユーザー外部ID | 推奨。外部ユーザーIDをSHA256でハッシュ化。 |
| Cookie ID | CookieのID。 |
| IP | ブラウザの非ハッシュ化された公開IPアドレス。TikTok広告とウェブサイト訪問イベントのマッチング確率を高めるため、IPとUser Agentの両方を送信することを推奨。 |
| User Agent | ユーザーのデバイスからの非ハッシュ化されたユーザーエージェント。TikTok広告とウェブサイト訪問イベントのマッチング確率を高めるため、IPとUser Agentの両方を送信することを推奨。自動マッピングを無効にしない限り、このパラメータは訪問のUser Agentに自動的にマッピングされます。 |
| 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 | イベントに関連する製品ID、例えばSKU。 |
| 市 | ホテルの市の位置。 |
| 地域 | ホテルの地域。 |
| 国 | ホテルの国。 |
| チェックイン日 | ホテルのチェックイン日。 |
| チェックアウト日 | ホテルのチェックアウト日。 |
| 大人の数 | 予約の大人の数。 |
| 子供の数 | 予約の子供の数。 |
| 推奨ホテル | このユーザーに推奨されるホテル。文字列または文字列の配列であることができます。 |
フライトバーティカル固有のパラメータ
| パラメータ | 説明 |
|---|---|
| 目的地市 | 目的地の市名。 |
| 出発日 | フライトの出発日。受け入れられる形式は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 | イベントに関連する製品ID、例えばSKU。 |
| 市 | 目的地の市の位置。 |
| 地域 | 目的地の地域。 |
| 国 | 目的地の国。 |
| 旅行開始 | ユーザーの旅行の開始日。受け入れられる形式は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。 |
| アプリバージョン | アプリのバージョン番号。 |
| アプリケーション名 | アプリケーションの名前。 |
リードデータ
| パラメータ | 説明 |
|---|---|
| リードID | TikTokリードのID。 |
| リードイベントソース | リードイベントのソース。 |
自動重複排除
| パラメータ | 説明 |
|---|---|
| 自動マッピング無効 | 自動マッピングが無効の場合、自動的にマッピングされたパラメータはデフォルトでベンダーに送信されません。 |
コネクタはデフォルトで以下のパラメータを自動マッピングします：
- TikTokクリックID (
ttclid) - User Agent
自動マッピングを無効にするには、自動マッピング無効をtrueに構成します。自動的にマッピングされたパラメータはベンダーに送信されません。
カスタムイベント
このコネクタのカスタムイベントを選択するには：
- イベントタイプカテゴリの下で、変換イベント名に
Customを選択します。 - カスタムイベント名フィールドにカスタムイベント名を入力し、+ マッピング追加をクリックします。
最終更新日 :: 2025年October月29日