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
トラックイベントの送信	✓	✓

トラックエンドポイントを使用して、アプリ、Web、オフライン、またはCRMイベントを報告します。

構成の構成

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

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

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

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

このコネクタを構成して、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ピクセルタグ構成ガイドを参照してください。

自動重複排除

同じイベントソースID（event_source_id）、イベントタイプ（例：AddToCart）、イベントID（event_id）を持つ複数のイベントが受信された場合、TikTokは最初のものを使用し、最初のイベントから48時間以内に受信された後続のイベントを破棄します。後続のイベントが最初のイベントから5分以内に受信された場合、TikTokはそのデータを最初のイベントにマージしようとします。例えば、最初のイベントにユーザーのメール（user.email）が含まれていないが、後続の重複イベント（5分以内に受信）にこの情報が含まれている場合、TikTokはメールデータを最初のイベントにマージします。

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

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

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

アクション - トラックイベントの送信

パラメータ

パラメータ	説明
カスタムイベント名	イベントタイプドロップダウンからカスタムを選択した場合に必要です。
ピクセルIDオーバーライド	TikTokイベントマネージャーで見つけることができるピクセルID。この構成は、構成セクションで使用されるピクセルIDを上書きします。
アクセストークンオーバーライド	構成の値を上書きするカスタムアクセストークン。
イベントソースID	必須。イベントを追跡するためのID。 event_sourceがwebの場合、このフィールドにピクセルコードを指定します。 event_sourceがofflineの場合、このフィールドにオフラインイベントIDを指定します。 event_sourceがappの場合、このフィールドにTikTokアプリIDを指定します。 event_sourceがcrmの場合、このフィールドにCRMイベントIDを指定します。CRMイベントIDを取得するには、/crm/list/を使用します。
イベント時間	必須。イベントが発生した時刻のタイムスタンプ。ISO 8601形式YYYY-MM-DDThh:mm:ssZを使用します。タイムスタンプが提供されていない場合、現在のタイムスタンプが使用されます。
イベントID	ユニークなユーザーまたはセッションを識別できる任意のハッシュ化されたID。例えば、SessionID_RandomNumber。TikTokピクセルタグでイベントIDを生成をtrueに構成すると、このIDはすべてのTikTokトラッキングイベントで自動的に生成されます。
Limited Data Use	このフィールドは、イベントソースがWEBまたはAPPの場合にのみサポートされます。限定的なデータ処理構成。Limited Data Use機能の詳細については、TikTok: Limited Data Useを参照してください。

広告データ

パラメータ	説明
コールバック	TikTok広告とウェブサイト訪問イベントをマッチさせるために使用されるttclidの値。
キャンペーンID	キャンペーンID。
広告ID	広告ID。
リターゲティング中	ユーザーがユーザーをリターゲティングしているかどうか。
アトリビュートされた	イベントがプロバイダーにアトリビュートされているかどうか。
アトリビューションタイプ	アトリビューションのタイプ。
アトリビューションプロバイダー	アトリビューションプロバイダーの名前。

ページデータ

パラメータ	説明
リファラー	ページリファラー。
URL	イベントが発生した時のページURL。

ユーザーデータ

パラメータ	説明
ユーザーメール	（推奨）。SHA256でハッシュ化されたメールアドレス。
ユーザー電話番号	（推奨）。ユーザーの電話番号、SHA256でハッシュ化。国コードを+で含め、数字の間の他の文字（スペース、-）を削除します（例：USAの場合は+12125551212）。国コードが86の場合、国コードを含めないでください（例：13800000000）。
ユーザー外部ID	（推奨）。外部ユーザーID、SHA256でハッシュ化。
Cookie 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。
コンテンツカテゴリ	ページまたは商品のカテゴリ。
コンテンツ名	ページまたは商品の名前。
ブランド	商品アイテムのブランド。

自動マッピングの無効化

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

• TikTokクリックID (ttclid)
• ユーザーエージェント

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

カスタムイベント

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

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