Amazon 販売パートナーを通じて利用可能なデータ API - AWS 規範ガイダンス
レポート APIデータキオスク API

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

Amazon 販売パートナーを通じて利用可能なデータ API

Amazon Selling Partner API (SP-API) は、Amazon の販売者やベンダーAPIが注文、出荷、支払いなどのデータにプログラムでアクセスするのに役立つ RESTベースの です。このデータAPIにより、販売効率が向上し、労働要件が軽減され、顧客への応答時間が向上します。このガイドでは、Selling Partner API for Reports (ReportsAPI) と Selling Partner API for Data Kiosk (Data Kiosk) を通じてアクセスできるデータに焦点を当てていますAPI。

レポート API

Reports のデータは、Amazon マーケットプレイスでビジネスを管理するのに役立つAPIように設計されています。分析レポートは、製品、顧客、全体的なパフォーマンスに関する貴重なインサイトを提供します。

  • 販売パフォーマンス – 販売データを分析することで、傾向と顧客の購入パターンを特定できます。この情報を使用して、販売戦略を最適化できます。

  • 製品パフォーマンス – 製品データを分析することで、どの製品が売れていて、どの製品が売れていないかを特定できます。この情報を使用して、製品オファリングを最適化できます。

  • 顧客の行動 – 顧客データを分析することで、顧客の好みやニーズを理解するのに役立ちます。この情報を使用して、マーケティング戦略と販売戦略をパーソナライズできます。

次の表は、各ブランド分析レポートについて説明しています。以下のレポートは、ブランド分析販売パートナーAPIロールを持ち、Amazon Brand Registry に登録されている Amazon 販売者およびベンダーが利用できます。

レポートを行う 説明 パラメータ
マーケットバスケット分析レポート チェックアウト時に、顧客のバスケット (カート) 内の項目と組み合わせて最も一般的に購入される項目に関するデータを提供します。 レポートは、さまざまなレポート期間 (DAY、WEEK、MONTH、または ) に対してリクエストできますQUARTER。データはこれらの期間にわたって提供されます。
Amazon 検索用語レポート マーケットプレイスの検索キーワードと部門別に、最も頻繁に選択される Amazon 標準識別番号 (ASINs) のデータが含まれます。 レポートは、さまざまなレポート期間 (DAY、WEEK、MONTH、または ) に対してリクエストできますQUARTER。リクエストは複数のレポート期間にまたがることはできません。
購入レポートを繰り返す 販売パートナーのアイテムの繰り返し購入の数量に関するデータが含まれます。 レポートは、さまざまなレポート期間 (WEEK、MONTH、または ) に対してリクエストできますQUARTER。データは複数のレポート期間にまたがることができます。

次の表は、各ベンダーの小売分析と販売者小売分析レポートについて説明しています。

レポートを行う 説明 可用性 パラメータ
Rapid Retail Analytics インベントリレポート 1 時間単位の粒度に集約されたASINレベルでのインベントリデータが含まれます。 ベンダー レポートはリクエストのみ可能です。データは、当日を含む複数の日付範囲期間にまたがることができます。
Rapid Retail Analytics トラフィックレポート ベンダーの項目の詳細ページへの顧客トラフィックに関するデータを、時間単位のきめ細かさで含めます。 ベンダー レポートはリクエストのみ可能です。データは複数の日付範囲期間にまたがることができます。
Rapid Retail Analytics セールスレポート 1 時間単位の粒度に集約されたASINレベルでの販売データが含まれます。 ベンダー レポートはリクエストのみ可能です。データは複数の日付範囲期間にまたがることができます。
ベンダー販売レポート カタログレベルとASINレベルで報告された主要な小売販売メトリクス (注文および出荷された収益や単位など) が含まれます。 ベンダー

レポートは、さまざまな に対してリクエストできます。

  • レポート期間 (DAY、WEEK、MONTHQUARTER、、または YEAR）

  • ディストリビュータービュー (MANUFACTURING または SOURCING）

  • 販売プログラム (RETAIL、BUSINESS、または FRESH）
Net Pure Product マージンレポート カタログレベルとASINレベルで報告された、ベンダーの商品を販売するための Amazon の純粋な製品マージンに関するデータが含まれます。 ベンダー レポートは、さまざまなレポート期間 (DAY、WEEK、MONTH、QUARTER、または ) に対してリクエストできますYEAR。
ベンダートラフィックレポート カタログレベルおよびASINレベルで報告された概要ビューなどの主要な小売トラフィックメトリクスが含まれます ベンダー レポートは、さまざまなレポート期間 (DAY、WEEK、MONTH、QUARTER、または ) に対してリクエストできますYEAR。
ベンダー予測レポート 最新の週次予測生成日の ASINレベルで報告された、フォワードルッキング平均、過去 70、過去 80、過去 90 の週次顧客需要予測が含まれます。 ベンダー レポートは、さまざまな販売プログラム (RETAIL または ) に対してリクエストできますFRESH。
ベンダーインベントリレポート カタログレベルとASINレベルで報告されたインベントリと運用上の健全性メトリクス (販売可能な手元ユニットやベンダーの確認率など) が含まれます。 ベンダー

レポートは、さまざまな に対してリクエストできます。

  • レポート期間 (DAY、WEEK、MONTHQUARTER、、または YEAR）

  • ディストリビュータービュー (MANUFACTURING または SOURCING）

  • 販売プログラム (RETAIL または FRESH）
販売およびトラフィックビジネスレポート 販売者全体のカタログの主要な販売パフォーマンスメトリクス (注文された製品の売上、収益、注文単位、請求額など) とページトラフィックメトリクス (ページビュー、購入ボックスの割合など) を日付と で集計したものが含まれます。 ASIN 販売者 レポートはリクエストまたはスケジュールできます。データは、異なる日付範囲の集計レベル (DAY、WEEK、または MONTH) とASIN集計レベル (PARENT、CHILD、または ) に対して指定できますSKU。

データキオスク API

Data Kiosk APIには、GraphQLベースの動的レポートスイートが用意されています。これは、カスタム GraphQL クエリを生成し、Amazon のデータセットからバルクデータにアクセスするのに役立ちます。これを使用して、以下を含む幅広いデータAPIにアクセスできます。

Data Kiosk の主な機能は次のとおりですAPI。

  • GraphQL を活用した動的レポート – は GraphQL クエリオペレーションAPIをサポートしており、必要な特定のデータを取得するためのカスタムクエリの作成に役立ちます。

  • 一括データアクセス – を介して大規模なデータセットにアクセスできAPI、包括的な分析とレポートを容易にします。

  • 柔軟なデータ探索 — GraphQL ベースのアプローチにより、動的でアドホックなデータ探索が可能になります。この柔軟性により、クエリの反復処理とインサイトの抽出が可能になります。

  • 包括的なデータカバレッジ – APIは、幅広い販売者およびベンダーデータへのアクセスを提供し、全体的なパフォーマンス分析とビジネスインテリジェンスを可能にします。

Data Kiosk のスキーマとディレクティブAPIは、GraphQL を介してデータにアクセスする構造化された方法を提供しAPI、特定のニーズに基づいてデータを集計およびフィルタリングできます。Data Kiosk を使用するとAPI、販売、トラフィック、分析データに関するより深く、より実用的なインサイトを得ることができます。これにより、情報に基づいたデータ駆動型の意思決定を行い、ビジネス戦略を最適化できます。

注記

クエリの保持は、リクエストされたフィールドによって異なります。スキーマ内の各フィールドには、そのフィールドを含むクエリを保持する期間を定義する@resultRetentionディレクティブがアノテーションされます。クエリに保持が異なる複数のフィールドが含まれている場合、最短 (最小) 保持が適用されます。クエリの結果ドキュメントの保持は常にクエリの保持と一致します。

販売者販売およびトラフィックデータ

Data Kiosk ではAPI、 Analytics_SalesAndTraffic_2024_04_24は販売クエリとトラフィッククエリのルートタイプです。このルートタイプでは、次の 2 つのクエリを使用できます。

  • salesAndTrafficByAsin は、 ASIN (PARENT、CHILD、または ) によって集計された売上データとトラフィックデータを取得しますSKU。

  • salesAndTrafficByDate は、日付 (DAY、WEEK、または ) で集計された売上およびトラフィックデータを取得しますMONTH。

これらのクエリについては、次の点に注意してください。

  • AsinGranularity や などの列挙型 (列挙型) はDateGranularity、集計のレベルを指定します。

  • Date などのスカラータイプは、データを表すために使用されます。

ベンダー分析データ

Data Kiosk ではAPI、 Analytics_vendorAnalytics_2024_09_30はベンダー分析クエリのルートタイプです。このルートタイプでは、次の 2 つのビューを使用できます。

  • manufacturingView は、お客様が製造する製品に関するメトリクスを、指定された日付で集計して取得します。

  • sourcingView は、Amazon に直接調達する製品に関するメトリクスを、指定された日付で集計して取得します。

ベンダー (SOURCING または ) として割り当てられたロールに基づいて、関連するビューとそれに関連するメトリクスにアクセスしますMANUFACTURING。これらのクエリには、開始日と終了日、マーケットプレイス識別子、集計メトリクス、合計メトリクスが含まれます。これらのクエリについては、次の点に注意してください。

  • メトリクスは、 ManufacturingViewMetricsGroupedBy および SourcingViewMetricsGroupedByタイプを使用して、さまざまな属性 ( ASINや ブランドなど) でグループ化されます。

  • 、、costs、 customerSatisfaction ordersなどのメトリクスタイプはproductAvailability、さまざまなメトリクスグループを表します。

  • DateGranularity 列挙型は、日付集計のレベルを指定します。

販売者の経済データ

販売者経済レポートでは、Amazon マーケットプレイスのパフォーマンスと財務状況を包括的に把握できます。販売データ、広告費、料金、コスト、純収益を対象としています。日付と製品識別子別にデータを集約できます。

Data Kiosk ではAPI、 Analytics_Economics_2024_03_15は販売者経済クエリのルートタイプです。特定の製品の販売者の経済データは、 Economicsタイプで表されます。このタイプには、次の重要な側面が含まれます。

  • ads – 指定された日付範囲内の製品の広告支出データ。

  • cost – この製品の販売者によって提供される Amazon オフコスト (単位あたり）。

  • fees – 指定された日付範囲内の製品に適用される料金。

  • fnsku – 製品のフルフィルメントネットワークストックキーピングユニット (FNSKU）。

  • msku – 製品のマーチャントストックキーピングユニット (MSKU）。

  • netProceeds – この製品の正味収益は、指定された日付範囲内です。

  • sales – 指定された日付範囲内の製品の販売データ。