Skip to content
/
Amazon Marketing Cloud Im...
Last updated

Amazon Marketing Cloud Import Integration

デフォルトでは、通常のビューで入力します。

Amazon Marketing Cloud Import Integrationを使用すると、Amazon Marketing CloudからTreasure Data CDPデータベースにエンリッチメントデータをインポートできます。

前提条件

  • Amazon Ads APIオンボーディングを完了していること
  • 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/

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を取得します。
  2. パラメータentityIdに割り当てられたAmazon Marketing Cloud Account IDを確認します。

新しいConnectionの作成

データconnectionを設定する際、integrationにアクセスするためのauthenticationを提供します。Treasure Dataでは、authenticationを設定し、source情報を指定します。

  1. TD Consoleを開きます。

  2. Integrations Hub > Catalogに移動します。

  3. Amazon Marketing Cloudを検索して選択します。

  4. New AuthenticationのClick hereリンクを選択して、新しいAmazon Accountに接続します。

  5. Amazon Marketing Cloudインスタンスにリダイレクトされ、OAuthを使用してログインします。usernameとpasswordを入力します。

  6. Allowを選択してconsent screenを承認します。これにより、TD consoleにリダイレクトされます。

  7. Amazon Marketing Cloudを再度選択し、AMC Instance IDとAMC Account IDを入力します。

  8. OAuth connectionのAmazon accountを選択します。

S3関連のフィールドは、Amazon Marketing Cloudにオーディエンスデータをアップロードする場合にのみ必要です。Treasure Dataへのインポートの場合、これらのフィールドは無視できます。

9. connectionの名前を入力し、Doneを選択します。

エンリッチメントデータをTreasure Dataに転送

認証されたconnectionを作成すると、自動的にAuthenticationsタブに移動します。作成したconnectionを確認し、New Sourceを選択します。

Connectionの作成

  1. Data TransferフィールドにSourceの名前を入力します。
  2. Nextを選択します。

Source Tableの識別

  1. 該当するパラメータを編集します。

ParameterDescription
Query Type- By Workflow - 実行のために送信する前にworkflowを作成または更新します。- On Demand - workflowを作成する必要はありません。SQL queryを使用してアドホックworkflowを送信します。
Workflow IdentifierBy Workflow query typeの場合のみ必要です。
QueryAmazon Marketing Cloudからエンリッチメントデータを取得するためのSQL Query。AMC Query Libraryのリファレンスについては、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 WorkflowBy Workflow query typeの場合に必要です。
Auto Update WorkflowBy Workflow query typeの場合に必要です。
Time Window Type- Most Recent Day - Most Recent Week - Current Month - Previous Month - Explicit Time Range
Start TimeExplicit Time Range query typeの場合のみ必要です。
End TimeExplicit 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を編集するか、このダイアログのページをスキップします。

データのプレビュー

データプレビューはオプションであり、選択した場合はダイアログの次のページに安全にスキップできます。

  1. インポートを実行する前にデータのプレビューを確認するには、Generate Previewを選択します。
  2. Nextを選択します。Data Previewページが開きます。
  3. データをプレビューする場合は、Generate Previewを選択します。
  4. 正しいデータが表示されていることを確認します。

Data Placementの定義

このダイアログでは、データの配置場所を指定し、このインポートを実行する頻度をスケジュールできます。

  1. Nextを選択します。Data Placementページが開きます。
  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で転送の結果を確認できます。

Previous page
Next page