TikTokイベントコネクタ構成ガイド | サーバーサイドコネクタ

この記事では、TikTokイベントコネクタの構成方法について説明します。

API情報

このコネクタは以下のベンダーAPIを使用します：

API名：TikTok HTTP API
APIバージョン：v1.3
APIエンドポイント：https://business-api.tiktok.com/open_api/v1.3
ドキュメンテーション：TikTokイベントAPI

バッチ制限

このコネクタは、ベンダーへの大量データ転送をサポートするためにバッチリクエストを使用します。詳細については、バッチアクションを参照してください。リクエストは、以下のいずれかの閾値が達成されるか、プロファイルが公開されるまでキューに入れられます：

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

コネクタアクション

アクション名	AudienceStream	EventStream
アプリイベントの送信	✓	✓
ウェブイベントの送信	✓	✓

構成の構成

コネクタマーケットプレイスに移動し、新しいコネクタを追加します。コネクタの追加方法の一般的な指示については、コネクタについてを参照してください。

コネクタを追加した後、以下の構成を構成します：

アクセストークン
TikTokで構成されたアクセストークン。
ピクセルID
すでにウェブサイトにTikTokピクセルが統合されている場合は、既存のピクセルコードを使用できます。pixel_codeは、TikTok広告マネージャーアカウントにログインして見つけることができます。ウェブサイトごとに1つのピクセルを作成することをお勧めします。

TikTokピクセルとTikTokコンバージョンのウェブイベントの重複排除

Tealium iQタグ管理アカウントのTikTokピクセルタグからイベントIDを受け取るようにこのコネクタを構成するには、以下の命名規則を使用してイベント属性を探します：

形式：tiktok_event_id_<TikTok Event>_<Tag UID> 例：tiktok_event_id_Checkout_32

上記の形式に一致する各イベントIDについて、別のアクションを構成します。イベント固有のイベントID属性をイベントIDに、対応するイベント名をイベント名にマッピングします。

例：

Tealium属性/値	TikTokパラメータ
`tiktok_event_id_Purchase`	イベントID
“Purchase” (カスタムテキスト)	イベント名

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

自動重複排除

自動重複排除の値が入力されている場合、コネクタはUDOオブジェクト内の対応する変数を探します。このセクションにTealium iQタグIDへのマッピングが含まれている場合、Tealium iQを使用している場合は、イベントIDを追加する必要はありません。ただし、Tealium iQを使用せずにEventStreamを使用する場合は、以下のアプローチがまだ必要な場合があります。

コネクタは以下の操作順序を使用します：

自動重複排除にマッピングが含まれ、その値がデータレイヤーで見つかる場合（例：tiktok_event_id_ViewContent_30）、データレイヤーの値がイベントIDにマッピングされたものを上書きします。
自動重複排除にマッピングが含まれ、コネクタがタグIDバージョンを見つけられないが、レガシーバージョン（IDが付いていない）を見つけられる場合、レガシーバージョンの値が使用されます（例：tiktok_event_id_ViewContent）。
自動重複排除にマッピングが含まれているが、その値が見つからない場合、マッピングされたイベントIDが使用されます（入力されている場合）。

アクション構成 - パラメータとオプション

アクションに名前を入力し、ドロップダウンメニューからアクションタイプを選択します。

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

アクション - ウェブイベントの送信

パラメータ

パラメータ	説明
イベントタイプ	必須。コンバージョンイベント名。
カスタムイベント名	イベントタイプドロップダウンでカスタムを選択した場合に必要。
ピクセルIDオーバーライド	TikTokイベントマネージャーで見つけることができるピクセルID。この構成は、構成セクションで使用されるピクセルIDを上書きします。
イベントID	ユニークなユーザーまたはセッションを識別できる任意のハッシュ化されたID。例えば、`SessionID_RandomNumber`。TikTokピクセルタグでイベントIDを生成を`true`に構成すると、このIDはすべてのTikTokトラッキングイベントで自動的に生成されます。
IP	ブラウザの非ハッシュ化された公開IPアドレス。ウェブサイト訪問のイベントとTikTok広告をマッチングする確率を高めるために、IPとユーザーエージェントの両方を送信することをお勧めします。
ユーザーエージェント	ユーザーのデバイスからの非ハッシュ化されたユーザーエージェント。ウェブサイト訪問のイベントとTikTok広告をマッチングする確率を高めるために、IPとユーザーエージェントの両方を送信することをお勧めします。自動マッピングを無効にしない限り、このパラメータは訪問のユーザーエージェントに自動マッピングされます。
テストイベントコード	イベントトラッキングをテストするために、このフィールドにテストコードを指定します。イベントがTikTokで受信されると、このテストコードはTikTok広告マネージャーのTikTokピクセルのテストイベントタブに表示されます。
タイムスタンプ	イベントが発生した時刻のタイムスタンプで、ISO 8601形式`YYYY-MM-DDThh:mm:ssZ`を使用します。タイムスタンプが提供されていない場合、現在のタイムスタンプが使用されます。
コールバック	ウェブサイト訪問のイベントとTikTok広告をマッチングするために使用される`ttclid`の値。
リファラー	ページリファラー。
URL	イベントが発生した時のページURL。
ユーザー外部ID	（推奨）。外部ユーザーID、SHA256でハッシュ化されます。
ユーザー電話番号	（推奨）。ユーザーの電話番号、SHA256でハッシュ化されます。国コードを`+`で含め、数字の間の他の文字（スペース、`-`）を削除します（例：USAの場合：`+12125551212`）。国コードが`86`の場合、国コードを含めないでください（例：`13800000000`）。
ユーザーのメール	（推奨）。メールアドレス、SHA256でハッシュ化されます。
コンテンツタイプ	商品のタイプ。この値は、商品カタログのデータフィードがどのように構成されているかにより、`product`または`product_group`でなければなりません。
コンテンツ価格	商品の価格。数値データタイプをサポートします。
コンテンツ数量	商品の数量。数値データタイプをサポートします。
コンテンツID	システム内の商品ID。
コンテンツブランド	商品のブランド。
コンテンツ説明	商品の説明。
説明	アプリイベントの説明。
通貨	3文字のISO-4217コード。例：`EUR`、`USD`、`JPY`。
値	売れた注文または商品の合計値。
クエリ	検索クエリで使用されるテキスト。
Tealium iQタグID	イベントの自動重複排除に使用するTealium TikTokピクセルタグのID。提供された場合、Tealiumは自動的にTealium iQから送信されるイベントID値を探します。
アクセストークンオーバーライド	構成の値を上書きするカスタムアクセストークン。

自動マッピングの無効化

コネクタはデフォルトで以下のパラメータを自動マッピングします：

TikTokクリックID（ttclid）
ユーザーエージェント

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

カスタムイベント

このコネクタのカスタムイベントを選択するには：

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