本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 可通过 Amazon 销售合作伙伴 API 获得的数据
<a name="data-sp-api"></a>

[亚马逊销售伙伴 API (SP-AP](https://developer-docs.amazon.com/sp-api/docs/welcome) I) 是一个基于 REST 的 API，可帮助亚马逊卖家和供应商以编程方式访问其订单、发货、付款等数据。来自此 API 的数据可以提高销售效率、降低人工需求并缩短对客户的响应时间。本指南重点介绍您可以通过[销售合作伙伴报告 API（报告 API）和适用于](https://developer-docs.amazon.com/sp-api/docs/reports-api-v2021-06-30-use-case-guide)数据亭的[销售合作伙伴 API（数据亭](https://developer-docs.amazon.com/sp-api/docs/data-kiosk-workflow-guide) API）访问的数据。

## 报告 API
<a name="data-reports-api"></a>

来自报告 API 的数据旨在帮助您管理您在亚马逊商城上的业务。[分析报告](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 角色且已在 “亚马逊品牌注册” 中注册的亚马逊卖家和供应商。


****  

| 报告 | 说明 | 参数 | 
| --- | --- | --- | 
| [市场篮子分析报告](https://developer-docs.amazon.com/sp-api/docs/report-type-values-analytics#market-basket-analysis-report) | 在结账时提供有关最常与客户购物篮（购物车）中的商品组合购买的商品的数据 | 可以为不同的报告期（DAY、WEEKMONTH、或QUARTER）请求报告。这些数据是在这些时期内提供的。 | 
| [Amazon 搜索词报告](https://developer-docs.amazon.com/sp-api/docs/report-type-values-analytics#amazon-search-terms-report) | 包含商城中最常选择的亚马逊标准识别码 (ASINs) 的数据，按搜索关键词和部门划分 | 可以为不同的报告期（DAY、WEEKMONTH、或QUARTER）请求报告。请求不能跨越多个报告期。 | 
| [重复购买报告](https://developer-docs.amazon.com/sp-api/docs/report-type-values-analytics#repeat-purchase) | 包含卖方重复购买商品的数量数据 | 可以为不同的报告期（WEEKMONTH、或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)报告。


****  

| 报告 | 说明 | 可用性 | 参数 | 
| --- | --- | --- | --- | 
| [快速零售分析库存报告](https://developer-docs.amazon.com/sp-api/docs/report-type-values-analytics#rapid-retail-analytics-inventory-report) | 包含 ASIN 级别的库存数据，按小时精细度汇总 | 供应商 | 只能请求报告。数据可以跨越多个日期范围周期，包括当天。 | 
| [快速零售分析流量报告](https://developer-docs.amazon.com/sp-api/docs/report-type-values-analytics#rapid-retail-analytics-traffic-report) | 包含有关客户访问供应商商品详情页面的流量数据，按小时精细度排列 | 供应商 | 只能请求报告。数据可以跨越多个日期范围周期。 | 
| [快速零售分析销售报告](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/zh_cn/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#net-pure-product-margin-report) | 包含在目录级别和 ASIN 级别报告的亚马逊销售供应商商品的纯商品净利润率数据 | 供应商 | 可以为不同的报告期（DAY、、WEEKMONTHQUARTER、或YEAR）请求报告。 | 
| [供应商流量报告](https://developer-docs.amazon.com/sp-api/docs/report-type-values-analytics#vendor-traffic-report) | 包含在目录级别和 ASIN 级别报告的关键零售流量指标，例如浏览次数 | 供应商 | 可以为不同的报告期（DAY、、WEEKMONTHQUARTER、或YEAR）请求报告。 | 
| [供应商预测报告](https://developer-docs.amazon.com/sp-api/docs/report-type-values-analytics#vendor-forecasting-report) | 包含前瞻性平均值、之前的 70 周、之前的 80 周和之前的 90 周客户需求预测，按最近一周预测生成日期的 ASIN 级别报告 | 供应商 | 可以为不同的销售计划申请报告（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/zh_cn/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 汇总的卖家整个目录的关键销售业绩指标（例如订购商品的销量、收入、订购的商品数量和索赔金额）和页面流量指标（例如页面浏览量和购买按钮百分比） | 卖家 | 可以请求或安排报告。可以为不同的日期范围汇总级别（DAYWEEK、或MONTH）和 ASIN 汇总级别（PARENTCHILD、或SKU）提供数据。 | 

## 数据亭 API
<a name="data-kiosk-api"></a>

数据亭 API 提供了基于 [GraphQL](https://graphql.org/) 的动态报告套件。它可以帮助您生成自定义 GraphQL 查询并访问亚马逊数据集中的批量数据。您可以使用此 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`指令定义了包含该字段的查询将保留多长时间。当查询包含多个保留期不同的字段时，将应用最短（最小）的保留期。查询结果文档的保留始终与查询的保留期相匹配。

### 卖家销售和流量数据
<a name="data-kiosk-api-seller-sales-traffic-data"></a>

在 Data Kiosk API 中，`Analytics_SalesAndTraffic_2024_04_24`是销售和流量查询的根类型。此根类型有两个查询可用：
+ `salesAndTrafficByAsin`检索按 ASIN（`PARENT``CHILD`、或`SKU`）汇总的销售和流量数据。
+ `salesAndTrafficByDate`检索按日期（`DAY`、`WEEK`或`MONTH`）汇总的销售和流量数据。

请注意有关这些查询的以下内容：
+ 枚举类型（枚举），例如`AsinGranularity`和`DateGranularity`，用于指定聚合级别。
+ 标量类型（例如 [Dat](https://the-guild.dev/graphql/scalars/docs/scalars/date) e）用于表示数据。

### 供应商分析数据
<a name="data-kiosk-api-vendor-analytics-data"></a>

在 Data Kiosk API 中，`Analytics_vendorAnalytics_2024_09_30`是供应商分析查询的根类型。此根类型有两个视图可用：
+ `manufacturingView`检索按指定日期汇总的有关您制造的商品的指标。
+ `sourcingView`检索有关您直接向亚马逊采购的商品的指标，这些指标按指定日期汇总。

您可以根据分配给您的供应商（`SOURCING`或`MANUFACTURING`）角色访问相关视图及其关联指标。这些查询包括开始日期和结束日期、市场标识符、汇总指标和总指标。请注意有关这些查询的以下内容：
+ 使用和`SourcingViewMetricsGroupedBy`类型按各种属性（例如 ASIN 或品牌）对指标`ManufacturingViewMetricsGroupedBy`进行分组。
+ 指标类型，例如`costs`、`customerSatisfaction``orders`、和`productAvailability`，代表不同的指标组。
+ `DateGranularity`枚举指定了日期聚合的级别。

### 卖方经济数据
<a name="data-kiosk-api-seller-economics-data"></a>

卖家经济报告全面介绍了您在亚马逊商城的业绩和财务状况。它涵盖了销售数据、广告支出、费用、成本和净收益。您可以按日期和产品标识符汇总数据。

在 Data Kiosk API 中，`Analytics_Economics_2024_03_15`是卖家经济学查询的根类型。给定产品的卖家经济数据由`Economics`类型表示。这种类型包括以下关键方面：
+ `ads`— 指定日期范围内产品的广告支出数据。
+ `cost`— 卖家提供的此商品的 Amazon 折扣价格（每件）。
+ `fees`— 在指定日期范围内对产品收取的费用。
+ `fnsku`— 商品的配送网络库存单位 (FNSKU)。
+ `msku`— 商品的卖家库存单位 (MSKU)。
+ `netProceeds`— 该产品在指定日期范围内的净收益。
+ `sales`— 指定日期范围内产品的销售数据。