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! Business Centerにログインします。
広告管理ツールを選択します。
Base Account IDとAccount IDを記録します。
Account IDダッシュボードからツール > ライブラリ / オーディエンスリストを選択します。
リンクされたデータの列で、詳細をクリックしてアップロードステータスを確認します
Treasure Dataコンソールで、クエリを実行する前にエクスポート用のデータ接続を作成および設定する必要があります。データ接続の作成の一部として、統合が使用する認証資格情報を提供します。
- TD Consoleを開きます。
- Integrations Hub > Catalogに移動します。
- Yahoo! Ads V2を検索して選択します。**
**New Authenticationダイアログが開きます。 - 「Click here to connect a new account」リンクを選択します。
- Yahoo! JAPAN Adsアカウントにログインします。 Yahoo! JapanサイトはOAuth認証情報を使用してTD Consoleにリダイレクトします。
- 接続の名前を入力します。
- Doneを選択します。
Data Workbench > Queriesに移動します。
New Queryを選択します。
クエリを定義して実行し、結果セットを検証します。
Upload type値がAAIDまたはIDFAまたはMAIL_ADDRESSの場合：
エクスポートクエリは1つのカラムのみをサポートし、カラムのデータタイプは文字列である必要があります。さらに、クエリごとに1つの識別子タイプのみを指定でき、識別子タイプはMAIL_ADDRESS、IDFA、またはAAIDのいずれかである必要があります。これは「Upload Type」パラメータを使用して指定されます。
SELECT email AS any_column_nameFROM profile_table**Upload type値がMAIL_ADDRESS_AND_PHONE_NUMBERの場合：**エクスポートクエリは、emailまたはphoneという名前のカラム/エイリアス、またはemailとphoneの両方を指定する必要があります。
SELECT email, phoneFROM profile_tableExport Resultsを選択します。
既存の統合認証を選択します。
追加のExport Results詳細を定義します。
Export Resultsページは次のパラメータを受け入れます：
| Parameter | Description |
|---|---|
base_account_id（必須） | Base Account ID |
account_id（必須） | Account ID |
| audience_list_name（必須） | オーディエンスリスト名。名前が存在しない場合、この名前で新しいオーディエンスリストが作成されます。 |
| upload_type（必須） | アップロードタイプ：
|
Scheduled Jobs と Result Export を使用して、指定したターゲット宛先に出力結果を定期的に書き込むことができます。
Treasure Data のスケジューラー機能は、高可用性を実現するために定期的なクエリ実行をサポートしています。
2 つの仕様が競合するスケジュール仕様を提供する場合、より頻繁に実行するよう要求する仕様が優先され、もう一方のスケジュール仕様は無視されます。
例えば、cron スケジュールが '0 0 1 * 1' の場合、「月の日」の仕様と「週の曜日」が矛盾します。前者の仕様は毎月 1 日の午前 0 時 (00:00) に実行することを要求し、後者の仕様は毎週月曜日の午前 0 時 (00:00) に実行することを要求するためです。後者の仕様が優先されます。
Data Workbench > Queries に移動します
新しいクエリを作成するか、既存のクエリを選択します。
Schedule の横にある None を選択します。
ドロップダウンで、次のスケジュールオプションのいずれかを選択します:
ドロップダウン値 説明 Custom cron... Custom cron... の詳細を参照してください。 @daily (midnight) 指定されたタイムゾーンで 1 日 1 回午前 0 時 (00:00 am) に実行します。 @hourly (:00) 毎時 00 分に実行します。 None スケジュールなし。
| 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) に実行するようにスケジュールを設定します。 |
- (オプション) Delay execution を有効にすることで、クエリの開始時刻を遅延させることができます。
クエリに名前を付けて保存して実行するか、単にクエリを実行します。クエリが正常に完了すると、クエリ結果は指定された宛先に自動的にエクスポートされます。
設定エラーにより継続的に失敗するスケジュールジョブは、複数回通知された後、システム側で無効化される場合があります。
(オプション) Delay execution を有効にすることで、クエリの開始時刻を遅延させることができます。
Audience Studio で activation を作成することで、segment データをターゲットプラットフォームに送信することもできます。
- Audience Studio に移動します。
- parent segment を選択します。
- ターゲット segment を開き、右クリックして、Create Activation を選択します。
- Details パネルで、Activation 名を入力し、前述の Configuration Parameters のセクションに従って activation を設定します。
- Output Mapping パネルで activation 出力をカスタマイズします。
- 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 番号。
- + Add string を選択して、エクスポート用の文字列を作成します。次の値から選択します:
- Schedule を設定します。
- スケジュールを定義する値を選択し、オプションでメール通知を含めます。
- Create を選択します。
batch journey の activation を作成する必要がある場合は、Creating a Batch Journey Activation を参照してください。
Treasure Workflow内で、この統合を使用してデータをエクスポートすることを指定できます。
Exporting Data with Parametersの詳細をご覧ください。
アップロードタイプmail_addessのワークフロー例
_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