TikTokイベントコネクタ構成ガイド
この記事では、TikTokイベントコネクタの構成方法について説明します。
API情報
このコネクタは以下のベンダーAPIを使用します：
- API名：TikTok HTTP API
- APIバージョン：v1.3
- APIエンドポイント：
https://business-api.tiktok.com/open_api/v1.3/event/track/ - ドキュメント：TikTokイベントAPI
バッチ制限
このコネクタは、ベンダーへの大量データ転送をサポートするためにバッチリクエストを使用します。詳細については、バッチアクションを参照してください。リクエストは、次のいずれかの閾値に達するか、プロファイルが公開されるまでキューに入れられます：
- 最大リクエスト数：50
- 最古のリクエストからの最大時間：5分
- リクエストの最大サイズ：1MB
コネクタアクション
| アクション名 | AudienceStream | EventStream |
|---|---|---|
| トラックイベント送信 | ✓ | ✓ |
トラックエンドポイントを使用して、アプリ、Web、オフライン、またはCRMイベントを報告します。
構成
コネクタマーケットプレイスにアクセスして、新しいコネクタを追加します。コネクタを追加する一般的な手順については、コネクタについてを参照してください。
コネクタを追加した後、以下の構成を構成します：
- アクセストークン
TikTokで構成されたアクセストークン。 - ピクセルID
すでにウェブサイトにTikTokピクセルが統合されている場合は、既存のピクセルコードを使用できます。pixel_codeは、TikTok広告マネージャーアカウントにログインして見つけることができます。ウェブサイトごとに1つのピクセルを作成することをお勧めします。
TikTokピクセルとWebイベントのTikTokコンバージョンの重複排除
このコネクタを構成して、Tealium iQタグ管理アカウントのTikTokピクセルタグからイベントIDを受け取るには、次の命名規則を使用してイベント属性を探します：
形式：tiktok_event_id_<TIKTOK_EVENT>_<TAG_UID>
例えば、UIDが174のタグからのイベントは、次の属性値を送信します：
tiktok_event_id_Checkout_174`
タグのUIDは、Tealium iQのタグテーブルまたはタグの詳細画面で見つけることができます：
上記の形式に一致する各イベントIDについて、別のアクションを構成します。イベント固有のイベントID属性をイベントIDにマッピングし、対応するイベント名をイベント名にマッピングします。
例：
| Tealium属性/値 | TikTokパラメータ |
|---|---|
tiktok_event_id_Purchase |
イベントID |
| “Purchase” (カスタムテキスト) | イベント名 |
詳細については、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広告とウェブサイト訪問イベントを照合するために使用されるttclidの値。 |
| キャンペーンID | キャンペーンID。 |
| 広告ID | 広告グループID。 |
| クリエイティブID | 広告ID。 |
| リターゲティング | ユーザーがリターゲティングされているかどうか。 |
| 帰属 | イベントがプロバイダーに帰属しているかどうか。 |
| 帰属タイプ | 帰属のタイプ。 |
| 帰属プロバイダー | 帰属プロバイダー名。 |
ページデータ
| パラメータ | 説明 |
|---|---|
| リファラー | ページリファラー。 |
| URL | イベントが発生したときのページURL。 |
ユーザーデータ
| パラメータ | 説明 |
|---|---|
| ユーザーメール | 推奨。ユーザーのメールアドレス、SHA256でハッシュ化。 |
| ユーザー電話番号 | 推奨。ユーザーの電話番号、SHA256でハッシュ化。国コードを+で含め、他の文字（スペース、-）は番号の間から削除します（例：USAの場合：+12125551212）。国コードが86の場合、国コードを含めません（例：13800000000）。 |
| ユーザー外部ID | 推奨。外部ユーザーID、SHA256でハッシュ化。 |
| Cookie ID | CookieのID。 |
| IP | ブラウザの非ハッシュ化された公開IPアドレス。ウェブサイト訪問イベントをTikTok広告と照合する確率を高めるために、IPとユーザーエージェントの両方を送信することを推奨します。 |
| ユーザーエージェント | ユーザーのデバイスからの非ハッシュ化されたユーザーエージェント。ウェブサイト訪問イベントをTikTok広告と照合する確率を高めるために、IPとユーザーエージェントの両方を送信することを推奨します。自動マッピングを無効にしない限り、このパラメータは訪問のユーザーエージェントに自動マッピングされます。 |
| IDFA | iOS広告主識別子。 |
| IDFV | iOSベンダー識別子。 |
| GAID | Google広告ID。 |
| ロケール | la-CO形式のロケール言語とロケール。ここでlaは言語を表す2文字のコード、COは国を表す2文字の大文字コードです。 |
プロパティデータ
| パラメータ | 説明 |
|---|---|
| コンテンツタイプ | 製品のタイプ。この値は、製品カタログのデータフィードの構成に応じて product または product_group でなければなりません。 |
| 通貨 | 3文字のISO 4217コード。例えば、EUR, USD, JPY。 |
| 値 | 注文または販売されたアイテムの総価値。 |
| クエリ | 検索クエリで使用されるテキスト。 |
| 説明 | アプリイベントの説明。 |
| 注文ID | 注文ID。 |
| ショップID | ショップID。 |
コンテンツデータ
| パラメータ | 説明 |
|---|---|
| 価格 | アイテムの価格。数値および数値の配列のデータタイプをサポートします。 |
| 数量 | アイテムの数。整数および数値の配列のデータタイプをサポートします。 |
| コンテンツID | システム内の製品IDまたはID。文字列および文字列の配列のデータタイプをサポートします。 |
| コンテンツカテゴリ | ページまたは製品のカテゴリまたはカテゴリ。文字列および文字列の配列のデータタイプをサポートします。 |
| コンテンツ名 | ページまたは製品の名前。文字列および文字列の配列のデータタイプをサポートします。 |
| ブランド | 製品アイテムのブランド。文字列および文字列の配列のデータタイプをサポートします。 |
アプリデータ
| パラメータ | 説明 |
|---|---|
| アプリID | モバイルアプリID。 |
| アプリバージョン | アプリのバージョン番号。 |
| アプリケーション名 | アプリケーションの名前。 |
リードデータ
| パラメータ | 説明 |
|---|---|
| リードID | TikTokリードのID。 |
| リードイベントソース | リードイベントソース。 |
自動重複排除
| パラメータ | 説明 |
|---|---|
| 自動マッピング無効 | 自動マッピングが無効に構成されている場合、自動マッピングされたパラメータはデフォルトでベンダーに送信されません。 |
コネクタはデフォルトで以下のパラメータを自動マッピングします:
- TikTokクリックID (
ttclid) - ユーザーエージェント
自動マッピングを無効にするには、自動マッピング無効を true に構成します。自動マッピングされたパラメータはベンダーに送信されません。
カスタムイベント
このコネクタのカスタムイベントを選択するには:
- イベントタイプ カテゴリで、コンバージョンイベント名に
Customを選択します。 - カスタムイベント名 フィールドにカスタムイベント名を入力し、+ マッピング追加 をクリックします。
最終更新日 :: 2025年March月14日