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料金の通貨コード。
メディアコストの割合	オプション。ハイブリッドデータ料金（料金タイプで選択）の`CPMRate`キャップと併用するメディアコストの割合。パーセンテージを小数で入力します。

アクション

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

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

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

パラメータ

パラメータ	説明
データプロバイダーID	必須。技術アカウントマネージャーから提供されるプロバイダーID。
TDID	このユーザーの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	必須。Time to live（TTL）は、このユーザーが`TimeStampUtc`値に対してアクティブである時間（分単位）です。TTLが満了すると、このユーザーはターゲティングには使用されなくなります。最大TTLは259200分（180日）。
タイムスタンプ	ユーザーがセグメントに適格であるときのタイムスタンプ。指定されていない場合、タイムスタンプはデータが処理される時点で割り当てられます。このタイムスタンプは、ターゲティングおよび入札調整のためのユーザーの最新性を決定するために使用されます。