Yahoo 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サーバーをインストール

Yahoo! integrationは、広告目的で顧客セグメントをエクスポートします。

• Partnermatch API経由でユーザーIDをアップロードできます
• ユーザーとオーディエンス属性をYahoo!にアップロードできます

消費者は、ショッピング、バンキング、ニュース閲覧、ゲーム、動画視聴など、どこにいても、どのデバイスを使用していても、シームレスなオンライン体験を期待しています。Yahoo! Content Delivery Network(CDN)は、オンラインバンキング、eコマース、メディア配信において世界最大のブランドの一部から信頼されています。これは、顧客体験を向上させ、ロイヤルティを高める高品質、パフォーマンス、信頼性、スケールを提供するためです。

Yahoo!は次のことを支援します:

• 大規模にオーディエンスを魅了する。
• 適切なタイミングで適切な広告を配信する。
• DisneyとABCのデジタルブロードバンドメッセージングを統合する。

このトピックには以下が含まれます:

この統合で何ができますか?

• Yahoo!のファンベースと顧客ベースをマッチングして、最高のパーソナライズされた体験を提供します。
• カスタム属性を含め、TD上で作成されたセグメントをYahoo!と同期して、より良いカテゴリ化を提供し、パフォーマンスの高いキャンペーンを構築します。
• Yahoo! DMP広告ターゲティングのために、Yahoo!セグメントにオーディエンスをアップロードまたは削除します。

前提条件

• Treasure Dataの基本知識。
• Yahoo! DataX APIの基本知識
• Yahoo!サポートが提供するMDM ID

要件と制限事項

DataX APIは非同期方式で実行されます。コネクタからのすべての操作は、30分から1日以上の範囲で有効になります。ジョブ結果をダウンロードする必要がある場合は、TDサポートに連絡してください。

Yahoo!とプロバイダーの制限:

• 1時間あたり100回のAPI呼び出し
• 5GBの圧縮ファイルアップロード制限

TDはアップロードセグメントのステータスの監視をサポートしていません。TDログを確認することでステータスを監視できます。

MDM IDの取得

MDM IDについては、Yahoo!サポートにお問い合わせください。

TD Consoleを使用して接続を作成する

新しい接続を作成する

Treasure Dataでは、クエリを実行する前にデータ接続を作成して設定する必要があります。データ接続の一部として、統合にアクセスするための認証を提供します。

1. TD Consoleを開きます。
2. Integrations Hub > Catalogに移動します。
3. Yahoo!を検索して選択します。
4. Create Authenticationを選択します。
5. MDM IDを入力します。例: OH224。
6. 接続の名前を入力します。
7. Doneを選択します。

クエリを定義する

Yahoo!の統合パラメータ

各モードでサポートされている列

Pattern Match:

クエリ例

select  'abc@tese.com' as email, 'abc' as pxid
UNION ALL SELECT 'abc123@tese.com' as email, 'a12bc' as pxid
UNION ALL SELECT 'abcadcc@tese.com' as email, 'ab1231c' as pxid
select  'abc@tese.com' as email, 'abc' as pxid, '+112345678' as phone
UNION ALL SELECT 'abc123@tese.com' as email, 'a12bc' as pxid, '+134567182' as phone
UNION ALL SELECT 'abcadcc@tese.com' as email, 'ab1231c' as pxid, '+1456104632' as phone

Audience:

クエリ例

SELECT urn, CT01, GEN, seg_ts, seg_exp, att_ts, att_exp
FROM audiences

Taxonomy

Opt-out

Taxonomy

TaxonomyはYahooがパートナーのデータの階層的(またはフラット)な組織とその関連メタデータをインポートするのに役立ちます。タクソノミーのアップロードは、ユーザー/オーディエンスデータのアップロードの前提条件です。

一般的な概念

• TD Root: すべてのアカウントは単一のルート名"Private"(デフォルトID: TD0001)の下に作成されます。すべてのクライアントサブツリーは、このルートの下に追加する必要があります。
• 各アカウント(MDM IDで表される)には、単一のルートを持つ1つのツリー(アカウントツリー)のみがあります。例: Account A。
• 各ツリーノードのIDは、すべてのアカウントで一意です。
• 各ノードタイプはSEGMENTまたはATTRIBUTEのみを受け入れます

クライアントサブツリーを持つTreasure Data Taxonomyツリーの例:

+ Private (TD0001)   
  ├-- Account A
  |  ├── seg1 name(seg1)
  |  │   ├── seg1.1 name(seg1.1)
  |  │   └── seg1.2 name(seg1.2)
  |  └── root attribute name 100(root attribute 100)
  |      └── att1 name(att1)
  ├-- Account B
      ├--- Seg AB

コネクタはTaxonomyツリー構造アップロード用の4つのモードをサポートしています:

• Whole Structure
• Append Node
• Replace Node
• Delete Node

Whole Structure: これはTaxonomyのデフォルトモードです。ツリー構造全体をアップロードし、新しいノードのみを保持します。現在のアカウントツリーの古いノードは削除され、新しいツリーの新しいノードに置き換えられます。 検証:

• アカウントルートノードのID = null(データベースではparent_id = null)、ID列は必須です。
• 親を持たない孤立ノードは許可されていません。
• 各実行で削除できるのはリーフノードのみです。
• アカウントノードが存在しない場合、TDルートまたはPrivate(TD0001)に追加されます。

1つのルート(parent_id = null)のみが許可されます。

Append Node

既存のparentIdノードに単一ノードまたはサブツリーを追加します。会社ツリーが作成されていない場合、入力ルートで新しいツリーが作成され、TDルートの下に追加されます。

検証:

• アカウントツリーが存在しない場合、1つの入力ルートを持つ新しいアカウントツリーが作成され、Private(デフォルトID: TD0001)に追加されます。
• アカウントツリーが存在しない場合、クエリ結果で最大1つのルートノードが許可されます。
• アカウントツリーが存在する場合、クエリ結果でルートノードは許可されません。
• 会社ルートがnullでない場合、各ノードの親IDが存在する必要があります。
• 会社ツリーがnullでない場合、Append nodeを使用してはいけません。

例:

現在のアカウントツリー

root segment name 200 (root segment 200)
├── SEG Child 6 (seg6)
├── SEG Child 2 (seg2)
├── SEG Child 5 (seg5)
│   ├── SEG Child 5.1 (seg5.1)
│   └── SEG Child 5.2 (seg5.2)
├── SEG Child 4(seg4)
│   ├── SEG Child 4.3 (seg4.3)
│   └── SEG Child 4.1 (seg4.1)
└── SEG Child 3 (seg3)
    ├── SEG Child 3.1 (seg3.1)
    └── SEG Child 3.2 (seg3.2)

入力データ

SELECT parent_id, id, name, type
FROM 
(
   VALUES 
   ('TD0008','seg8.1','SEG 8.1','SEGMENT')
) tbl (parent_id,id,name,type);

期待されるツリーは以下のようになります:

root segment name 200 (root segment 200)
├── SEG Child 6 (seg6)
│   ├── SEG Child 6.1 (seg6.1)
│   └── SEG Child 6.2 (seg6.2)
├── SEG Child 2 (seg2)
├── SEG Child 5 (seg5)
│   ├── SEG Child 5.1 (seg5.1)
│   └── SEG Child 5.2 (seg5.2)
├── SEG Child 4 (seg4)
│   ├── SEG Child 4.3 (seg4.3)
│   └── SEG Child 4.1 (seg4.1)
├── SEG Child 3 (seg3)
│   ├── SEG Child 3.1 (seg3.1)
│   └── SEG Child 3.2 (seg3.2)
├── SEG 8 (seg8)
│   └── SEG Child 8.1 (seg8.1)
└── SEG 7 (seg7)

Replace Node既存のタクソノミーノードとそのサブツリーを新しいタクソノミーデータで置き換えます。会社ルートまたはTDルートを置き換えることはできません。会社ルートのサブツリーのみを置き換えることができます。

検証:

• この操作を行うには、アカウントツリーが存在する必要があります。
• 入力サブツリーのルートは空であってはなりません。
• アカウントルートの置き換えは許可されていません。
• TDルート(Private)の置き換えは許可されていません。
• 入力ツリーのルートノードはアカウントツリーの下にある必要があります。

例

以下のようなアカウントツリーがあります

Sample TD Segment(TD0002)
├── Child 1(TD0003)
│   └── Child 1.1(TD0007)
│       └── Child 1.1.1(TD0008)
│           └── SEG 8.1(seg8.1)
└── Child 2(TD0004)
    ├── Child 2.1(TD005)
    │   └── Child 2.1.1(TD005_1)
    └── Child 2.2(TD0006)
        └── Child 2.2.2(TD0006_1)

SQLデータからこの階層を構築することを期待します

SELECT parent_id, id, name, type
FROM 
(
   VALUES 
   ('','TD0007','Child 1.1','SEGMENT'),
   ('TD0007','TD0008','Child 1.1.1','SEGMENT'),
   ('TD0007','TD0009','Child 1.1.2','SEGMENT'),
   ('TD0007','TD0010','Child 1.1.3','SEGMENT')
) tbl (parent_id,id,name,type);

期待されるツリーは以下のようになります

Sample TD Segment(TD0002)
├── Child 1(TD0003)
│   └── Child 1.1(TD0007)
│       ├── Child 1.1.2(TD0009)
│       ├── Child 1.1.1(TD0008)
│       └── Child 1.1.3(TD0010)
└── Child 2(TD0004)
    ├── Child 2.1(TD005)
    │   └── Child 2.1.1(TD005_1)
    └── Child 2.2(TD0006)
        └── Child 2.2.2(TD0006_1)

Replace Nodeサブツリーと共に既存のタクソノミーノードを削除します。

検証:

• ツリールート(アカウントルートまたはTDルート)の削除は許可されていません。
• ノードはnullであってはならず、アカウントツリーに存在する必要があります。
• この操作を行うには会社ツリーが存在する必要があります。

例:

以下のようなアカウントツリーがあります

Sample TD Segment(TD0002)
├── Child 1(TD0003)
│   └── Child 1.1(TD0007)
│       └── Child 1.1.1(TD0008)
└── Child 2(TD0004)
    ├── Child 2.1(TD005)
    │   └── Child 2.1.1(TD005_1)
    └── Child 2.2(TD0006)
        └── Child 2.2.2(TD0006_1)

SQLデータからこの階層を構築することを期待します

SELECT parent_id,id,name,type
FROM 
(
   VALUES 
   ('','TD005_1','Child 2.1.1','SEGMENT')
)tbl (parent_id,id,name,type);

期待されるツリーは以下のようになります

Sample TD Segment(TD0002)
├── Child 1(TD0003)
│   └── Child 1.1(TD0007)
│       └── Child 1.1.1(TD0008)
└── Child 2(TD0004)
    ├── Child 2.1(TD005)
    └── Child 2.2(TD0006)
        └── Child 2.2.2(TD0006_1)

(Optional) Schedule Query Export Jobs

You can use Scheduled Jobs with Result Export to periodically write the output result to a target destination that you specify.

Treasure Data's scheduler feature supports periodic query execution to achieve high availability.

When two specifications provide conflicting schedule specifications, the specification requesting to execute more often is followed while the other schedule specification is ignored.

For example, if the cron schedule is '0 0 1 * 1', then the 'day of month' specification and 'day of week' are discordant because the former specification requires it to run every first day of each month at midnight (00:00), while the latter specification requires it to run every Monday at midnight (00:00). The latter specification is followed.

Scheduling your Job Using TD Console

1. Navigate to Data Workbench > Queries

2. Create a new query or select an existing query.

3. Next to Schedule, select None.

4. In the drop-down, select one of the following schedule options:

   Drop-down Value	Description
   Custom cron...	Review Custom cron... details.
   @daily (midnight)	Run once a day at midnight (00:00 am) in the specified time zone.
   @hourly (:00)	Run every hour at 00 minutes.
   None	No schedule.

Custom cron... Details

 *    *    *    *    *
 -    -    -    -    -
 |    |    |    |    |
 |    |    |    |    +----- day of week (0 - 6) (Sunday=0)
 |    |    |    +---------- month (1 - 12)
 |    |    +--------------- day of month (1 - 31)
 |    +-------------------- hour (0 - 23)
 +------------------------- min (0 - 59)

The following named entries can be used:

• Day of Week: sun, mon, tue, wed, thu, fri, sat.
• Month: jan, feb, mar, apr, may, jun, jul, aug, sep, oct, nov, dec.

A single space is required between each field. The values for each field can be composed of:

1. (Optional) You can delay the start time of a query by enabling the Delay execution.

Execute the Query

Save the query with a name and run, or just run the query. Upon successful completion of the query, the query result is automatically exported to the specified destination.

(Optional) You can delay the start time of a query by enabling the Delay execution.

Activate a Segment in Audience Studio

You can also send segment data to the target platform by creating an activation in the Audience Studio.

1. Navigate to Audience Studio.
2. Select a parent segment.
3. Open the target segment, right-mouse click, and then select Create Activation.
4. In the Details panel, enter an Activation name and configure the activation according to the previous section on Configuration Parameters.
5. Customize the activation output in the Output Mapping panel.

• Attribute Columns
  • Select Export All Columns to export all columns without making any changes.
  • Select + Add Columns to add specific columns for the export. The Output Column Name pre-populates with the same Source column name. You can update the Output Column Name. Continue to select + Add Columnsto add new columns for your activation output.
• String Builder
  • + Add string to create strings for export. Select from the following values:
    • String: Choose any value; use text to create a custom value.
    • Timestamp: The date and time of the export.
    • Segment Id: The segment ID number.
    • Segment Name: The segment name.
    • Audience Id: The parent segment number.

6. Set a Schedule.

• Select the values to define your schedule and optionally include email notifications.

7. Select Create.

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

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

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

Yahoo!設定キー

Yahoo!のワークフロー例

_export:
  td:
  database: td.database
 
+verizon_media_export_task:
  td>: export_verizon_media.sql
  database: ${td.database}
  result_connection: verizon_media
  result_settings:
    type: verizon_media
    upload_mode: audience
    urn_type: Email

(オプション)CLIを使用したエクスポート統合

TD Toolbeltが提供するCLIを使用して、クエリ結果をYahoo!にエクスポートすることもできます。

td queryコマンドを使用する場合、--result RESULT_URLオプションでLINE変換サーバーURLを指定します。詳細については、td queryを参照してください。

オプションの形式はJSONで、一般的な構造は以下のとおりです。

{
  "type": "verizon_media",
  "mdm_id": "100",
  "upload_mode": "taxonomy",
  "taxonomy_mode": "append_node"
}

パラメータ

使用例

td query \
  --result '{
    "type": "verizon_media",
    "upload_mode": "taxonomy",
    "taxonomy_mode": "append_node",
    "mdm_id": "100"
  }' \
  -d sample_datasets \
  "SELECT * FROM verizon_media_tbl" \
  -T presto