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

バッチ制限

このコネクタは、ベンダーへの大量データ転送をサポートするためにバッチリクエストを使用します。詳細については、Batched Actionsを参照してください。リクエストは、次のいずれかの閾値に達するか、プロファイルが公開されるまでキューに入れられます：

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

コネクタアクション

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

構成

コネクタマーケットプレイスに移動し、新しいコネクタを追加します。コネクタの追加方法については、About Connectorsを参照してください。

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

シークレットキー：（必須）シークレットキー。
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で見えるようにし、バイヤーが利用できるように構成します。`true`に構成します。コンテナエレメントの場合、このプロパティ値を`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レートの通貨コード。
メディアコストの割合Rate	(オプション) `CPMRate`キャップと併用するメディアコストの割合。割合は小数で入力します。

アクション

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

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

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

パラメーター

パラメーター	説明
データプロバイダー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ハッシュ化済み)	既にSHA256ハッシュ化されたユーザーのUnified ID 2.0。
UID2Token (SHA256ハッシュを適用)	SHA256ハッシュが適用されるユーザーのUnified ID 2.0。
UID2	ユーザーのUnified ID 2.0を44文字のbase64エンコードされたSHA-256文字列として。詳細については、The Trade Desk Partner Portal: PII Normalization and Hash EncodingおよびUnified IDsを参照してください。
EUIDToken (既にSHA256ハッシュ化済み)	既にSHA256ハッシュ化されたユーザーのEuropean Unified ID。
EUIDToken (SHA256ハッシュを適用)	SHA256ハッシュが適用されるユーザーのEuropean Unified ID
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	（必須）Time to live（TTL）は、このユーザーが`TimeStampUtc`値に対してアクティブであるべき時間（分単位）です。TTLが期限切れになると、そのユーザーはターゲティングには使用されなくなります。最大TTLは259200分（180日）です。
タイムスタンプ	ユーザーがセグメントの対象となるタイムスタンプ。指定されていない場合、タイムスタンプはデータが処理された時点の時間に基づいて割り当てられます。このタイムスタンプは、ターゲティングおよび入札調整のためのユーザーの最新性を決定するために使用されます。