The Trade Desk サードパーティデータコネクタ構成ガイド

このコネクタは現在コネクタマーケットプレイスで利用できません。The Trade Desk サードパーティデータコネクタを使用するには、TealiumとThe Trade Deskのアカウントマネージャーのサポートが必要です。このコネクタを使用するには、Tealiumのアカウントマネージャーに連絡してください。

API情報

このコネクタは以下のベンダーAPIを使用します：

API名：The Trade Desk API
APIバージョン：v3.0
APIエンドポイント：https://bulk-data.adsrvr.org
- データレートエンドポイント：POST /datarate/batch
- サードパーティエンドポイント：POST /data/thirdparty
ドキュメント：The Trade Desk API

バッチ制限

このコネクタは、ベンダーへの大量データ転送をサポートするためにバッチリクエストを使用します。並列処理により、イベントがベンダーに順不同で到達する可能性があります。順序が重要な場合は、イベントにシーケンス値を追加してください。詳細については、バッチアクションを参照してください。リクエストは、次のいずれかの閾値に達するか、プロファイルが公開されるまでキューに入れられます：

最大リクエスト数：10000
最古のリクエストからの最大時間：30分
リクエストの最大サイズ：2 MB

構成

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

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

シークレットキー：（必須）シークレットキー。
APIベースURL：（必須）APIベースURLを選択します。

管理者構成

認証トークンの生成

管理タスクを実行する前に、有効なユーザー名とパスワードで認証トークンを生成する必要があります。認証は管理タスクにのみ適用され、コネクタの動作には必要ありません。

ログイン：（必須）ログインを入力します。
パスワード：（必須）パスワードを入力します。

タクソノミーセグメントの作成

詳細については、The Trade Desk Partner Portal: Third-Party Data Taxonomy Designを参照してください。

パラメーター	説明
プロバイダーID	(必須) アカウントマネージャーが提供したプロバイダーアカウントの一意のIDです。
プロバイダーエレメントID	(必須) タクソノミー設計時にセグメントに割り当てられた一意のIDです。このIDは512文字以下でなければなりません。これは作成後に変更することはできません。
親エレメントID	(必須) タクソノミー内の親セグメントからのプロバイダーエレメントID値です。このパラメーターはタクソノミーの階層構造を確立します。これは作成後に変更することはできません。すべてのデータプロバイダーはタクソノミーの`ROOT`基本エレメントを使用します。
表示名	(必須) DMPユーザーインターフェースでバイヤーが見るセグメントの名前です。表示名は256文字以下である必要がありますが、特に下位の子エレメントのフルパスが長い場合は、読みやすさのために50文字以下を推奨します。タブや特殊文字（`'`, `"`, `^`など）は含めないでください。
購入可能	(必須) セグメントをDMPで見えるようにし、バイヤーが利用できるように構成します。コンテナエレメントの場合、このプロパティ値は`false`に構成します。これは、子エレメントを整理し、料金を割り当てるためにのみ使用されます。購入可能なセグメントのプロパティ値を`false`に変更した場合、そのセグメントをオーディエンスに持っている顧客はキャンペーンが終了するまでそれを使用できます。
説明	(オプション) DMPで顧客に表示されるデータセグメントの説明です。説明は4,000文字以下である必要がありますが、読みやすさのために256文字以下を推奨します。
直接IPターゲティング	(オプション) `true`の場合、使用または作成される`TargetingData`はデフォルトの`7`（`ThirdPartyData`）ではなく、タイプ`16`（`DirectIpTargeting`）です。

セグメントに料金を割り当てる

パラメーター	説明
プロバイダーID	(必須) アカウントマネージャーが提供したプロバイダーアカウントの一意のIDです。
プロバイダーエレメントID	(必須) このデータエレメントをシステムで識別する一意のIDです。
ブランドID	(必須) プロバイダーが管理するブランドの一意のIDです。
料金レベル	(必須) サードパーティデータの料金レベルです。アクセスをリクエストするには、技術アカウントマネージャーに連絡してください。 `Partner`: 特定のパートナーとその広告主のためのものです。 `Advertiser`: 特定の広告主のためのものです。この料金レベルには追加の許可が必要です。
パートナーID	(必須) この料金でデータセグメントにアクセスできるパートナーのプラットフォームIDです。
広告主ID	(必須) この料金でデータセグメントにアクセスできる広告主のプラットフォームIDです。
料金タイプ	(必須) セグメントのデータ料金タイプです。シンジケートされたタクソノミーのすべてのシステムレベルのデータ料金は、メディアコストの割合と最大CPM（千インプレッションあたりのコスト）キャップを使用するハイブリッド料金として割り当てられる必要があります。これは、このプロパティを`Hybrid`に構成し、`CPMRate`および`PercentOfMediaCostRate`の両方の値を提供する必要があることを意味します。カスタムタクソノミーは任意のデータ料金タイプを使用できますが、ハイブリッド料金が強く推奨されます。
CPM料金額	(必須) CPM料金額です。
CPM料金通貨コード	(必須) CPM料金の通貨コードです。
メディアコストの割合率	(オプション) `CPMRate`キャップと併用するメディアコストの割合です（料金タイプで選択されたハイブリッドデータ料金）。割合を小数で入力してください。

アクション

アクション名	AudienceStream	EventStream
サードパーティデータのアップロード	✓	✗
サードパーティデータの削除	✓	✗

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

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

サードパーティデータのアップロード

パラメーター

パラメーター	説明
データプロバイダーID	(必須) 技術アカウントマネージャーが提供したプロバイダーIDです。

ID

少なくとも1つのIDパラメータが必要です。複数のIDを同じリクエストに含めることができます。The Trade Deskは以下のIDをサポートしています：

パラメータ	説明
TDID	このユーザーのThe Trade Desk 36文字のGUID（ダッシュを含む）。
DAID	このユーザーの生デバイスIDを36文字のGUID形式（ダッシュを含む）で送信。iOSのIDFAまたはAndroidのAAIDを使用。
UID2Token (既にSHA256ハッシュ済み)	ユーザーのUnified ID 2.0、既にSHA256ハッシュ済み。
UID2Token (SHA256ハッシュを適用)	ユーザーのUnified ID 2.0にSHA256ハッシュを適用。
UID2	ユーザーのUnified ID 2.0を44文字のbase64エンコードされたSHA-256文字列として。詳細はThe Trade Desk Partner Portal: PII Normalization and Hash EncodingおよびUnified IDsを参照。
EUIDToken (既にSHA256ハッシュ済み)	ユーザーのEuropean Unified ID、既にSHA256ハッシュ済み。
EUIDToken (SHA256ハッシュを適用)	ユーザーのEuropean Unified IDにSHA256ハッシュを適用。
EUID	ユーザーのEuropean Unified IDを44文字のbase64エンコードされたSHA-256文字列として。詳細はThe Trade Desk Partner Portal: PII Normalization and Hash Encodingを参照。EUIDはヨーロッパおよび英国の市場要件に合わせたユーザーの透明性とプライバシー制御を提供し、UID2と同じメールアドレスの正規化とエンコーディングが必要です。詳細はThe Trade Desk Partner Portal: Unified IDsを参照。
IDL	49文字または70文字のRampID（以前はIdentityLinkとして知られていた）。この値はThe Trade Deskのために特別にマッピングされたLiveRampのRampIDでなければなりません。RampIDのマッピングについての詳細はLiveRamp: LiveRamp’s Sidecarを参照。

データ

パラメータ	説明
名前	（必須）セグメント名。最大128文字。
TTL in Minutes	（必須）Time to live (TTL) は、このユーザーが`TimeStampUtc`値に対してアクティブである時間（分）です。TTLが期限切れになると、そのユーザーはターゲティングには使用されなくなります。最大TTLは259200分（180日）。
Timestamp	ユーザーがセグメントに適格であるタイミングのタイムスタンプ。指定されていない場合、タイムスタンプはデータが処理された時点で割り当てられます。このタイムスタンプは、ターゲティングおよび入札調整のためのユーザーの最新性を決定するために使用されます。

第三者データの削除

パラメータ

パラメータ	説明
Data Provider ID	必須。技術アカウントマネージャーから提供されたプロバイダーID。
Request Type	オプトアウト: The Trade Deskは、IDのTTL値を`0`に構成することにより、データセグメントからIDをオプトアウトし、キャンペーンでのターゲティングを制限します。削除: The Trade Deskは、データセグメントおよび`REDS`フィードを含むデータセットからIDを削除します。