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 Universal Pixelを実装して、ユーザーの行動をリアルタイムで包括的にキャプチャします。

必要なすべてのパラメータが生成され、利用可能であることを確認するために、指定された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 Universal Pixel tagと同じ方法論を使用します。
- 構成パラメータ：広告主IDとUniversal Pixel ID。
イベントマッピング - このアプローチでは、コンバージョンはイベント名（例：Purchase、Addtocart）とオプションの関連コマース製品詳細を使用してキャプチャされます。イベント名と製品は、リターゲティングとコンバージョン測定の基礎としてTTDプラットフォーム内で評価されます。
- 構成パラメータ：Merchant IDとEvent Tracker ID。

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

広告主ID
Merchant IDが提供されていない場合に必要です。トラッキングコールが行われた広告主のadvertiserIdです。
Merchant ID
広告主IDが提供されていない場合に必要です。merchantIdはTTDからオンボーディングプロセス中に提供されます。
Pixel ID
Event Tracker IDが提供されていない場合に必要です。イベントのユニバーサルピクセルIDです。
Event Tracker ID
Pixel IDが提供されていない場合に必要です。イベントトラッカーのプラットフォームIDです。

広告主IDを提供し、Universal Pixel IDを提供しない場合、コネクタリクエストはエラーを返します。また、構成ウィンドウのすべてのパラメータに値を入力するのではなく、選択したアプローチの値のみを提供することをお勧めします。例えば、広告主IDとMerchant IDの両方を提供するべきではありません。代わりに、トラッキング方法に必要な構成を入力します。

アクション

以下のセクションでは、各アクションのサポートされるパラメータをリストします。

コンバージョンイベントの送信

イベントが適切にTTDインスタンス内で定義されていることを確認してください。そうでない場合、TTDから402エラーが発生する可能性があります。

パラメータ

パラメータ 説明

コンバージョンイベント名

パラメータ	説明
コンバージョンイベント名	パートナープラットフォームで定義されたイベントの種類。利用可能なイベントタイプ： `addtocart`：ユーザーがショッピングカートにアイテムを追加しました。 `purchase`：ユーザーが購入を完了し、Thank You pageが表示されました。 `viewitem`：ユーザーがアイテムまたはSKU番号を表示しました。 `searchitem`：ユーザーがアイテムまたはSKU番号を検索しました。 `searchcategory`：ユーザーがカテゴリを検索しました。 `login`：ユーザーがサイトにログインしました。 `messagebusiness`：ユーザーがビジネスにメッセージを送った、またはフォームやメールでビジネスに連絡しました。 `direction`：ユーザーがビジネスへの道順をリクエストし、受け取りました。 `startcheckout`：ユーザーがチェックアウトプロセスを開始しました。 `viewcart`：ユーザーがショッピングカートの内容を表示しました。 `sitevisit`：ユーザーがサイトを訪れました。 `wishlistitem`：ユーザーがアイテムまたはSKU番号をウィッシュリストに追加しました。

パートナープラットフォームで定義されたイベントの種類。利用可能なイベントタイプ：

addtocart：ユーザーがショッピングカートにアイテムを追加しました。
purchase：ユーザーが購入を完了し、Thank You pageが表示されました。
viewitem：ユーザーがアイテムまたはSKU番号を表示しました。
searchitem：ユーザーがアイテムまたはSKU番号を検索しました。
searchcategory：ユーザーがカテゴリを検索しました。
login：ユーザーがサイトにログインしました。
messagebusiness：ユーザーがビジネスにメッセージを送った、またはフォームやメールでビジネスに連絡しました。
direction：ユーザーがビジネスへの道順をリクエストし、受け取りました。
startcheckout：ユーザーがチェックアウトプロセスを開始しました。
viewcart：ユーザーがショッピングカートの内容を表示しました。
sitevisit：ユーザーがサイトを訪れました。
wishlistitem：ユーザーがアイテムまたはSKU番号をウィッシュリストに追加しました。

ユーザー識別子パラメータ

パラメータ	説明
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として知られていました）。注：これは、The Trade Desk専用にマッピングされたLiveRampからのRampIDでなければなりません。RampIDのマッピングについての詳細は、LiveRamp documentationを参照してください。

イベントパラメータ

以下のパラメータは、コンバージョンイベントに関連し、説明で特定のイベントに必要とされていない限り、オプションです。

パラメータ	説明
注文ID	イベントに関連する注文識別子。
リファラーURL	イベントが発生したウェブサイトのURL（ある場合）。URLマッピングを使用している場合は必須です。
購入価格	小数点（カンマではなく）を含む収益追跡値。
購入通貨	収益値のISO 4217通貨コード。購入イベントに必要です。
クライアントIPアドレス	マシン上のネットワークインターフェースを一意に識別するクライアントのIPv4またはIPv6 IPアドレス。
インプレッションID	イベントインプレッションの一意のIDとして機能する36文字の文字列（ダッシュを含む）。

アイテムパラメータ

アイテムをマッピングするときは、複数のアイテムを割り当てるために文字列データ属性の配列を使用します。マッピングされた属性が受け取ったコンバージョンイベントから適切なデータで入力されていることを確認してください。

パラメータ	説明
`Item Code`	(必須) アイテム識別子、例えばSKU番号。
`name`	アイテムコードに関連付けられた名前。
`qty`	注文内のアイテムコードのアイテム数。
`price`	アイテムの単価。
`cat`	アイテムのカテゴリID。注：Real-Time Conversion Events APIは、指定されたアイテムコードが含まれているが、異なるカテゴリIDがある商品カタログを持つマーチャントの場合を除き、提供された値を使用します。この場合、商品カタログのカテゴリIDが使用されます。

プライバシー構成プロパティ

3つのプライバシー構成プロパティすべてが必要です。

パラメータ	説明
`privacy_type`	次の値から1つだけをオブジェクトごとに指定します： GDPR（一般データ保護規則、欧州経済領域（EEA）に適用） CCPA（カリフォルニア消費者プライバシー法）
`is_applicable`	`privacy_type`パラメータで指定された値が適用可能かどうかを示します。CCPAの場合、クライアントのIPアドレスがCCPAが適用可能かどうかを判断するために使用されます。
`consent_string`	プライバシー規制が適用されている場合のユーザーの同意。詳細については、IAB Tech Lab: GDPR透明性と同意フレームワークを参照してください。

カスタムプロパティ

新規ブランドへのフラグ、製品名、レポート作成に役立つその他の詳細など、追加のコンバージョンメタデータを提供するために使用できる、順番に番号が付けられた10のカスタム動的プロパティ（td1からtd10まで）。