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 |
---|---|---|
トラックイベントの送信 | ✓ | ✓ |
トラックエンドポイントを使用して、アプリ、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。 |
イベント時間 | イベントが発生した時刻をISO 8601形式 YYYY-MM-DDThh:mm:ssZ で。タイムスタンプが提供されていない場合は、現在のタイムスタンプが使用されます。 |
イベントID | ユニークなユーザーまたはセッションを識別できる任意のハッシュ化されたID。例えば、SessionID_RandomNumber 。TikTokピクセルタグでイベントIDを生成をtrue に構成すると、このIDはすべてのTikTokトラッキングイベントで自動的に生成されます。 |
限定データ使用 | このフィールドは、イベントソースがWEB またはAPP の場合にのみサポートされます。限定データ処理構成。限定データ使用機能の詳細については、TikTok:限定データ使用を参照してください。 |
広告データ
パラメータ | 説明 |
---|---|
コールバック | TikTok広告とウェブサイト訪問イベントをマッチさせるために使用されるttclid の値。 |
キャンペーン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。 |
コンテンツカテゴリ | ページまたは製品のカテゴリ。 |
コンテンツ名 | ページまたは製品の名前。 |
ブランド | 製品アイテムのブランド。 |
自動マッピングの無効化
コネクタはデフォルトで以下のパラメータを自動マッピングします:
- TikTokクリックID(
ttclid
) - ユーザーエージェント
自動マッピングを無効にするには、自動マッピングの無効化をtrue
に構成します。自動マッピングされたパラメータはベンダーに送信されません。
カスタムイベント
このコネクタのカスタムイベントを選択するには:
- イベントタイプカテゴリの下で、コンバージョンイベント名に
カスタム
を選択します。 - カスタムイベント名フィールドにカスタムイベント名を入力し、+ マッピングを追加をクリックします。
最終更新日 :: 2024年August月21日