# MediaMath Export Integration MediaMathプラットフォームを使用すると、マーケティングを管理し、効率的で効果的なオムニチャネルキャンペーンを提供できます。この連携により、Treasure Dataのジョブ結果をMediaMathサーバーに直接書き込むことができます。 # 前提条件 - [TD Toolbelt](https://toolbelt.treasuredata.com/)を含むTreasure Dataの基本知識 - MediaMathアカウント # 要件と制限 - 正確な列名(大文字小文字を区別しない)とデータ型を持つ特定のクエリ列 - MediaMath SFTPサーバーにアップロードするデータファイルのサイズは4GBを超えることはできません ## Treasure Data Integration の静的 IP アドレス セキュリティポリシーで IP ホワイトリストが必要な場合は、接続を成功させるために Treasure Data の IP アドレスを許可リストに追加する必要があります。 リージョンごとに整理された静的 IP アドレスの完全なリストは、次のリンクにあります: [https://api-docs.treasuredata.com/en/overview/ip-addresses-integrations-result-workers/](https://api-docs.treasuredata.com/en/overview/ip-addresses-integrations-result-workers/) # TD Consoleを使用した接続の作成 MediaMathへの接続には2つのオプションをサポートしています。Treasure DataをData Providerとして使用するか、独自のMediaMath認証情報を使用することができます。独自の認証情報を使用することを推奨します。 ## 新しい接続の作成 Treasure Dataでは、クエリを実行する前にデータ接続を作成して設定する必要があります。データ接続の一部として、連携にアクセスするための認証を提供します。 1. **TD Console**を開きます。 2. **Integrations Hub** > **Catalog**に移動します。 3. **MediaMath**を検索して選択します。 4. **Create Authentication**を選択します。 5. Data Providerを選択します。**Treasure Data**または**User**アカウントのいずれかを選択できます。**Treasure Data**を選択した場合は、Continueを選択します。**User**を選択した場合は、認証するための認証情報を入力します。Continueを選択します。 ![](/assets/screen-shot-2022-08-11-at-13.05.09.ff61df61c639d122e96b1facd45aafbc219472faddb0496c4c20d5ec4cec8891.c2b3ba2d.png) 1. 認証の名前を作成します。 2. **Done**を選択します。 # クエリの定義 クエリには、`id`という名前の列が1つだけ必要です。他の列名はセグメント名になります。 ## MediaMathの連携パラメータ ![](/assets/image2021-12-9_14-12-27.27fa860a6dbecdc354e6c9bbe265b8e764df37a0d1ed4b2eed972d300acd0b37.c2b3ba2d.png) | **パラメータ** | 値 | **説明** | | --- | --- | --- | | Action | - Add All Segments - Remove All Segments - Update Segments Based On Data | | | Agency Name | | MediaMathのAgency Name。英数字のみ使用可能。 | | User Name Space | | IDがMediaMathから取得された場合はmmを使用します。IDが1Pの場合は、Partner Namespaceを使用します。アルファベットのみ使用可能で、空白または空にすることはできません。 | | Segment Name Space | | セグメントがMediaMathから取得された場合はmmを使用します。セグメントが1Pの場合は、Partner Namespaceを使用します。アルファベットのみ使用可能で、空白または空にすることはできません。 | | User Table Id | | Exchange IDは、MediaMath名前空間外のユーザーIDの照合テーブルを識別するために使用されます。User Name Spaceがmmでない場合は必須です。 | | Is Mobile? | | IDがモバイルまたはCTV IDの場合にチェックします | | Is Id GUID v4 format? | | IDがGUID Version 4形式の場合にチェックします | | Is Segment 32bit integer? | | Segment Identifierが32ビット整数(セグメント名が0～2^32)の場合にチェックします - このオプションがチェックされていない場合、セグメントは「Output Column Name」に入力された値になります - このオプションがチェックされている場合、セグメントは「SegmentId」に入力された値になります | | Skip Invalid Records | | チェックすると、データ行でエラーが識別された場合でも、エクスポートジョブは続行され、成功します。それ以外の場合、ジョブは失敗します。 | ## クエリの例 クエリには、名前が`id`でデータ型が'String'の列が1つだけ必要です。他の列はセグメント名です。 custom object query ```sql SELECT id, segment_1, segment_2 FROM your_table; ``` ### (オプション) Query Export ジョブをスケジュールする Scheduled Jobs と Result Export を使用して、指定したターゲット宛先に出力結果を定期的に書き込むことができます。 Treasure Data のスケジューラー機能は、高可用性を実現するために定期的なクエリ実行をサポートしています。 2 つの仕様が競合するスケジュール仕様を提供する場合、より頻繁に実行するよう要求する仕様が優先され、もう一方のスケジュール仕様は無視されます。 例えば、cron スケジュールが `'0 0 1 * 1'` の場合、「月の日」の仕様と「週の曜日」が矛盾します。前者の仕様は毎月 1 日の午前 0 時 (00:00) に実行することを要求し、後者の仕様は毎週月曜日の午前 0 時 (00:00) に実行することを要求するためです。後者の仕様が優先されます。 #### TD Console を使用してジョブをスケジュールする 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. 各フィールド間には単一のスペースが必要です。各フィールドの値は、次のもので構成できます: | フィールド値 | 例 | 例の説明 | | --- | --- | --- | | 各フィールドに対して上記で表示された制限内の単一の値。 | | | | フィールドに基づく制限がないことを示すワイルドカード `'*'`。 | `'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 を有効にすることで、クエリの開始時刻を遅延させることができます。 # Workflowでエクスポート結果を設定する(オプション) Treasure Workflow内で、データコネクタを使用してデータをエクスポートすることを指定できます。 詳細については、[Using Workflows to Export Data with the TD Toolbelt](https://api-docs.treasuredata.com/en/tools/cli/api/#workflow-commands)を参照してください。 actionは以下の値を受け付けます: - Add - Remove - Data driven ```yaml _export: td: database: mediamath_db +mediamath_export_task: td>: export.sql database: ${td.database} result_connection: new_created_mediamath_auth result_settings: action: add agency_name: agency_name id_name_space: mm segment_name_space: mm user_table_id: user_table_id is_mobile: true is_id_guid_format: true is_numeric_segment: true skip_invalid_records: true ```