---
articleId: a3779eab-ab4b-4da0-a5ca-7690fd5f05cf
slug: data-source-amazon-ads
title: 転送元 - Amazon Ads
parentCategoryId: b257af88-17fc-4a4d-bf94-dc694a258787
languageCode: ja
---
本ページでは、Amazon Adsからデータを取得するための設定(転送設定)について説明します。
接続に関する設定については、[接続情報 - Amazon Ads](/docs/connection-configuration-amazon-ads)を参照ください。
## 概要
Amazon Ads(旧Amazon Advertising)の広告レポートデータを取得して転送する設定のDocsです。
Sponsored Products、Sponsored Brands、Sponsored Displayの各広告タイプのレポートを取得できます。
## 利用上の注意・制約
:::(Warning) (レポート生成時間について)
Amazon Ads APIはレポートを非同期で生成します。
レポートの生成には数秒から最大3時間程度かかる場合があります。
転送ジョブのタイムアウト設定にご注意ください。
:::
:::(Info) (取得可能なメトリクスについて)
取得可能なメトリクス(カラム)は、選択した広告タイプ、レポートタイプ、グルーピング項目の組み合わせによって異なります。
指定できないメトリクスを選択した場合、エラーが発生します。
:::
## 設定項目
### STEP1 基本設定
|項目名|必須|デフォルト値|説明|
|---|---|---|---|
|Amazon Ads接続情報|✓|-|あらかじめ登録してある[Amazon Adsの接続情報](/docs/connection-configuration-amazon-ads)を選択します。|
|プロフィールID|✓|-|データを取得する広告プロフィールを選択します。
接続情報に紐づくAmazonアカウントがアクセス可能なプロフィール一覧が表示されます。|
|広告タイプ|✓|Sponsored Products|取得する広告の種類を選択します。
Sponsored Products:スポンサープロダクト広告Sponsored Brands:スポンサーブランド広告Sponsored Display:スポンサーディスプレイ広告|
|レポートタイプ|✓|Campaign|取得するレポートの種類を選択します。
選択した広告タイプによって、選択可能なレポートタイプが異なります。|
|groupBy|✓|`campaign`|レポートデータをグルーピングする単位を選択します。
選択した広告タイプとレポートタイプによって、選択可能なグルーピング項目が異なります。|
|フィルター|-|-|取得データを絞り込む条件を設定できます。
フィールド名とフィルター値を指定します。
同じフィールド名で複数のフィルターは指定できません。|
|timeUnit|✓|`Summary`|レポートの時間単位を選択します。
`Summary`:期間全体のサマリー`Daily`:日単位の集計|
|データ取得期間の開始日|✓|-|データ取得期間の開始日を入力します。
形式:`YYYY-MM-DD`(例:`2024-01-01`)|
|データ取得期間の終了日|✓|-|データ取得期間の終了日を入力します。
形式:`YYYY-MM-DD`(例:`2024-01-31`)|
## レポートタイプ一覧
広告タイプごとに選択可能なレポートタイプは以下のとおりです。
### Sponsored Products(スポンサープロダクト広告)
|レポートタイプ|説明|
|---|---|
|Campaign|キャンペーンレベルのパフォーマンスデータ|
|Targeting|ターゲティング(キーワード・商品ターゲティング)のパフォーマンスデータ|
|Gross and invalid traffic|グロスおよび無効トラフィックデータ|
|Purchased product|購入された商品のデータ|
|Advertised product|広告対象商品のパフォーマンスデータ|
|Search term|検索キーワードのパフォーマンスデータ|
|Audience|オーディエンスデータ|
### Sponsored Brands(スポンサーブランド広告)
|レポートタイプ|説明|
|---|---|
|Campaign|キャンペーンレベルのパフォーマンスデータ|
|Ad group|広告グループレベルのパフォーマンスデータ|
|Ad|広告レベルのパフォーマンスデータ|
|Targeting|ターゲティングのパフォーマンスデータ|
|Gross and invalid traffic|グロスおよび無効トラフィックデータ|
|Purchased product|購入された商品のデータ|
|Placement|キャンペーン配置のパフォーマンスデータ|
|Search term|検索キーワードのパフォーマンスデータ|
|Audience|オーディエンスデータ|
### Sponsored Display(スポンサーディスプレイ広告)
|レポートタイプ|説明|
|---|---|
|Campaign|キャンペーンレベルのパフォーマンスデータ|
|Ad group|広告グループレベルのパフォーマンスデータ|
|Targeting|ターゲティングのパフォーマンスデータ|
|Gross and invalid traffic|グロスおよび無効トラフィックデータ|
|Purchased product|購入された商品のデータ|
|Advertised product|広告対象商品のパフォーマンスデータ|
## 取得されるデータ
取得されるカラムは、選択した広告タイプ、レポートタイプ、グルーピング、時間単位の組み合わせによって動的に決定されます。
主なカラム例は以下のとおりです。
|カラム名|データ型|説明|
|---|---|---|
|`campaign_id`|`long`|キャンペーンID|
|`campaign_name`|`string`|キャンペーン名|
|`impressions`|`long`|インプレッション数|
|`clicks`|`long`|クリック数|
|`cost`|`double`|広告費用|
|`date`|`string`|日付(時間単位が`daily`の場合)|
取得可能なメトリクスの詳細については、[Amazon Ads公式ドキュメント - Reporting Columns](https://advertising.amazon.com/API/docs/en-us/guides/reporting/v3/columns)を参照ください。
## 補足事項
### プロフィールIDについて
プロフィールIDは、Amazon Adsの広告アカウントを識別するIDです。
1つのAmazonアカウントで複数の広告プロフィールを管理している場合、取得したいデータに対応するプロフィールを選択してください。
プロフィール選択のドロップダウンには、接続情報で認証したAmazonアカウントがアクセス可能なすべてのプロフィールが表示されます。