--- title: TikTokイベントコネクタ構成ガイド description: この記事では、TikTokイベントコネクタの構成方法について説明します。 url: https://docs.tealium.com/ja/server-side-connectors/tiktok-events-connector/ --- ## 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](https://business-api.tiktok.com/portal/docs?id=1771101303285761) ## バッチ制限 このコネクタはバッチリクエストを使用して、ベンダーへの大量データ転送をサポートします。並行処理により、イベントがベンダーに順不同で到達する可能性があります。順序が重要な場合は、イベントにシーケンス値を追加してください。詳細については、[バッチアクション](https://docs.tealium.com/batched-actions/)を参照してください。リクエストは、次のいずれかの閾値に達するか、プロファイルが公開されるまでキューに入れられます： * 最大リクエスト数：50 * 最古のリクエストからの最大時間：5分 * リクエストの最大サイズ：1 MB ## 構成 コネクタマーケットプレイスにアクセスし、新しいコネクタを追加します。コネクタを追加する一般的な手順については、[コネクタについて](https://docs.tealium.com/about-connectors/)を参照してください。 コネクタを追加した後、以下の構成を構成します： * **アクセストークン**：TikTokで構成されたアクセストークン。 * **ピクセルID**：ウェブサイトにすでにTikTokピクセルが統合されている場合は、既存のピクセルコードを使用します。TikTok広告マネージャーアカウントにログインして、`pixel_code`を見つけます。ウェブサイトごとに1つのピクセルを作成します。 ## 重複排除 このコネクタを構成して、Tealium iQタグ管理アカウントのTikTokピクセルタグからイベントIDを受け取るには、次の命名規則を使用してイベント属性を探します： ```nohl tiktok_event_id__ ``` 例えば、UIDが`174`のタグからのイベントは次の属性を送信します： ```nohl tiktok_event_id_Checkout_174 ``` Tealium iQの**タグ**テーブルまたはタグの詳細画面でタグUIDを見つけます： ![](https://docs.tealium.com/images/server-side-connectors/tiktok-pixel-uid.png) このイベントID形式に一致する各イベントIDについて、別のアクションを構成します。イベント固有のイベントID属性を`Event ID`にマッピングし、対応するイベント名を`Event Name`にマッピングします。 例： | Tealium属性/値 | TikTokパラメータ | |-------|------| | `tiktok_event_id_Checkout_174` | Event ID | | `Checkout`（カスタムテキスト） | Event Name | 詳細については、[TikTokピクセルタグ構成ガイド](https://docs.tealium.com/tiktok-pixel-tag/)を参照してください。 ### 自動重複排除 同じイベントソースID（`event_source_id`）、イベントタイプ（例：`AddToCart`）、およびイベントID（`event_id`）を持つ複数のイベントが受信された場合、TikTokは最初のイベントを使用し、最初のイベントから48時間以内に受信された後続のイベントを破棄します。 最初のイベントの受信から5分以内に後続のイベントが受信された場合、TikTokはそのデータを最初のイベントにマージします。例えば、最初のイベントにユーザーのメール（`user.email`）が含まれていないが、5分以内に受信された後続の重複イベントにこの情報が含まれている場合、TikTokはメールデータを最初のイベントにマージします。 ## アクション | アクション名 | AudienceStream | EventStream | | --- | :---: | :---: | | トラックイベントの送信 | ✓ | ✓ | アプリ、ウェブ、オフライン、またはCRMイベントを報告するためにトラックエンドポイントを使用します。 アクションの名前を入力し、アクションタイプを選択します。 次のセクションでは、各アクションのパラメータとオプションの構成方法について説明します。 ### トラックイベントの送信 #### パラメータ | パラメータ | 説明 | | --- | --- | | イベントソース | イベントソースを選択します。可能な値は次のとおりです： | | イベントタイプ | 変換イベント名。可能な値は次のとおりです： | | イベントソースID | (必須) イベントを追跡するためのID。| | イベント時間 | (必須) イベントが発生した時のUnixエポック形式のタイムスタンプ（秒単位）。タイムスタンプを提供しない場合、コネクタは現在のタイムスタンプを使用します。 | | カスタムイベント名 | カスタムイベント名。**イベントタイプ**ドロップダウンから**カスタム**を選択した場合に必要です。 | | ピクセルIDオーバーライド | **TikTokイベントマネージャー**で見つかるピクセルID。この構成は**構成**セクションで使用される**ピクセルID**を上書きします。 | | アクセストークンオーバーライド | 構成内の値を上書きするカスタムアクセストークン。 | | イベントID | ユニークなユーザーまたはセッションを識別できる任意のハッシュID。例えば、`SessionID_RandomNumber`。[TikTokピクセルタグでイベントIDを生成する](https://docs.tealium.com/tiktok-pixel-tag/)を`true`に構成すると、このIDはTikTokトラッキングイベントごとに自動的に生成されます。 | | データ使用制限 | このフィールドは、イベントソースが`WEB`または`APP`の場合にのみサポートされます。限定データ処理構成。限定データ使用機能について詳しくは、[TikTok: 限定データ使用](https://business-api.tiktok.com/portal/docs?id=1771101204435970)を参照してください。 | | テストイベントコード | テストイベントを送信して、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。| | Locale | `la-CO`形式のロケール言語とロケール。ここで`la`は言語を表す2文字のコード、`CO`は国を表す2文字の大文字コード。 | | Att Status | ユーザーまたはデバイスのトラッキングに関連するアプリデータへのアクセスをモバイルアプリが認証したかどうか。これはiOS専用のフィールドです。サポートされる値は`AUTHORIZED`, `DENIED`, `NOT_DETERMINED`, `NOT_APPLICABLE`。 | | Vertical Choice | **Property Data**の下で業種固有のパラメータを表示する業種を選択。利用可能なオプションは`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`に構成します。自動的にマッピングされたパラメータはベンダーに送信されません。 #### カスタムイベント このコネクタのカスタムイベントを選択するには： 1. **イベントタイプ**カテゴリの下で、**変換イベント名**に`Custom`を選択します。 1. **カスタムイベント名**フィールドにカスタムイベント名を入力し、**+ マッピング追加**をクリックします。