翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# Amazon Selling Partner API を通じて利用可能なデータ
[Amazon Selling Partner API](https://developer-docs.amazon.com/sp-api/docs/welcome) (SP-API) は、Amazon の販売者やベンダーが注文、出荷、支払いなどのデータにプログラムでアクセスできるようにする REST ベースの API です。この API のデータは、販売効率を高め、労働要件を減らし、顧客への応答時間を短縮できます。このガイドでは、[レポート用の販売パートナー API](https://developer-docs.amazon.com/sp-api/docs/reports-api-v2021-06-30-use-case-guide) (Reports API) と [Data Kiosk 用の販売パートナー API](https://developer-docs.amazon.com/sp-api/docs/data-kiosk-workflow-guide) (Data Kiosk API) を通じてアクセスできるデータに焦点を当てています。
## レポート API
Reports API のデータは、Amazon Marketplace でビジネスを管理するのに役立つように設計されています。[分析レポートは](https://developer-docs.amazon.com/sp-api/docs/report-type-values-analytics)、製品、顧客、全体的なパフォーマンスに関する貴重なインサイトを提供します。次に例を示します。
+ **売上パフォーマンス** – 売上データを分析すると、傾向と顧客の購入パターンを特定するのに役立ちます。この情報を使用して、販売戦略を最適化できます。
+ **製品パフォーマンス** – 製品データを分析すると、どの製品が売れていて、どの製品が売れていないかを特定するのに役立ちます。この情報を使用して、製品オファリングを最適化できます。
+ **顧客の行動** – 顧客データを分析すると、顧客の好みやニーズを理解するのに役立ちます。この情報を使用して、マーケティング戦略と販売戦略をパーソナライズできます。
次の表は、各[ブランド分析](https://developer-docs.amazon.com/sp-api/docs/report-type-values-analytics#brand-analytics-reports)レポートについて説明しています。以下のレポートは、ブランド分析販売パートナー API ロールを持ち、Amazon Brand Registry に登録されている Amazon 販売者およびベンダーが利用できます。
****
| レポートを行う | 説明 | パラメータ |
| --- | --- | --- |
| [マーケットバスケット分析レポート](https://developer-docs.amazon.com/sp-api/docs/report-type-values-analytics#market-basket-analysis-report) | チェックアウト時に顧客のバスケット (カート) の商品と組み合わせて最も一般的に購入される商品に関するデータを提供します。 | レポートは、さまざまなレポート期間 (DAY、WEEK、、MONTHまたは ) に対してリクエストできますQUARTER。データはこれらの期間にわたって提供されます。 |
| [Amazon 検索用語レポート](https://developer-docs.amazon.com/sp-api/docs/report-type-values-analytics#amazon-search-terms-report) | マーケットプレイスの検索キーワードと部門別に、最も頻繁に選択される Amazon 標準識別番号 (ASINs) のデータが含まれます。 | レポートは、さまざまなレポート期間 (DAY、WEEK、、MONTHまたは ) に対してリクエストできますQUARTER。リクエストは複数のレポート期間にまたがることはできません。 |
| [購入レポートを繰り返す](https://developer-docs.amazon.com/sp-api/docs/report-type-values-analytics#repeat-purchase) | 販売パートナーのアイテムの繰り返し購入数に関するデータが含まれます。 | レポートは、さまざまなレポート期間 (WEEK、MONTH、または ) に対してリクエストできますQUARTER。データは複数のレポート期間にまたがることができます。 |
次の表は、各[ベンダー小売分析](https://developer-docs.amazon.com/sp-api/docs/report-type-values-analytics#vendor-retail-analytics-reports)と[販売者小売分析](https://developer-docs.amazon.com/sp-api/docs/report-type-values-analytics#seller-retail-analytics-reports)レポートについて説明しています。
****
| レポートを行う | 説明 | 利用可能な状況 | パラメータ |
| --- | --- | --- | --- |
| [Rapid Retail Analytics インベントリレポート](https://developer-docs.amazon.com/sp-api/docs/report-type-values-analytics#rapid-retail-analytics-inventory-report) | ASIN レベルでのインベントリデータが含まれ、時間単位の詳細度に集計されます。 | ベンダー | レポートはリクエストのみ可能です。データは、現在の日付を含む複数の日付範囲期間にまたがることができます。 |
| [Rapid Retail Analytics トラフィックレポート](https://developer-docs.amazon.com/sp-api/docs/report-type-values-analytics#rapid-retail-analytics-traffic-report) | ベンダーの項目の詳細ページへの顧客トラフィックに関するデータを、時間単位の詳細度で含めます。 | ベンダー | レポートはリクエストのみ可能です。データは複数の日付範囲の期間にまたがることができます。 |
| [Rapid Retail Analytics 販売レポート](https://developer-docs.amazon.com/sp-api/docs/report-type-values-analytics#rapid-retail-analytics-sales-report) | ASIN レベルの売上データが含まれ、時間単位の詳細度に集計されます。 | ベンダー | レポートはリクエストのみ可能です。データは複数の日付範囲の期間にまたがることができます。 |
| [ベンダー販売レポート](https://developer-docs.amazon.com/sp-api/docs/report-type-values-analytics#vendor-sales-report) | カタログレベルと ASIN レベルで報告された主要な小売販売メトリクス (注文済みおよび出荷済み収益やユニットなど) が含まれます。 | ベンダー | レポートは、さまざまな に対してリクエストできます。[See the AWS documentation website for more details](http://docs.aws.amazon.com/ja_jp/prescriptive-guidance/latest/strategy-gen-ai-selling-partner-api/data-sp-api.html) |
| [Net Pure 製品マージンレポート](https://developer-docs.amazon.com/sp-api/docs/report-type-values-analytics#net-pure-product-margin-report) | カタログレベルと ASIN レベルで報告された、ベンダーの商品を販売するための Amazon の純純製品マージンに関するデータが含まれます。 | ベンダー | レポートは、さまざまなレポート期間 (DAY、WEEK、、QUARTER、または ) MONTHに対してリクエストできますYEAR。 |
| [ベンダートラフィックレポート](https://developer-docs.amazon.com/sp-api/docs/report-type-values-analytics#vendor-traffic-report) | カタログレベルおよび ASIN レベルでレポートされる、概要ビューなどの主要な小売トラフィックメトリクスが含まれます。 | ベンダー | レポートは、さまざまなレポート期間 (DAY、WEEK、、QUARTER、または ) MONTHに対してリクエストできますYEAR。 |
| [ベンダー予測レポート](https://developer-docs.amazon.com/sp-api/docs/report-type-values-analytics#vendor-forecasting-report) | 最新の週次予測生成日の ASIN レベルで報告された、フォワードルック平均、過去 70、過去 80、過去 90 件の週次顧客需要予測が含まれます。 | ベンダー | レポートは、さまざまな販売プログラム (RETAIL または ) に対してリクエストできますFRESH。 |
| [ベンダーインベントリレポート](https://developer-docs.amazon.com/sp-api/docs/report-type-values-analytics#vendor-inventory-report) | カタログレベルと ASIN レベルで報告されたインベントリと運用状態メトリクス (販売可能な手持ち単位やベンダーの確認率など) が含まれます。 | ベンダー | レポートは、さまざまな に対してリクエストできます。[See the AWS documentation website for more details](http://docs.aws.amazon.com/ja_jp/prescriptive-guidance/latest/strategy-gen-ai-selling-partner-api/data-sp-api.html) |
| [販売およびトラフィックビジネスレポート](https://developer-docs.amazon.com/sp-api/docs/report-type-values-analytics#sales-and-traffic-business-report) | 日付と ASIN 別に集計された、販売者のカタログ全体の主要な売上パフォーマンスメトリクス (注文済み製品の売上、収益、注文単位、請求額など) とページトラフィックメトリクス (ページビューや購入ボックスの割合など) が含まれます。 | 販売者 | レポートはリクエストまたはスケジュールできます。データは、さまざまな日付範囲集約レベル (DAY、WEEK、または MONTH) と ASIN 集約レベル (PARENT、CHILD、または ) に対して提供できますSKU。 |
## データキオスク API
Data Kiosk API は、[GraphQL](https://graphql.org/) ベースの動的レポートスイートを提供します。カスタム GraphQL クエリを生成し、Amazon のデータセットからバルクデータにアクセスするのに役立ちます。この API を使用して、次のような幅広いデータにアクセスできます。
+ [販売者販売およびトラフィックデータ](#data-kiosk-api-seller-sales-traffic-data)
+ [ベンダー分析データ](#data-kiosk-api-vendor-analytics-data)
+ [販売者の経済データ](#data-kiosk-api-seller-economics-data)
Data Kiosk API の主な機能は次のとおりです。
+ **GraphQL を活用した動的レポート** – API は GraphQL クエリオペレーションをサポートしているため、カスタムクエリを作成して必要な特定のデータを取得できます。
+ **バルクデータアクセス** – 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 ](https://the-guild.dev/graphql/scalars/docs/scalars/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` – 指定された日付範囲内の製品の売上データ。