The Trade Desk リアルタイムコンバージョンイベントコネクタ設定ガイド
この記事では、The Trade Desk リアルタイムコンバージョンイベントコネクタの設定方法について説明します。
API情報
このコネクタは以下のベンダーAPIを使用します：
- API名：The Trade Desk API
- APIバージョン：v3
- APIエンドポイント：
https://insight.adsrvr.org - ドキュメンテーション：The Trade Desk API
アクション
| アクション名 | AudienceStream | EventStream |
|---|---|---|
| コンバージョンイベントの送信 | ✗ | ✓ |
設定
コネクタマーケットプレイスに移動し、新しいコネクタを追加します。コネクタの追加方法の一般的な指示については、コネクタについてを参照してください。
コネクタを追加した後、以下の設定を行います：
- 広告主ID
必須。広告主プラットフォームID。 - 暗号化キー
暗号化キー。
アクション
以下のセクションでは、各アクションでサポートされているパラメータをリストします。
コンバージョンイベントの送信
パラメータ
| パラメータ | 説明 |
|---|---|
| コンバージョンイベント名 | パートナープラットフォームで定義されたイベントの種類。利用可能なイベントタイプ：
|
パラメータ
| パラメータ | 説明 |
|---|---|
| イベントトラッカーID | イベントトラッカーのプラットフォームID。 |
| ピクセルID | イベントのユニバーサルピクセルID。詳細については、The Trade Desk: Universal Pixelを参照してください。 |
| 購入価格 | 小数点（カンマではなく）を含む収益追跡値。 |
| 購入通貨 | 収益値のISO 4217通貨コード。 |
| クライアントIPアドレス | マシン上のネットワークインターフェースを一意に識別するクライアントのIPv4またはIPv6 IPアドレス。 |
| リファラーURL | イベントが発生したウェブサイトのURL（ある場合）。 |
| TDID | このユーザーのThe Trade Desk 36文字のGUID（ダッシュを含む）。 |
| IDFA | iOSデバイスの広告識別子。 |
| AAID | Androidデバイスの広告識別子。 |
| DAID | このユーザーの生のデバイスID、36文字のGUID形式（ダッシュを含む）で送信されます。 |
| NAID | Windowsデバイスの広告識別子。 |
| IDL | 49文字または70文字のRampID（以前はIdentityLinkとして知られていました）。 注：これは、The Trade Desk専用にマッピングされたLiveRampからのRampIDでなければなりません。RampIDのマッピングについての詳細は、LiveRamp documentationを参照してください。 |
| EUID | ユーザーのヨーロッパ統一IDを44文字のbase64エンコードされたSHA-256文字列として表します。詳細については、The Trade Desk: PII Normalization and Hash EncodingおよびUnified IDsを参照してください。EIUDは、ヨーロッパと英国の市場要件を満たすように設計されたユーザーの透明性とプライバシーコントロールを提供し、UID2と同じメールアドレスの正規化とエンコーディングを必要とします。 |
| UID2 | ユーザーの統一ID 2.0を44文字のbase64エンコードされたSHA-256文字列として表します。詳細については、The Trade Desk: PII Normalization and Hash EncodingおよびUnified IDsを参照してください。 |
| インプレッションID | イベントインプレッションの一意のIDとして機能する36文字の文字列（ダッシュを含む）。 |
| 注文ID | イベントの関連注文識別子。 |
| トークン | イベントのアップロードに使用されるパートナーによるユーザーの一意のID。 |
| イベントがTTDに帰属 | イベントがThe Trade Deskに帰属するかどうかを示すフラグ。trueに設定されている場合、The Trade Deskはイベントを指定されたインプレッションID（IMP値）に帰属し、The Trade Deskの帰属モデルをバイパスし、パートナーが広告主に提供する帰属結果と一致します。 |
| イベントビュースルー | イベントがビュースルーコンバージョンであるかどうかを示すフラグ。 |
アイテム
| パラメータ | 説明 |
|---|---|
| アイテムコード | (必須) アイテム識別子、例えばSKU番号。 |
| 名前 | アイテムコードに関連付けられた名前。 |
| 数量 | アイテムコードの注文内アイテム数。 |
| 価格 | アイテムの単価。 |
| カテゴリ | アイテムカテゴリID。注：リアルタイムコンバージョンイベントAPIは、指定されたアイテムコードを含む商品カタログがあるが、カテゴリIDが異なる場合を除き、提供された値をすべてのケースで使用します。この場合、商品カタログのカテゴリIDが使用されます。 |
プライバシー設定プロパティ
| パラメータ | 説明 |
|---|---|
| プライバシータイプ | (必須) 以下の適用可能な値からオブジェクトごとに1つの値のみ：
|
| 適用可能 | (必須) privacy_typeパラメータで指定された値が適用可能かどうかを示します。CCPAの場合、クライアントのIPアドレスがCCPAが適用可能かどうかを判断するために使用されます。 |
| 同意文字列 | プライバシー規制が適用される場合のユーザーの同意。詳細については、IAB Tech Lab: GDPR Transparency and Consent Frameworkを参照してください。 |
カスタムパラメータ
追加のコンバージョンメタデータを提供するために使用できる、10個の順序付けられたカスタム動的プロパティ。
最終更新日 :: 2024年May月30日