The Trade Desk リアルタイムコンバージョンイベントコネクタ構成ガイド
この記事では、The Trade Desk リアルタイムコンバージョンイベントコネクタの構成方法について説明します。
動作原理
The Trade Desk（TTD）リアルタイムコンバージョンイベントサーバーサイドコネクタは、TealiumからTTDインスタンスへのコンバージョンイベントデータのシームレスな統合を可能にし、アトリビューションの追跡とリターゲティングを支援します。
このコネクタは、TealiumとThe Trade Deskのパートナーシップからの他の統合とともにエンリッチメントされます。Unified ID 2.0（UID2）またはEuropean Unified ID（EUID）Functionを使用して、イベントデータを送信する前にユニバーサルユーザー識別子を生成して割り当てます。オプションで、Tealium iQタグ管理にTTDユニバーサルピクセルを実装して、リアルタイムでユーザーの行動を包括的に捉えます。
必要なすべてのパラメータが生成され、利用可能であることを確認するために、割り当てられたTTD担当者と協力することを強く推奨します。
API情報
このコネクタは以下のベンダーAPIを使用します：
- API名：The Trade Desk API
- APIバージョン：v3
- APIエンドポイント：
https://insight.adsrvr.org - ドキュメント：The Trade Desk API
アクション
| アクション名 | AudienceStream | EventStream |
|---|---|---|
| コンバージョンイベントを送信 | ✗ | ✓ |
構成
コネクタマーケットプレイスに移動して新しいコネクタを追加します。コネクタを追加する一般的な手順については、コネクタについてを参照してください。
The Trade Deskリアルタイムコンバージョンコネクタは、イベントマッピングとURLマッピングの追跡をサポートしています。コネクタを構成する際は、アプローチに応じて以下のパラメータを構成します：
- URLマッピング - このアプローチでは、ユーザーが訪れたページのURLがTTDプラットフォーム内でリターゲティングとコンバージョン測定の基盤として割り当てられます。
- ユーザーが閲覧するページに焦点を当てるウェブサイトに推奨されます。
- TTDユニバーサルピクセルタグと同じ方法論を使用します。
- 構成パラメータ：広告主IDおよびユニバーサルピクセルID。
- イベントマッピング - このアプローチでは、イベント名（例：
Purchase、Addtocart）を使用してコンバージョンをキャプチャし、オプションで関連する商業製品の詳細があります。イベント名と製品は、リターゲティングとコンバージョン測定の基盤としてTTDプラットフォーム内で評価されます。- 構成パラメータ：マーチャントIDおよびイベントトラッカーID。
コネクタを追加した後、次の構成を構成します：
- 広告主ID
マーチャントIDが提供されていない場合に必要です。トラッキングコールが行われた広告主のadvertiserIdです。 - マーチャントID
広告主IDが提供されていない場合に必要です。TTDのオンボーディングプロセス中に提供されるmerchantIdです。 - ピクセルID
イベントトラッカーIDが提供されていない場合に必要です。イベントのユニバーサルピクセルIDです。 - イベントトラッカーID
ピクセルIDが提供されていない場合に必要です。イベントトラッカーのプラットフォームIDです。
広告主IDを提供してユニバーサルピクセルIDを提供しない場合、コネクタリクエストはエラーを返します。 また、構成ウィンドウのすべてのパラメータを入力することを避け、選択したアプローチにのみ値を提供することをお勧めします。たとえば、広告主IDとマーチャントIDの両方を提供するのではなく、トラッキング方法論に必要な構成のみを入力してください。
アクション
次のセクションでは、各アクションのサポートされるパラメータをリストします。
コンバージョンイベントを送信
イベントがTTDインスタンス内で適切に定義されていることを確認してください。そうでない場合、TTDから402エラーが発生する可能性があります。
パラメータ
| パラメータ | 説明 |
|---|---|
| コンバージョンイベント名 | パートナープラットフォームによって定義されたイベントのタイプ。利用可能なイベントタイプ：
|
ユーザー識別子パラメータ
| パラメータ | 説明 |
|---|---|
| UID2 | ユーザーのUnified ID 2.0で、44文字のbase64エンコードされたSHA-256文字列です。詳細については、UID2を生成するための関数の使用およびTTD: Unified IDsを参照してください。 |
| EUID | ユーザーのEuropean Unified IDで、44文字のbase64エンコードされたSHA-256文字列です。詳細については、EUIDを生成するための関数の使用およびUnified IDsを参照してください。 |
| TDID | このユーザーのThe Trade Desk 36文字のGUID（ダッシュを含む）です。The Trade Desk Cookie Matching Service Tagを通じて取得できます。 |
| IDFA | iOSデバイスの広告識別子です。 |
| AAID | Androidデバイスの広告識別子です。 |
| DAID | このユーザーの生のデバイスIDで、36文字のGUID形式（ダッシュを含む）で送信されます。 |
| NAID | Windowsデバイスの広告識別子です。 |
| IDL | 49文字または70文字のRampID（以前はIdentityLinkとして知られていました）。 注意：これはLiveRampがThe Trade Desk用に特別にマッピングしたRampIDでなければなりません。RampIDのマッピングについての詳細は、LiveRampドキュメントを参照してください。 |
イベントパラメータ
次のパラメータは、コンバージョンイベントに関連しており、説明に記載されている特定のイベントを除き、オプションです。
| パラメータ | 説明 |
|---|---|
| Order ID | イベントの関連注文識別子です。 |
| Referrer URL | イベントが発生したウェブサイトのURL（該当する場合）。URLマッピングを使用する場合に必要です。 |
| Purchase Value | 収益追跡値で、小数点としてピリオド（コンマではない）を使用します。 |
| Purchase Currency | 収益値のISO 4217通貨コードです。購入イベントの場合に必要です。 |
| Client IP Address | マシン上のネットワークインターフェースを一意に識別するクライアントのIPv4またはIPv6 IPアドレスです。 |
| Impression ID | イベントインプレッションの一意のIDとして機能する36文字の文字列（ダッシュを含む）です。 |
アイテムパラメータ
アイテムをマッピングする場合、複数のアイテムを割り当てるために文字列データ属性の配列を使用します。受信したコンバージョンイベントから適切なデータでマッピングされた属性が入力されていることを確認してください。
| パラメータ | 説明 |
|---|---|
Item Code |
（必須）アイテム識別子、例えばSKU番号です。 |
name |
アイテムコードに関連する名前です。 |
qty |
注文内のアイテムコードのアイテム数です。 |
price |
アイテムの単価です。 |
cat |
アイテムカテゴリIDです。注意：リアルタイムコンバージョンイベントAPIは、指定されたアイテムコードが含まれているが異なるカテゴリIDの製品カタログを持つマーチャントの場合を除き、提供された値をすべてのケースで使用します。その場合、製品カタログのカテゴリIDが使用されます。 |
プライバシー構成のプロパティ
すべてのプライバシー構成プロパティは必須です。
| パラメータ | 説明 |
|---|---|
privacy_type |
次の値からオブジェクトごとに1つの値のみ:
|
is_applicable |
privacy_type パラメータで指定された値が適用可能かどうかを示します。 |
consent_string |
プライバシー規制が有効な場合のユーザーの同意。詳細については、IAB Tech Lab: GDPR 透明性と同意フレームワークを参照してください。 |
カスタムプロパティ
新規ブランド、製品名、レポートに役立つその他の詳細など、追加のコンバージョンメタデータを提供するために使用できる、連番のカスタムダイナミックプロパティ（td1 から td10 まで）。
最終更新日 :: 2025年October月15日