--- title: "転送元 - Amazon Ads | TROCCO Docs" slug: "data-source-amazon-ads" updated: 2026-02-02T23:39:12Z published: 2026-02-02T23:39:12Z canonical: "documents.trocco.io/data-source-amazon-ads" --- > ## Documentation Index > Fetch the complete documentation index at: https://documents.trocco.io/llms.txt > Use this file to discover all available pages before exploring further. # 転送元 - Amazon Ads 本ページでは、Amazon Adsからデータを取得するための設定(転送設定)について説明します。 接続に関する設定については、[接続情報 - Amazon Ads](/docs/connection-configuration-amazon-ads)を参照ください。 ## 概要 Amazon Ads(旧Amazon Advertising)の広告レポートデータを取得して転送する設定のDocsです。 Sponsored Products、Sponsored Brands、Sponsored Displayの各広告タイプのレポートを取得できます。 ## 利用上の注意・制約 レポート生成時間について Amazon Ads APIはレポートを非同期で生成します。 レポートの生成には数秒から最大3時間程度かかる場合があります。 転送ジョブのタイムアウト設定にご注意ください。 取得可能なメトリクスについて 取得可能なメトリクス(カラム)は、選択した広告タイプ、レポートタイプ、グルーピング項目の組み合わせによって異なります。 指定できないメトリクスを選択した場合、エラーが発生します。 ## 設定項目 ### 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アカウントがアクセス可能なすべてのプロフィールが表示されます。