転送元 - Amazon Ads

Prev Next

本ページでは、Amazon Adsからデータを取得するための設定（転送設定）について説明します。
接続に関する設定については、接続情報 - Amazon Adsを参照ください。

概要

Amazon Ads（旧Amazon Advertising）の広告レポートデータを取得して転送する設定のDocsです。
Sponsored Products、Sponsored Brands、Sponsored Displayの各広告タイプのレポートを取得できます。

利用上の注意・制約

レポート生成時間について

Amazon Ads APIはレポートを非同期で生成します。
レポートの生成には数秒から最大3時間程度かかる場合があります。
転送ジョブのタイムアウト設定にご注意ください。

取得可能なメトリクスについて

取得可能なメトリクス（カラム）は、選択した広告タイプ、レポートタイプ、グルーピング項目の組み合わせによって異なります。
指定できないメトリクスを選択した場合、エラーが発生します。

設定項目

STEP1 基本設定

項目名 必須 デフォルト値 説明
Amazon Ads接続情報 ✓ - あらかじめ登録してある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を参照ください。

    補足事項

    プロフィールIDについて

    プロフィールIDは、Amazon Adsの広告アカウントを識別するIDです。
    1つのAmazonアカウントで複数の広告プロフィールを管理している場合、取得したいデータに対応するプロフィールを選択してください。

    プロフィール選択のドロップダウンには、接続情報で認証したAmazonアカウントがアクセス可能なすべてのプロフィールが表示されます。