# Yahoo Japan Ads V2 Export Integration

Yahoo! JAPAN Adsは、シンプルな設定、さまざまなマーケティングチャネル、柔軟な拡張性により、企業のマーケティング活動をサポートします。Yahoo! JAPAN独自のさまざまな広告配信側面により、戦略的なマーケティングコミュニケーションが可能になります。

この統合により、Treasure Dataは、Yahoo! JAPAN Ads上でオーディエンスリストを作成し、このリストにファーストパーティデータをアップロードすることで、ユーザーセグメントをYahoo! JAPAN Adsに送信できるようにします。

## 前提条件

- Treasure Dataアカウント
- Yahoo! JAPAN Adsアカウント
- ユーザーはMCCアカウントへのアクセス権を持ち、ツール管理者権限（Tool admin）を持っている必要があります


## 制限事項

- この統合はYahoo! JAPANにファイルをアップロードします。アップロードが失敗する可能性があり、お客様はYahoo! JAPAN Adsコンソールを確認して結果を検証する必要があります。


## Yahoo! JAPAN Adsへのエクスポート

### Yahoo! JAPAN AdsでBase Account IDとAccount IDを取得する

1. [Yahoo! Business Center](https://business.yahoo.co.jp/)にログインします。
![](/assets/yahoojapan.7229d785268ee3c9dc4f10ebd7f8768213092ec8193e9869c6144309d3111149.9657f1af.png)
2. **広告管理ツール**を選択します。
3. Base Account IDとAccount IDを記録します。
![](/assets/yahoo-japan-ads-v2-export-integration-2024-05-13-1.1600b09dcd16687fa5665ed4c0b5bbb2560b78d41744380555f998721e09d6bf.9657f1af.png)


### Yahoo! JAPAN AdsでUpload Audience Listのステータスを確認する

1. Account IDダッシュボードから**ツール > ライブラリ / オーディエンスリスト**を選択します。
![](/assets/yahoo-japan-ads-v2-export-integration-2024-05-13-2.becab92595a552522e33098cf5926dd90a726850d8fbfa17bdbf9d13275122c8.9657f1af.png)
2. リンクされたデータの列で、詳細をクリックしてアップロードステータスを確認します
![](/assets/yahoo-japan-ads-v2-export-integration-2024-05-13-3.2dae6f7856b697380b295011e333acca0d0a57ce90833610e1e0f455da594048.9657f1af.png)


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

### 新しい接続を作成する

Treasure Dataコンソールで、クエリを実行する前にエクスポート用のデータ接続を作成および設定する必要があります。データ接続の作成の一部として、統合が使用する認証資格情報を提供します。

1. **TD Console**を開きます。
2. **Integrations Hub > Catalog**に移動します。
3. **Yahoo! Ads V2**を検索して選択します。**![](/assets/yahooadsoutputv2.d853f06d4922b86ccdb9b44412ab1a763a8340fef0c15fe07fb416dd91aa3cb5.9657f1af.png)**New Authenticationダイアログが開きます。
4. 「**Click here** to connect a new account」リンクを選択します。
5. Yahoo! JAPAN Adsアカウントにログインします。
Yahoo! JapanサイトはOAuth認証情報を使用してTD Consoleにリダイレクトします。
![](/assets/yahoo-japan-ads-v2-export-integration-2024-05-10-5.20c696eff33f00f2b688b4171f9a04959e4d6e3a273abe63813d7f80c061c7a6.9657f1af.png)
6. 接続の名前を入力します。
7. **Done**を選択します。


### クエリを定義する

1. **Data Workbench > Queries**に移動します。
2. **New Query**を選択します。
3. クエリを定義して実行し、結果セットを検証します。
![](/assets/yahoo-japan-ads-v2-export-integration-2024-05-16-2.a43059a4255b9a943a6f83ae0c4b5403c3dd0a32bc3fecba710a0cd6aaba370b.9657f1af.png)
**Upload type値がAAIDまたはIDFAまたはMAIL_ADDRESSの場合：**
エクスポートクエリは1つのカラムのみをサポートし、カラムのデータタイプは文字列である必要があります。さらに、クエリごとに1つの識別子タイプのみを指定でき、識別子タイプは*MAIL_ADDRESS*、*IDFA*、または*AAID*のいずれかである必要があります。これは「Upload Type」パラメータを使用して指定されます。



```sql
SELECT email AS any_column_nameFROM profile_table
```

**Upload type値がMAIL_ADDRESS_AND_PHONE_NUMBERの場合：**エクスポートクエリは、emailまたはphoneという名前のカラム/エイリアス、またはemailとphoneの両方を指定する必要があります。


```sql
SELECT email, phoneFROM profile_table
```

### 結果エクスポートターゲットを指定する

1. **Export Results**を選択します。
![](/assets/yahoo-japan-ads-v2-export-integration-2024-05-16.c33c6509ee8ae6f1029accfc9aca627830cd12932ce0e2236470be88e41eade5.9657f1af.png)
2. 既存の統合認証を選択します。
![](/assets/image2020-12-18_13-44-6.09e8af43184e33e337bef7c546600eaaa5be9f010b690af1d591c7c2b4bb2df3.7a8868d5.png)
3. 追加のExport Results詳細を定義します。


### Yahoo! JAPAN Ads V2の統合パラメータ

Export Resultsページは次のパラメータを受け入れます：

| Parameter | Description |
|  --- | --- |
| `base_account_id`（必須） | Base Account ID |
| `account_id`（必須） | Account ID |
| audience_list_name（必須） | オーディエンスリスト名。名前が存在しない場合、この名前で新しいオーディエンスリストが作成されます。 |
| upload_type（必須） | アップロードタイプ：- MAIL_ADDRESS：メールまたはハッシュ化されたメール（SHA256）。ハッシュに大文字が含まれている場合は、小文字に変換してください。
- MAIL_ADDRESS_AND_PHONE_NUMBER：対応するカラム名emailとphoneを使用して、メール、電話番号、またはその両方をアップロードします。メールと電話番号は、生またはハッシュ化（SHA-256）できます。
- IDFA
- AAID

 |


### (オプション) 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 を有効にすることで、クエリの開始時刻を遅延させることができます。

## 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) を参照してください。

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

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

[Exporting Data with Parameters](https://docs.treasuredata.com/smart/project-product-documentation/exporting-data-with-parameters)の詳細をご覧ください。

**アップロードタイプmail_addessのワークフロー例**


```yaml
_export:
　td:
　　database: yahoo_ads_v2_db

+yahoo_ads_v2_task:
  td>: upload.sql
  database: ${td.database}
  result_connection: new_yahoo_ads_v2_auth
  result_settings:
    type: yahoo_ads_v2,
    base_account_id: base_account_id,
    account_id: account_id,
    audience_list_name: audience_list_name,
    upload_type: mail_address
```