Amazon Ads Import Integration DSP Report

Copy

• Copy for LLM

  Copy page as Markdown for LLMs
• View as Markdown

  Open this page as Markdown
• Open in ChatGPT

  Get insights from ChatGPT
• Open in Claude

  Get insights from Claude
• Cursorに接続

  CursorにMCPサーバーをインストール
• VS Codeに接続

  VS CodeにMCPサーバーをインストール

このインテグレーションにより、Amazon Adsレポートの設定が可能になり、これらのレポートのコンテンツをTreasure Dataに直接取り込むことができます。

前提条件

• Treasure Dataの基本的な知識
• Amazon Adsの基本的な知識

要件と制限事項

• Amazon Adsのレポートメトリクスとデータは、Amazon Adsによって制御されています。

• このインテグレーションは、Amazon Adsで既に設定されているレポートをトリガーするだけです。

Treasure DataのStatic IPアドレス

Treasure DataのStatic IPアドレスは、このインテグレーションのアクセスポイントであり、リンケージのソースです。Static IPアドレスを確認するには、Customer Successの担当者またはテクニカルサポートにお問い合わせください。

TD Console経由でAmazon Adsレポートをインポート

Authenticationの作成

最初のステップは、認証情報のセットを使用して新しい認証を作成することです。

1. Integrations Hubを選択します。
2. Catalogを選択します。
3. CatalogでAmazon Adsを検索し、アイコンの上にマウスを置いてCreate Authenticationを選択します。

4. Credentialsタブが選択されていることを確認し、インテグレーションのOAuth接続認証情報を入力します。 5. Continueを選択します。 6. 認証の名前を入力し、Doneを選択します。

Sourceの作成

認証がコンソールで使用可能になったら、インポートジョブを設定します。

1. TD Consoleを開きます。
2. Integrations Hub > Authenticationsに移動します。
3. Amazon Ads認証を見つけて、New Sourceを選択します。

Connection Details

Source Table

1. Nextを選択します。

Workflow経由でAmazon Adsレポートからインポート

td_load>: src_idを使用して、Workflow経由でAmazon Adsレポートからデータをインポートできます。既にSourceを作成している場合は実行できます。Sourceを作成したくない場合は、.ymlファイルを使用してインポートできます。

SourceまたはYMLファイルの使用

Sourceの使用

1. Integrations Hub > Sourcesを選択します。
2. FiltersペインのIntegration TypeドロップダウンメニューからAmazon Adsを選択します。
3. •••アイコンを選択し、Copy Unique IDを選択します。

1. td_load>: sourceIdを使用してWorkflowタスクを定義します

+load:
   td_load>: unique_id_of_your_source
   database: ${td.dest_db}
   table: ${td.dest_table}

2. Workflowを実行します。

yml/yamlファイルの使用

1. ymlファイルを特定します。

   yml/yamlファイルを作成する必要がある場合は、参考としてCreate Seed Config File (seed.yml)の手順を使用してください。

2. td_load>: <.yml file>を使用してWorkflowタスクを定義します

+load:
   td_load>: config/daily_load.yml
   database: ${td.dest_db}
   table: ${td.dest_table}

3. Workflowを実行します。

サンプルWorkflowコード

サンプルWorkflowコードについては、Treasure Boxesを参照してください。

CLI (Toolbelt)経由でAmazon Adsからインポート

インテグレーションを設定する前に、最新バージョンのTD Toolbeltをインストールしてください。

Seed Configuration File (seed.yml)の作成

in:
  type: "amazon_ads"
  td_authentication_id: <td_authentication_id>
  data_type: "DSP_REPORT"
  profile_marketplace: "US"
  advertiser_ids: "advertiser_id_comma_separated_values"
  report_type: "CAMPAIGN"
  group_by: "campaign, ad, creative"
  time_unit: "SUMMARY"
  report_period: CUSTOM
  start_date: "2024-05-05"
  end_date: "2024-05-31"
  base_metrics: true
out:
  mode: append

パラメータリファレンス

load.ymlの生成

connector:guessを使用してload.ymlファイルを生成します。このコマンドは、ソースファイルを自動的に読み取り、ファイル形式とそのフィールドおよび列を最良の推測で判断します。

$ td connector:guess seed.yml -o load.yml

load.ymlを開いて、ファイル形式、エンコーディング、列名、タイプを含むファイル形式定義を確認できます。

load.ymlの例

in:
  type: amazon_ads
  data_type: DSP_REPORT
  profile_marketplace: US
  advertiser_ids: '123123123123123'
  report_type: CAMPAIGN
  group_by: campaign, ad, creative
  time_unit: SUMMARY
  report_period: CUSTOM
  start_date: '2024-07-05'
  end_date: '2024-07-31'
  base_metrics: true
  td_authentication_id: <td_authentication_id>
out: {mode: append}
exec: {}filters:
- rules:
  - {rule: upper_to_lower}
  - pass_types:
    - a-z
    - 0-9
    pass_characters: _
    replace: _
    rule: character_types
 - pass_types:
   - a-z
   pass_characters: _
   prefix: _
   rule: first_character_types
 - {rule: unique_number_suffix, max_length: 128}
 type: rename
 - from_value: {mode: upload_time}
 to_column: {name: time}
 type: add_time

データをプレビューするには、td connector:previewコマンドを使用します。

td connector:preview

Load Jobの実行

データのサイズによっては、数時間かかる場合があります。データを保存するTreasure Dataのデータベースとテーブルを必ず指定してください。 Treasure Dataのストレージは時間でパーティション分割されているため、Treasure Dataでは--time-columnオプションを指定することをお勧めします(data partitioningを参照)。このオプションが指定されていない場合、データコネクタは最初のlongまたはtimestamp列をパーティション分割時間として選択します。--time-columnで指定される列のタイプは、longまたはtimestampタイプのいずれかである必要があります。

データに時間列がない場合は、add_timeフィルタオプションを使用して時間列を追加できます。詳細については、add_time Filter Functionのドキュメントを参照してください。

$ td connector:issue load.yml --database td_sample_db --table td_sample_table \--time-column created_at

connector:issueコマンドは、データベース(td_sample_db)とテーブル(td_sample_table)を既に作成していることを前提としています。TDにデータベースまたはテーブルが存在しない場合、このコマンドは失敗します。データベースとテーブルを手動で作成するか、td connector:issueコマンドで--auto-create-tableオプションを使用してデータベースとテーブルを自動作成してください。

$ td connector:issue load.yml --database td_sample_db --table td_sample_table--time-column created_at --auto-create-table

データコネクタはサーバー側でレコードをソートしません。時間ベースのパーティション分割を効果的に使用するには、事前にファイル内のレコードをソートしてください。

timeというフィールドがある場合は、--time-columnオプションを指定する必要はありません。

$ td connector:issue load.yml --database td_sample_db --table td_sample_table

Import Modes

load.ymlファイルのout:セクションでファイルインポートモードを指定します。out:セクションは、データがTreasure Dataテーブルにどのようにインポートされるかを制御します。たとえば、既存のテーブルにデータを追加するか、データを置き換えるかを選択できます。

関連項目

Amazon Ads Report V3の詳細については、次のAmazonドキュメントを参照してください:

• Amazon Ads Report Types
• Amazon Ads API Reference Creating a Report Request