# The Trade Desk CRM Data Integration Treasure DataからThe Trade Deskにジョブ結果を直接書き込むことができます。The Trade Deskでは、これらのData Exportを広告キャンペーンで使用できます。 ## 前提条件 - [TD Toolbelt](https://toolbelt.treasuredata.com/)を含むTreasure Dataの基本的な知識 - The Trade Deskのアカウント - 承認されたTreasure アカウントアクセス ## コネクタのユースケース - **Advertiser First-Party Data API by The Trade Desk Export connector** - 概要：広告主の顧客データベースをThe Trade Deskと同期する、より永続的な統合。 - 使用方法：ファーストパーティデータを資産として戦略的に常時使用。例えば、ロイヤルティプログラムメンバーをプラットフォームに継続的に同期し、長期間にわたって多くのキャンペーンで使用できるようにします。 - ビジネス価値：顧客ベースを広告の長期的な戦略的資産に変換します。キャンペーンごとのアップロードではなく、データは常にオーディエンス作成とターゲティングに利用可能です。 - **CRM Data Integration API by The Trade Desk CRM Data Export connector** - 概要：特定の顧客リスト（メール、電話番号など）をプラットフォームにアップロードしてセグメントを構築する方法。 - 使用方法：通常、キャンペーン固有または1回限りのユースケース向け。例えば、今後のキャンペーンから除外するために離脱顧客のリストをアップロードします。 - ビジネス価値：マーケターに迅速に行動する柔軟性を提供 - 「このグループを今すぐターゲットにしたい、または除外したい」。 ## Treasure コンソールを使用して接続を作成する Treasure コンソールを使用して接続を設定できます。 ### The Trade Deskで：Platform APIトークンの取得 **Manage API Tokens/Keys**に移動し、新しいトークン/キーを作成するか、既存のトークンを選択します ![](/assets/screenshot-2025-08-25-at-16.08.28.826f922815daffd0a238a54074173595d4dd50c760776792ca9c871d2baa2848.2291c8f6.png) ### Treasure Dataで：新しい接続の作成 1. Treasure コンソールから、**Integrations Hub**を選択します。 2. **Catalog**を選択します。 3. **The Trade Desk CRM Data** Outputコネクタを検索して選択します。 ![](/assets/screenshot-2025-09-11-at-10.49.38.c42564b93edfbcdf87b942f85d27839dea9bdfb263a2e3e08f36bb007f3b9470.95f75723.png) 4. **Create Authentication**を選択します。 New Authenticationダイアログが開きます。 ![](/assets/screenshot-2025-09-11-at-10.56.53.0826487fd581434fe6b86f1c2019f6022364e528aba0b4bbca22156c9bec8793.95f75723.png) 5. The Trade Deskから取得したCRM Data Tokenとadvertiser IDを編集し、**Continue**を選択します。 6. 接続の名前を入力します。 ![](/assets/tradedesknewauthb.1c83a3cb0dcb352f1b606312d0876c7ef00c89eb9f6f015a6d45062a4b51db64.7f5c9654.png) 7. **Done**を選択します。 The Trade Desk出力コネクタが作成されました。 ### データ接続でエクスポート結果を設定する このステップでは、クエリを作成または再利用します。クエリでデータ接続を設定します。場合によっては、クエリでカラムマッピングを定義する必要があります。 ### パラメータを指定して接続を設定する 1. Treasure コンソールにアクセスし、**Data Workbench > Queries**に移動します。 2. データをエクスポートするために使用するクエリを見つけて選択します。 3. クエリエディタの上部にある**Export Results**を選択します。 Choose Integrationダイアログが表示されます。 4. 検索ボックスにThe Trade Desk接続名を入力してフィルタし、接続を選択します。 5. パラメータを指定します： **Parameters**: - **CRM Data Segment ID**（オプション）：CRM Data Segment ID。**Segment Name**が空の場合は必須。 - **Segment Name**（オプション）：セグメント名。**CRM Data Segment ID**が空の場合は必須。 - **Merge Mode**（必須）：新しくアップロードされた個人識別情報（PII）を既存のデータとマージする方法。**Add**、**Replace**のいずれか。デフォルトは**Add** - **PII Type**（必須）：広告主が送信する個人識別データ（PII）のタイプ。ドロップダウンから選択します。[PII Types](/ja/int/the-trade-desk-crm-data-integration#h3_74552168)を参照してください。デフォルトは**Email**。 - **Time-to-Live (TTL)**（オプション）：マッピングプロセスによって生成された匿名化識別子の有効期間（分単位）。デフォルトは129,600（90日）。 - **Wait Until Finished**（オプション）：ジョブ実行がドロップ状態が最終状態に移行するまで待機するようにチェックします。デフォルトはfalse（未チェック）。 - **Max Wait Time**（オプション）：ジョブが完了するまでの最大時間（分単位）。デフォルトは720分（12時間）。許容値範囲は0〜1380（23時間）。 - **Skip invalid record(s)**（オプション）：無効なレコードをスキップして残りのすべてを処理する場合はチェックします。デフォルトはtrue（チェック済み） ### PII Type | Pii Type | Description | | --- | --- | | Email | メールアドレスとして送信されるPII。 | | EmailHashedUnifiedId2 | 正規化、SHA-256ハッシュ化、base64エンコードされたメールアドレスとして送信され、UID2への変換の準備ができているPII。 | | Phone | 電話番号として送信されるPII。 | | PhoneHashed | 正規化、SHA-256ハッシュ化、base64エンコードされた電話番号として送信されるPII | | UID2 | UID2とも呼ばれる生のUID2値。 この値は大文字と小文字を区別します。生のUID2はUID2 APIを使用して生成および管理されます。 | | UID2Token | 広告トークンとも呼ばれる暗号化されたUID2トークン。 このトークンは大文字と小文字を区別します。 トークンはUID2 APIを使用して生成および管理されます。 UID2 APIの詳細については、UID2 Endpointsを参照してください。UID2トークンの詳細については、Raw IDs vs. Tokensを参照してください。 | | EUID | EUIDとも呼ばれる生のEuropean Unified ID値。この値は大文字と小文字を区別します。EUIDは、UID2と同じPIIの正規化とエンコーディングにより、ヨーロッパ地域の市場要件を満たすように設計されたユーザーの透明性とプライバシー制御を提供します。 | | EUIDToken | 広告トークンとも呼ばれる暗号化されたEUIDトークン。このトークンは大文字と小文字を区別します。詳細については、Unified IDsを参照してください。 | | IDL | 49文字または70文字のRampID（以前はIdentityLinkとして知られていました） | | ID5 | ユーザーのID5。これらのIDを保持するデータプロバイダーは、必要な復号化キーを取得するためにID5に直接連絡する必要があります。ID5の詳細については、ID5サイトを参照してください。**重要**：ID5 IDはヨーロッパでのみサポートされており、復号化された形式である必要があります。 | | NetID | 70文字のbase64エンコード文字列としてのユーザーのnetID。netIDの詳細については、netID Developer Portalを参照してください。**重要**：このIDはヨーロッパでのみサポートされています。 | | FirstId | 通常フランスのパブリッシャーが設定する、ユーザーのFirst-id、ファーストパーティクッキー。First-idの詳細については、First-idサイトを参照してください。**重要**：このIDはヨーロッパでのみサポートされています。 | | TDID | このユーザーのThe Trade Desk 36文字GUID（ダッシュを含む）。 | | DAID | 36文字GUID形式（ダッシュを含む）で送信される、このユーザーの生のデバイスID。iOS IDFAまたはAndroidのAAIDを使用します。 | ### サンプル設定は次のとおりです： ![](/assets/screenshot-2025-08-25-at-14.47.02.de7ab4505b6641b0a8a5ba4d0f2da5888dbb88f7cbfed514ebe4e982818c9e34.2291c8f6.png) ### Data Validation - **PII**カラムは空であってはなりません。 - **Timestamp_utc**は空であってはなりません。カラムタイプは、datetime形式の文字列、または秒単位のdatetimeのlong型にすることができます。 ### The Trade Deskにデータを入力するためのクエリ例 Treasure Dataから、The Trade Desk用の接続に出力結果を指定して次のクエリを実行します： **Example Query** ```sql SELECT PII, timestamp_utc, VALUE, value_currency, Country, Region, metro, City, OrderId, td_1, td_2, td_3, privacy_type, is_applicable, consent_string FROM ( VALUES ('', '2025-08-11 03:25:25.675', 4.5, 'USD', 'US', 'Region', 56, 'City', 'order id', 'custom data 1', 'custom data 2', 'custom data 3', 'GPP', TRUE, 'consent string'), ('customer1@example.org', '2025-08-11 03:25:25.675', 4.5, 'USD', 'US', 'Region', 56, 'City', 'order id', 'custom data 1', 'custom data 2', 'custom data 3', 'GPP', TRUE, 'consent string'), ('customer2@example.org', NULL, 4.5, 'USD', 'US', 'Region', 56, 'City', 'order id', 'custom data 1', 'custom data 2', 'custom data 3', 'GPP', TRUE, 'consent string'), ('customer3@example.org', '2025-08-11 03:25:25.675', 4.5, 'USD', 'US', 'Region', 56, 'City', 'order id', 'custom data 1', 'custom data 2', 'custom data 3', 'GPP', FALSE, 'consent string') ) AS tbl ( PII, timestamp_utc, VALUE, value_currency, Country, Region, metro, City, OrderId, td_1, td_2, td_3, privacy_type, is_applicable, consent_string ); ``` ### (オプション) Query Export ジョブをスケジュールする Scheduled Jobs と Result Export を使用して、指定したターゲット宛先に出力結果を定期的に書き込むことができます。 Treasure Data のスケジューラー機能は、高可用性を実現するために定期的なクエリ実行をサポートしています。 2 つの仕様が競合するスケジュール仕様を提供する場合、より頻繁に実行するよう要求する仕様が優先され、もう一方のスケジュール仕様は無視されます。 例えば、cron スケジュールが `'0 0 1 * 1'` の場合、「月の日」の仕様と「週の曜日」が矛盾します。前者の仕様は毎月 1 日の午前 0 時 (00:00) に実行することを要求し、後者の仕様は毎週月曜日の午前 0 時 (00:00) に実行することを要求するためです。後者の仕様が優先されます。 #### Treasure コンソール を使用してジョブをスケジュールする 1. **Data Workbench > Queries** に移動します 2. 新しいクエリを作成するか、既存のクエリを選択します。 3. **Schedule** の横にある None を選択します。 ![](/assets/image2021-1-15_17-28-51.f1b242f6ecc7666a0097fdf37edd1682786ec11ef80eff68c66f091bc405c371.0f87d8d4.png) 4. ドロップダウンで、次のスケジュールオプションのいずれかを選択します: ![](/assets/image2021-1-15_17-29-47.45289a1c99256f125f4d887e501e204ed61f02223fde0927af5f425a89ace0c0.0f87d8d4.png) | ドロップダウン値 | 説明 | | --- | --- | | Custom cron... | [Custom cron... の詳細](#custom-cron-details)を参照してください。 | | @daily (midnight) | 指定されたタイムゾーンで 1 日 1 回午前 0 時 (00:00 am) に実行します。 | | @hourly (:00) | 毎時 00 分に実行します。 | | None | スケジュールなし。 | #### Custom cron... の詳細 ![](/assets/image2021-1-15_17-30-23.0f94a8aa5f75ea03e3fec0c25b0640cd59ee48d1804a83701e5f2372deae466c.0f87d8d4.png) | **Cron 値** | **説明** | | --- | --- | | `0 * * * *` | 1 時間に 1 回実行します。 | | `0 0 * * *` | 1 日 1 回午前 0 時に実行します。 | | `0 0 1 * *` | 毎月 1 日の午前 0 時に 1 回実行します。 | | "" | スケジュールされた実行時刻のないジョブを作成します。 | ``` * * * * * - - - - - | | | | | | | | | +----- day of week (0 - 6) (Sunday=0) | | | +---------- month (1 - 12) | | +--------------- day of month (1 - 31) | +-------------------- hour (0 - 23) +------------------------- min (0 - 59) ``` 次の名前付きエントリを使用できます: - Day of Week: sun, mon, tue, wed, thu, fri, sat. - Month: jan, feb, mar, apr, may, jun, jul, aug, sep, oct, nov, dec. 各フィールド間には単一のスペースが必要です。各フィールドの値は、次のもので構成できます: div | フィールド値 | 例 | 例の説明 | | --- | --- | --- | | 各フィールドに対して上記で表示された制限内の単一の値。 | | | | フィールドに基づく制限がないことを示すワイルドカード `'*'`。 | `'0 0 1 * *'` | 毎月 1 日の午前 0 時 (00:00) に実行するようにスケジュールを設定します。 | | 範囲 `'2-5'` フィールドの許可される値の範囲を示します。 | `'0 0 1-10 * *'` | 毎月 1 日から 10 日までの午前 0 時 (00:00) に実行するようにスケジュールを設定します。 | | カンマ区切りの値のリスト `'2,3,4,5'` フィールドの許可される値のリストを示します。 | `0 0 1,11,21 * *'` | 毎月 1 日、11 日、21 日の午前 0 時 (00:00) に実行するようにスケジュールを設定します。 | | 周期性インジケータ `'*/5'` フィールドの有効な値の範囲に基づいて、 スケジュールが実行を許可される頻度を表現します。 | `'30 */2 1 * *'` | 毎月 1 日、00:30 から 2 時間ごとに実行するようにスケジュールを設定します。 `'0 0 */5 * *'` は、毎月 5 日から 5 日ごとに午前 0 時 (00:00) に実行するようにスケジュールを設定します。 | | `'*'` ワイルドカードを除く上記の いずれかのカンマ区切りリストもサポートされています `'2,*/5,8-10'` | `'0 0 5,*/10,25 * *'` | 毎月 5 日、10 日、20 日、25 日の午前 0 時 (00:00) に実行するようにスケジュールを設定します。 | 1. (オプション) Delay execution を有効にすることで、クエリの開始時刻を遅延させることができます。 ### クエリを実行する クエリに名前を付けて保存して実行するか、単にクエリを実行します。クエリが正常に完了すると、クエリ結果は指定された宛先に自動的にエクスポートされます。 設定エラーにより継続的に失敗するスケジュールジョブは、複数回通知された後、システム側で無効化される場合があります。 (オプション) Delay execution を有効にすることで、クエリの開始時刻を遅延させることができます。 ## Audience Studio で Segment をアクティベートする Audience Studio で activation を作成することで、segment データをターゲットプラットフォームに送信することもできます。 1. **Audience Studio** に移動します。 2. parent segment を選択します。 3. ターゲット segment を開き、右クリックして、**Create Activation** を選択します。 4. **Details** パネルで、Activation 名を入力し、前述の Configuration Parameters のセクションに従って activation を設定します。 5. **Output Mapping** パネルで activation 出力をカスタマイズします。 ![](/assets/ouput.b2c7f1d909c4f98ed10f5300df858a4b19f71a3b0834df952f5fb24018a5ea78.8ebdf569.png) - Attribute Columns - **Export All Columns** を選択すると、変更を加えずにすべての列をエクスポートできます。 - **+ Add Columns** を選択して、エクスポート用の特定の列を追加します。Output Column Name には、Source 列名と同じ名前があらかじめ入力されます。Output Column Name を更新できます。**+ Add Columns** を選択し続けて、activation 出力用の新しい列を追加します。 - String Builder - **+ Add string** を選択して、エクスポート用の文字列を作成します。次の値から選択します: - String: 任意の値を選択します。テキストを使用してカスタム値を作成します。 - Timestamp: エクスポートの日時。 - Segment Id: segment ID 番号。 - Segment Name: segment 名。 - Audience Id: parent segment 番号。 1. **Schedule** を設定します。 ![](/assets/snippet-output-connector-on-audience-studio-2024-08-28.a99525173709da1eb537f839019fa7876ffae95045154c8f2941b030022f792c.8ebdf569.png) - スケジュールを定義する値を選択し、オプションでメール通知を含めます。 1. **Create** を選択します。 batch journey の activation を作成する必要がある場合は、[Creating a Batch Journey Activation](/products/customer-data-platform/journey-orchestration/batch/creating-a-batch-journey-activation) を参照してください。 ## TD ToolbeltとThe Trade Desk接続を使用する CLIからTD Toolbeltを使用してThe Trade Deskにエクスポートできます。 例 ```bash td query \ -d [database] \ -q "SELECT * FROM offline_conversion" \ --type presto \ --result '{ "type": "thetradedesk_crm_data", "crm_api_token": "xxx", "advertiser_id": "xxx", "crm_data_id": "xxx", "skip_invalid_records": true }' ``` ## Workflowでエクスポート結果を設定する（オプション） Treasure ワークフロー内で、このデータコネクタを使用してデータを出力することを指定できます。 ```yaml timezone: UTC _export: td: database: sample_datasets +td-result-into-target: td>: queries/sample.sql result_connection: your_connections_name result_settings: crm_api_token: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx advertiser_id: xxxxxx crm_data_id: xxx .... ``` データをエクスポートするには、[ワークフローでデータコネクタを使用する方法についての情報](https://docs.treasuredata.com/smart/project-product-documentation/using-integrations-to-import-data-with-td-workflows)を確認してください。 ## Appendix ### 統計ログ レコードのスキップとThe Trade Deskからのアップロード詳細の統計ログは、ジョブ実行の最後に表示されます。 ### プラグイン検証によるレコードスキップのサンプル ``` 2025-08-25 08:02:35.717 +0000 [INFO] (0001:transaction): ************* REPORT *************2025-08-25 08:02:35.717 +0000 [INFO] (0001:transaction): Total records: 42025-08-25 08:02:35.717 +0000 [INFO] (0001:transaction): Uploaded records: 12025-08-25 08:02:35.717 +0000 [INFO] (0001:transaction): Total skipped records: 32025-08-25 08:02:35.721 +0000 [WARN] (0001:transaction): Data error - Skip processing the record index [0]: The required field(s) is(are) null or empty: pii2025-08-25 08:02:35.721 +0000 [WARN] (0001:transaction): Data error - Skip processing the record index [2]: The required field(s) is(are) null or empty: timestamp_utc2025-08-25 08:02:35.721 +0000 [WARN] (0001:transaction): Data error - Skip processing the record index [3]: The required field(s) is(are) null or empty: timestamp_utc ``` ### The Trade Desk統計ログのサンプル ``` 2025-08-25 08:02:35.712 +0000 [WARN] (0025:task-0000): =========== UPLOAD STATISTIC FROM TTD ===========2025-08-25 08:02:35.712 +0000 [WARN] (0025:task-0000): ===== Total Records: 12025-08-25 08:02:35.712 +0000 [WARN] (0025:task-0000): ===== Valid Records: 12025-08-25 08:02:35.713 +0000 [WARN] (0025:task-0000): ===== Succeeded Records: 12025-08-25 08:02:35.713 +0000 [WARN] (0025:task-0000): ===== Failed Records: 02025-08-25 08:02:35.713 +0000 [WARN] (0025:task-0000): ===== Empty Records: 02025-08-25 08:02:35.713 +0000 [WARN] (0025:task-0000): ===== Ingested Records: 12025-08-25 08:02:35.713 +0000 [WARN] (0025:task-0000): ================================================= ``` ## See Also - [Scheduling Data Connector Job Execution from the CLI](/ja/int/scheduling-a-data-connector-job-execution-from-the-cli)