MediaMath Export Integration

Copy

• Copy for LLM

  Copy page as Markdown for LLMs
• View as Markdown

  Open this page as Markdown
• Open in ChatGPT

  Get insights from ChatGPT
• Open in Claude

  Get insights from Claude
• Cursorに接続

  CursorにMCPサーバーをインストール
• VS Codeに接続

  VS CodeにMCPサーバーをインストール

MediaMathプラットフォームを使用すると、マーケティングを管理し、効率的で効果的なオムニチャネルキャンペーンを提供できます。この連携により、Treasure Dataのジョブ結果をMediaMathサーバーに直接書き込むことができます。

前提条件

• TD Toolbeltを含む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/

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を選択します。

6. 認証の名前を作成します。

7. Doneを選択します。

クエリの定義

クエリには、idという名前の列が1つだけ必要です。他の列名はセグメント名になります。

MediaMathの連携パラメータ

クエリの例

クエリには、名前がidでデータ型が'String'の列が1つだけ必要です。他の列はセグメント名です。

custom object query

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 を選択します。

4. ドロップダウンで、次のスケジュールオプションのいずれかを選択します:

   ドロップダウン値	説明
   Custom cron...	Custom cron... の詳細を参照してください。
   @daily (midnight)	指定されたタイムゾーンで 1 日 1 回午前 0 時 (00:00 am) に実行します。
   @hourly (:00)	毎時 00 分に実行します。
   None	スケジュールなし。

Custom cron... の詳細

 *    *    *    *    *
 -    -    -    -    -
 |    |    |    |    |
 |    |    |    |    +----- 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.

各フィールド間には単一のスペースが必要です。各フィールドの値は、次のもので構成できます:

1. (オプション) Delay execution を有効にすることで、クエリの開始時刻を遅延させることができます。

クエリを実行する

クエリに名前を付けて保存して実行するか、単にクエリを実行します。クエリが正常に完了すると、クエリ結果は指定された宛先に自動的にエクスポートされます。

(オプション) Delay execution を有効にすることで、クエリの開始時刻を遅延させることができます。

Workflowでエクスポート結果を設定する(オプション)

Treasure Workflow内で、データコネクタを使用してデータをエクスポートすることを指定できます。

詳細については、Using Workflows to Export Data with the TD Toolbeltを参照してください。

actionは以下の値を受け付けます:

• Add
• Remove
• Data driven

_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