# LiveRamp Activation Partners Integration Treasure Dataでは、ID解決、匿名化、データ拡張のためにLiveRampへデータをエクスポートできます。Treasure Dataは、6つのアクティベーションパートナーとのLiveRampアクティベーションをトリガーできるようになりました。 Treasure Dataでセグメントを作成し、[LiveRampへエクスポート](/ja/int/liveramp-export-integration)した後、Treasure Dataから直接6つのLiveRampアクティベーションパートナーにエクスポートするオプションがあります。TD Workflow UIでLiveRampのデータを他のサービスと同期するワークフローをTreasure Dataで作成できます。コネクタには、LiveRamp側でアクティベートしたいセグメントIDが必要です。これらのパートナープラットフォームには以下が含まれます： - Beeswax - Twitter - Snapchat - Google Display & Video 360 (DV360) - Facebook (US) Direct On-boarding - Facebook (US) Managed On-boarding リリースに参加するには、詳細について[お問い合わせください](https://www.treasuredata.com/jp/contact_us)。 ## 前提条件 - [TD Toolbelt](https://toolbelt.treasuredata.com/)を含むTreasure Dataの基本知識 - LiveRamp APIキー - LiveRamp Connect UIで作成された宛先アカウント ## TD Consoleを使用した接続の作成 Treasure Data Consoleを使用して接続を設定できます。 ### 新しい接続の作成 1. TD Consoleを開きます。 2. Integrations Hub > Catalogに移動します。 3. LiveRampまたはLiveRamp Distribution Connectorのいずれかを検索して選択します。 ![](/assets/image-20200124-203224.7c10f94a9a82cf66041462505fa436dc787a13afdfa2999601c299c833c5fe16.a0fe23d6.png) 4. New Authenticationダイアログが表示されます。必要な認証情報を入力します： **APIキー**: LiveRamp APIキー ![](/assets/image-20200124-203337.b0a5a258b9792a03d2716e855a30da04196e9fd517237b1cc27bf60ac80b3f53.a0fe23d6.png) 5. **Continue**を選択し、接続に名前を付けます： ![](/assets/image-20200124-203432.3ba926597961b5ff6b99999712a62a3282a8f9f2a9164336054ebb28ec19e6e0.a0fe23d6.png) 6. **Done**を選択します。 ### LiveRamp Distribution Connectorでの出力の指定 1. TD Consoleを開きます。 2. **Data Workbench** > **Queries**に移動します。 3. **New Query**を選択します。 4. データをエクスポートしたいデータベースを選択します。 5. クエリエディタにクエリを入力します。 6. LiveRampで推奨されている[ヘッダー](https://liveramp.elevio.help/en/articles/92990)と同じようにクエリで列マッピングを定義する必要があります 7. クエリエディタの上部にある**Export** **Results**を選択します。 ![](/assets/image-20200128-215417.5c09b9d850ec72daace4d79d70afad90df01e47916c97889f93cc1abf00d5036.a0fe23d6.png) 8. Choose Integrationダイアログが開きます。既存のLiveRamp接続を選択します。まだIntegrationが設定されていない場合は、[データエクスポート中の新しい接続の作成](https://docs.treasuredata.com/articles/project-integrations/liveramp-export-integration#LiveRampExportIntegration-UsetheTDConsoletoCreateyourConnection)を参照してください。 ![](/assets/image-20200128-214022.0451b6fa6b0dec3e969d3aa2a8b05c3ebcb49492dc5e5680246df3766d9f9392.a0fe23d6.png) 9. エクスポートの詳細を指定します。[パラメータを指定](http://docs.treasuredata.com/pages/viewpage.action?pageId=328994#LiveRampActivationPartnersIntegration(Beta)-ConfiguretheConnectionBySpecifyingtheParameters)して接続を設定します。 ![](/assets/image-20200128-214226.2a31a4bc5b3182ebf6e15309fe1a684801cb571b728832f37dd7f104d61e7b5a.a0fe23d6.png) 10. **Done**を選択します ### パラメータの指定による接続の設定 *LiveRamp*パートナー接続を選択すると、次のダイアログが表示されます： ![](/assets/image-20200124-203553.f896f48c71d8e8cbd89958192a74495a62c1b91d7a2f9c79833ff83421cf24c6.a0fe23d6.png) 次のように入力パラメータを入力します： - **Destination Account ID:** 宛先LiveRampアカウントのアカウントID。LiveRamp Connect URLで確認できます。アカウントIDは空白にできません。例えば、URL [https://connect.liveramp.com/distribution/accounts/1021066/segments](https://connect.liveramp.com/distribution/accounts/1021066/segments)の場合、宛先アカウントIDは1021066です。 - **Retry limit:** LiveRampサーバーエラーまたはネットワークエラーによりエラーが発生した場合、アップロードを中止する前に試行する再試行回数（デフォルト: 7） - **Connection timeout in seconds:** LiveRamp APIへの接続に割り当てられる時間（デフォルト: 600） ### クエリの列名 LiveRampデータコネクタは、次の列とデータ型のみを理解し解釈します。エイリアス列名を次の指定された列に一致するように変更する必要があります： | **列名** | | | **型** | **必須** | **説明** | | --- | --- | --- | --- | --- | --- | | segment_id | | | long | オプション | segment_idとsegment_nameの両方が指定されている場合、segment_idが使用されます。 | | segment_name | | | string | オプション | | | segment_value | | | string | オプション | | segment_id、またはsegment_name/segment_value列のいずれかをクエリに含める必要があります。そうしないと、ジョブが失敗します。 ### LiveRampに入力するためのクエリ例 Treasure Dataクエリエディタから、次のクエリを実行し、結果をLiveRamp Distribution接続にエクスポートします 次のクエリ例は、**segment_id**によってすべてのセグメントを宛先LiveRampアカウントに配信します ```sql SELECT column_id AS segment_id FROM my_table; ``` **segment_name**と**segment_value**による同様のクエリ ```sql SELECT column_name AS segment_name, column_value AS segment_value FROM my_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 を有効にすることで、クエリの開始時刻を遅延させることができます。 ## 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) を参照してください。 ## オプション: ワークフローでのエクスポート結果の設定 Treasure Workflow内で、このデータコネクタを使用してデータを出力することを指定できます。 ```yaml timezone: UTC _export: td: database: sample_datasets +td-result-into-liveramp-distribution: td>: queries/sample.sql result_connection: your_connection_name result_settings: account_id: account_id retry_limit: 3 timeout: 600 ``` ワークフローでデータコネクタを使用してデータをエクスポートする方法については、[詳細情報](http://docs.treasuredata.com/display/PD/About+Using+Workflows+to+Export+Data+with+TD+Toolbelt)をお読みください。 ## CLIを使用した接続の作成 ### 'td'コマンドのインストール [Treasure Data Toolbelt](https://toolbelt.treasuredata.com/)をインストールします。 ### オンデマンドジョブの場合 td queryコマンドの - r/--resultオプションを使用して、LiveRamp結果出力先を追加します： ```bash td query -d mydb -w 'SELECT id as segment_id FROM source_table' --type presto -r '{"type":"liveramp_to_twitter_distribution", "api_key":"dummy_api_key", "account_id":123, "retry_limit":3, "timeout":600}' ``` サポートされているタイプ： - liveramp_to_facebook_distribution - liveramp_to_twitter_distribution - liveramp_to_beeswax_distribution - liveramp_to_facebook_direct_onboarding_distribution - liveramp_to_google_display_video_distribution - liveramp_to_snapchat_distribution ### スケジュールジョブの場合 td sched:createコマンドの - r/ --resultオプションを使用して、LiveRamp結果出力先を追加します： ```bash td sched:create every_3_days "0 0 */3 * *"-d mydb -w 'SELECT id as segment_id FROM source_table' --type presto -r '{"type":"liveramp_to_twitter_distribution", "api_key":"dummy_api_key", "account_id":123, "retry_limit":3, "timeout":600}' ```