TikTokイベントコネクタ構成ガイド
この記事では、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分
- リクエストの最大サイズ：1 MB
コネクタアクション
| アクション名 | AudienceStream | EventStream |
|---|---|---|
| トラックイベントの送信 | ✓ | ✓ |
トラックエンドポイントを使用して、アプリ、ウェブ、オフライン、またはCRMイベントを報告します。
構成の構成
コネクタマーケットプレイスに移動し、新しいコネクタを追加します。コネクタの追加方法の一般的な指示については、コネクタについてを参照してください。
コネクタを追加した後、以下の構成を構成します：
- アクセストークン
TikTokで構成されたアクセストークン。 - ピクセルID
すでにウェブサイトにTikTokピクセルが統合されている場合は、既存のピクセルコードを使用できます。pixel_codeは、TikTok広告マネージャーアカウントにログインして見つけることができます。ウェブサイトごとに1つのピクセルを作成することをお勧めします。
TikTokピクセルとTikTokコンバージョンのWebイベントの重複排除
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でハッシュ化されます。 |
| クッキーID | クッキーのID。 |
| IP | ブラウザの非ハッシュ化された公開IPアドレス。ウェブサイト訪問イベントとTikTok広告のマッチング確率を上げるため、IPとユーザーエージェントの両方を送信することをお勧めします。 |
| ユーザーエージェント | ユーザーのデバイスからの非ハッシュ化されたユーザーエージェント。ウェブサイト訪問イベントとTikTok広告のマッチング確率を上げるため、IPとユーザーエージェントの両方を送信することをお勧めします。自動マッピングを無効にしない限り、このパラメータは訪問のユーザーエージェントに自動マッピングされます。 |
| IDFA | iOSの広告主向け識別子。 |
| IDFV | iOSのベンダー向け識別子。 |
| GAID | Google広告ID。 |
| ロケール | la-CO形式のロケール言語とロケール。ここで、laは言語を表す2文字のコードで、COは国を表す2文字の大文字のコードです。 |
| Attステータス | ユーザーがあなたのモバイルアプリに対してユーザーまたはデバイスの追跡に関連するデータへのアクセスを許可したかどうか。これはiOS専用のフィールドです。サポートされている値はAUTHORIZED、DENIED、NOT_DETERMINED、NOT_APPLICABLEです。 |
プロパティデータ
| パラメータ | 説明 |
|---|---|
| コンテンツタイプ | 商品のタイプ。この値はproductまたはproduct_groupでなければならず、商品カタログのデータフィードがどのように構成されているかによります。 |
| 通貨 | 3文字のISO 4217コード。例えば、EUR、USD、JPY。 |
| 値 | 注文または販売された商品の合計値。 |
| クエリ | 検索クエリで使用されるテキスト。 |
| 説明 | アプリイベントの説明。 |
| 注文ID | 注文ID。 |
| ショップID | ショップID。 |
コンテンツデータ
| パラメータ | 説明 |
|---|---|
| 価格 | 商品の価格。数値と数値の配列のデータタイプをサポートします。 |
| 数量 | 商品の数量。整数と数値の配列のデータタイプをサポートします。 |
| コンテンツID | あなたのシステム内の商品IDまたはID。文字列と文字列の配列のデータタイプをサポートします。 |
| コンテンツカテゴリ | ページまたは商品のカテゴリまたはカテゴリ。文字列と文字列の配列のデータタイプをサポートします。 |
| コンテンツ名 | ページまたは商品の名前。文字列と文字列の配列のデータタイプをサポートします。 |
| ブランド | 商品アイテムのブランド。文字列と文字列の配列のデータタイプをサポートします。 |
アプリデータ
| パラメータ | 説明 |
|---|---|
| アプリID | モバイルアプリのID。 |
| アプリバージョン | アプリのバージョン番号。 |
| アプリケーション名 | アプリケーションの名前。 |
リードデータ
| パラメータ | 説明 |
|---|---|
| リードID | TikTokリードのID。 |
| リードイベントソース | リードイベントのソース。 |
自動重複排除
| パラメータ | 説明 |
|---|---|
| 自動マッピングの無効化 | 自動マッピングが無効化されている場合、自動マッピングされたパラメータはデフォルトでベンダーに送信されません。 |
コネクタはデフォルトで以下のパラメータを自動マッピングします：
- TikTok Click ID (
ttclid) - User Agent
自動マッピングを無効にするには、自動マッピングの無効化をtrueに構成します。自動マッピングされたパラメータはベンダーに送信されません。
カスタムイベント
このコネクタにカスタムイベントを選択するには：
- イベントタイプカテゴリの下で、コンバージョンイベント名に
Customを選択します。 - カスタムイベント名フィールドにカスタムイベント名を入力し、+ マッピングを追加をクリックします。
最終更新日 :: 2025年February月13日