# Amazon Marketing Cloud Import Integration デフォルトでは、通常のビューで入力します。 Amazon Marketing Cloud Import Integrationを使用すると、Amazon Marketing CloudからTreasure Data CDPデータベースにエンリッチメントデータをインポートできます。 ## 前提条件 - [Amazon Ads APIオンボーディング](https://advertising.amazon.com/API/docs/en-us/onboarding/overview)を完了していること - Amazon Marketing Cloudインスタンスへのアクセス - Amazon Marketing Cloudの基本的な知識 - Treasure Dataの基本的な知識 ## Treasure Data Integration の静的 IP アドレス セキュリティポリシーで IP ホワイトリストが必要な場合は、接続を成功させるために Treasure Data の IP アドレスを許可リストに追加する必要があります。 リージョンごとに整理された静的 IP アドレスの完全なリストは、次のリンクにあります: [https://api-docs.treasuredata.com/en/overview/ip-addresses-integrations-result-workers/](https://api-docs.treasuredata.com/en/overview/ip-addresses-integrations-result-workers/) ## TD Console経由でAmazon Marketing Cloudからインポート ## Amazon Marketing Cloud Instance IDとAccount IDの取得 Amazon Marketing Cloudインスタンスにログイン後、以下の手順でAmazon Marketing CloudのInstance IDとAccount IDを取得します。 1. Instance listからインスタンスのAmazon Marketing Cloud Instance IDを取得します。 ![](/assets/amc-instance-id.abc2ce38604fb5981160a05d8e500b97dc615cb846db07a6a80964b8c22c0c9f.bd49d4d6.png) 2. パラメータ**entityId**に割り当てられたAmazon Marketing Cloud Account IDを確認します。![](/assets/amc-account-id.4f957be8a7083286d9c2efaaae3f84769bc09229d808004a7d75f691d1040462.bd49d4d6.png) ## 新しいConnectionの作成 データconnectionを設定する際、integrationにアクセスするためのauthenticationを提供します。Treasure Dataでは、authenticationを設定し、source情報を指定します。 1. TD Consoleを開きます。 2. **Integrations Hub** > **Catalog**に移動します。 3. **Amazon Marketing Cloud**を検索して選択します。![](/assets/screen-shot-2023-04-24-at-17.25.52.0744f8bd23e71ba7ca92b0cefa857d19af3e466fdc2cff6aba10511088d0c323.bd49d4d6.png) 4. New Authenticationの**Click here**リンクを選択して、新しいAmazon Accountに接続します。![](/assets/screen-shot-2023-04-24-at-17.29.15.277937262c2647f54bf8d538db9104329274257337aac7c7a1625c23045d81f8.bd49d4d6.png) 5. Amazon Marketing Cloudインスタンスにリダイレクトされ、OAuthを使用してログインします。usernameとpasswordを入力します。 ![](/assets/screen-shot-2023-04-24-at-17.33.04.59530de12fc559cc1e7aa5527f50209c153c9d47a35e9cc1a7021ed01b78437e.bd49d4d6.png) 6. **Allow**を選択してconsent screenを承認します。これにより、TD consoleにリダイレクトされます。![](/assets/screen-shot-2023-04-24-at-17.35.48.7ff015ad82656050a4ccd0b4269a763308726ae72b89bf22f3d5d90ef19cf431.bd49d4d6.png) 7. Amazon Marketing Cloudを再度選択し、**AMC Instance ID**と**AMC Account ID**を入力します。 8. **OAuth connection**のAmazon accountを選択します。 S3関連のフィールドは、Amazon Marketing Cloudにオーディエンスデータをアップロードする場合にのみ必要です。Treasure Dataへのインポートの場合、これらのフィールドは無視できます。 ![](/assets/screen-shot-2023-04-24-at-17.53.09.24886bde5787ac9b66c091f857c8280a5708095d34dd99ed13cf078c2ec36330.bd49d4d6.png) 9. connectionの名前を入力し、**Done**を選択します。 ## エンリッチメントデータをTreasure Dataに転送 認証されたconnectionを作成すると、自動的にAuthenticationsタブに移動します。作成したconnectionを確認し、**New Source**を選択します。 ### Connectionの作成 1. Data Transferフィールドに**Source**の名前を入力します。 2. **Next**を選択します。![](/assets/screen-shot-2023-04-24-at-18.12.32.780943e65505dc3aac53df05ec1c0fb391ac5bd9250b058003d0d8a9b5d04051.bd49d4d6.png) ### Source Tableの識別 1. 該当するパラメータを編集します。 ![](/assets/screen-shot-2023-04-24-at-18.18.16.ef7fe388a000e573e8efe0415783233c41ac6dc555620066a251ed78d2d3af58.bd49d4d6.png) | Parameter | Description | | --- | --- | | **Query Type** | - **By Workflow** - 実行のために送信する前にworkflowを作成または更新します。- **On Demand** - workflowを作成する必要はありません。SQL queryを使用してアドホックworkflowを送信します。 | | **Workflow Identifier** | **By Workflow** query typeの場合のみ必要です。 | | **Query** | Amazon Marketing Cloudからエンリッチメントデータを取得するためのSQL Query。AMC Query Libraryのリファレンスについては、[https://advertising.amazon.com/marketing-cloud/instructional-queries](https://advertising.amazon.com/marketing-cloud/instructional-queries)を参照してください | | **Workflow Parameter for SQL Query (Optional)** | SQL queryのカスタムパラメータ名。**By Workflow** query typeの場合のみ必要です。 | | **Workflow Parameter Values for SQL Query (Optional)** | カスタムパラメータ値。workflowを実行のために送信する際にカスタムパラメータ名とバインドされます。**By Workflow** query typeの場合のみ必要です。 | | **Auto Create Workflow** | **By Workflow** query typeの場合に必要です。 | | **Auto Update Workflow** | **By Workflow** query typeの場合に必要です。 | | **Time Window Type** | - **Most Recent Day** - **Most Recent Week** - **Current Month** - **Previous Month** - **Explicit Time Range** | | **Start Time** | **Explicit Time Range** query typeの場合のみ必要です。 | | **End Time** | **Explicit Time Range** query typeの場合のみ必要です。 | | **Schema Settings** | (必須)現在のjobのスキーマ構造。AMCに送信されるqueryのselect文で使用されるカラムに一致するようにカラム名とデータタイプを追加するために、schema設定を編集する必要があります。これを行わないと、`Too many columns error`でjobが失敗する可能性があります。 | ### Data Settingsの定義 1. **Next**を選択します。**Data Settings**ページが開きます。 2. オプションで、**Data Settings**を編集するか、このダイアログのページをスキップします。![](/assets/screen-shot-2023-04-24-at-18.38.42.9a1bb59a0f4120ef7f754235fe523dc830083ba66a0f9e1a83d25e6d3de2cc06.bd49d4d6.png) ### データのプレビュー データプレビューはオプションであり、選択した場合はダイアログの次のページに安全にスキップできます。 1. インポートを実行する前にデータの[プレビュー](https://docs.treasuredata.com/smart/project-product-documentation/previewing-your-source-data)を確認するには、**Generate Preview**を選択します。 2. **Next**を選択します。**Data Preview**ページが開きます。 3. データをプレビューする場合は、**Generate Preview**を選択します。 4. 正しいデータが表示されていることを確認します。 ![](/assets/screen-shot-2023-04-24-at-18.41.29.0f67a37773fb97fae3247d62b5a1693ce36fc25225d85f7e892f886426d8671e.bd49d4d6.png) ### **Data Placement**の定義 このダイアログでは、データの配置場所を指定し、このインポートを実行する頻度をスケジュールできます。 1. **Next**を選択します。**Data Placement**ページが開きます。 ![](/assets/screen-shot-2023-04-24-at-18.43.02.025ab3f419b29f37009b665f48f2bbbd7d0525cdf6b1bb42a6decc047e5f02c7.bd49d4d6.png) 2. **Storage**セクションで、新しいdatabaseを作成するか既存のdatabaseを選択し、インポートしたデータを配置する新しいtableを作成するか既存のtableを選択できます。 3. **Database** > **Select** **an existing**または**Create New Database**を選択します。 4. **Table** > **Select an existing**または**Create New Table**を選択します。 5. データをインポートするためのAppendまたはReplaceメソッドを選択します。 1. **Append**(デフォルト) - データインポート結果がtableに追加されます。 tableが存在しない場合は作成されます。 2. **Replace** - 既存のtableのすべてのコンテンツをqueryの結果出力で置き換えます。 tableが存在しない場合は、新しいtableが作成されます。 6. **Timestamp-based Partition Key**カラムを選択します。 デフォルトのkeyとは異なるpartition key seedを設定する場合は、longまたはtimestampカラムをpartitioning timeとして指定できます。デフォルトのtimeカラムとして、*add_time*フィルターを使用した*upload_time*を使用します。 7. データストレージの**Timezone**を選択します。 8. **Schedule**で、このqueryをいつ、どのくらいの頻度で実行するかを選択できます。 - 1回実行: 1. **Off**を選択します。 2. **Scheduling Timezone**を選択します。 3. **Create & Run Now**を選択します。 - queryを繰り返す: 1. **On**を選択します。 2. **Schedule**を選択します。UIには、*@hourly*、*@daily*、*@monthly*、またはカスタム*cron*の4つのオプションが用意されています。 3. **Delay Transfer**を選択して、実行時間の遅延を追加することもできます。 4. **Scheduling Timezone**を選択します。 5. **Create & Run Now**を選択します。 転送が実行された後、**Data Workbench** > **Databases**で転送の結果を確認できます。