View a markdown version of this page

可通过 Amazon 销售合作伙伴 API 获得的数据 - AWS 规范性指导
报告 API数据亭 API

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

可通过 Amazon 销售合作伙伴 API 获得的数据

亚马逊销售伙伴 API (SP-AP I) 是一个基于 REST 的 API，可帮助亚马逊卖家和供应商以编程方式访问其订单、发货、付款等数据。来自此 API 的数据可以提高销售效率、降低人工需求并缩短对客户的响应时间。本指南重点介绍您可以通过销售合作伙伴报告 API（报告 API）和适用于数据亭的销售合作伙伴 API（数据亭 API）访问的数据。

报告 API

来自报告 API 的数据旨在帮助您管理您在亚马逊商城上的业务。分析报告提供了有关您的产品、客户和整体绩效的宝贵见解，例如：

  • 销售业绩-分析销售数据可以帮助您确定趋势和客户购买模式。您可以使用这些信息来优化您的销售策略。

  • 产品绩效 — 分析产品数据可以帮助您确定哪些产品畅销，哪些不畅销。您可以使用这些信息来优化您的产品供应。

  • 客户行为 — 分析客户数据可以帮助您了解客户的偏好和需求。您可以使用这些信息来个性化您的营销和销售策略。

下表说明了每份品牌分析报告。以下报告适用于拥有品牌分析销售合作伙伴 API 角色且已在 “亚马逊品牌注册” 中注册的亚马逊卖家和供应商。

报告 说明 参数
市场篮子分析报告 在结账时提供有关最常与客户购物篮（购物车）中的商品组合购买的商品的数据 可以为不同的报告期（DAY、WEEKMONTH、或QUARTER）请求报告。这些数据是在这些时期内提供的。
Amazon 搜索词报告 包含商城中最常选择的亚马逊标准识别码 (ASINs) 的数据，按搜索关键词和部门划分 可以为不同的报告期（DAY、WEEKMONTH、或QUARTER）请求报告。请求不能跨越多个报告期。
重复购买报告 包含卖方重复购买商品的数量数据 可以为不同的报告期（WEEKMONTH、或QUARTER）请求报告。数据可以跨越多个报告期。

下表说明了每份供应商零售分析和卖家零售分析报告。

报告 说明 可用性 参数
快速零售分析库存报告 包含 ASIN 级别的库存数据，按小时精细度汇总 供应商 只能请求报告。数据可以跨越多个日期范围周期，包括当天。
快速零售分析流量报告 包含有关客户访问供应商商品详情页面的流量数据，按小时精细度排列 供应商 只能请求报告。数据可以跨越多个日期范围周期。
快速零售分析销售报告 包含 ASIN 级别的销售数据，按小时精细度汇总 供应商 只能请求报告。数据可以跨越多个日期范围周期。
供应商销售报告 包含在目录级别和 ASIN 级别报告的关键零售销售指标（例如订购和已配送的收入和商品数量） 供应商

可以针对不同的情况要求报告：

  • 报告周期（DAYWEEK、MONTH、QUARTER、或YEAR）

  • 分销商视图（MANUFACTURING或SOURCING）

  • 销售计划（RETAILBUSINESS、或FRESH）
纯产品净利润率报告 包含在目录级别和 ASIN 级别报告的亚马逊销售供应商商品的纯商品净利润率数据 供应商 可以为不同的报告期（DAY、、WEEKMONTHQUARTER、或YEAR）请求报告。
供应商流量报告 包含在目录级别和 ASIN 级别报告的关键零售流量指标，例如浏览次数 供应商 可以为不同的报告期（DAY、、WEEKMONTHQUARTER、或YEAR）请求报告。
供应商预测报告 包含前瞻性平均值、之前的 70 周、之前的 80 周和之前的 90 周客户需求预测，按最近一周预测生成日期的 ASIN 级别报告 供应商 可以为不同的销售计划申请报告（RETAIL或FRESH）。
供应商库存报告 包含在目录级别和 ASIN 级别报告的库存和运营状况指标（例如可售的现有商品和供应商确认率） 供应商

可以针对不同的情况要求报告：

  • 报告周期（DAYWEEK、MONTH、QUARTER、或YEAR）

  • 分销商视图（MANUFACTURING或SOURCING）

  • 销售计划（RETAIL或FRESH）
销售和流量业务报告 包含按日期和 ASIN 汇总的卖家整个目录的关键销售业绩指标（例如订购商品的销量、收入、订购的商品数量和索赔金额）和页面流量指标（例如页面浏览量和购买按钮百分比） 卖家 可以请求或安排报告。可以为不同的日期范围汇总级别（DAYWEEK、或MONTH）和 ASIN 汇总级别（PARENTCHILD、或SKU）提供数据。

数据亭 API

数据亭 API 提供了基于 GraphQL 的动态报告套件。它可以帮助您生成自定义 GraphQL 查询并访问亚马逊数据集中的批量数据。您可以使用此 API 访问各种数据，包括：

以下是 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是销售和流量查询的根类型。此根类型有两个查询可用：

  • salesAndTrafficByAsin检索按 ASIN（PARENTCHILD、或SKU）汇总的销售和流量数据。

  • salesAndTrafficByDate检索按日期（DAY、WEEK或MONTH）汇总的销售和流量数据。

请注意有关这些查询的以下内容：

  • 枚举类型（枚举），例如AsinGranularity和DateGranularity，用于指定聚合级别。

  • 标量类型（例如 Dat e）用于表示数据。

供应商分析数据

在 Data Kiosk API 中，Analytics_vendorAnalytics_2024_09_30是供应商分析查询的根类型。此根类型有两个视图可用：

  • manufacturingView检索按指定日期汇总的有关您制造的商品的指标。

  • sourcingView检索有关您直接向亚马逊采购的商品的指标，这些指标按指定日期汇总。

您可以根据分配给您的供应商（SOURCING或MANUFACTURING）角色访问相关视图及其关联指标。这些查询包括开始日期和结束日期、市场标识符、汇总指标和总指标。请注意有关这些查询的以下内容：

  • 使用和SourcingViewMetricsGroupedBy类型按各种属性（例如 ASIN 或品牌）对指标ManufacturingViewMetricsGroupedBy进行分组。

  • 指标类型，例如costs、customerSatisfactionorders、和productAvailability，代表不同的指标组。

  • DateGranularity枚举指定了日期聚合的级别。

卖方经济数据

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

在 Data Kiosk API 中，Analytics_Economics_2024_03_15是卖家经济学查询的根类型。给定产品的卖家经济数据由Economics类型表示。这种类型包括以下关键方面：

  • ads— 指定日期范围内产品的广告支出数据。

  • cost— 卖家提供的此商品的 Amazon 折扣价格（每件）。

  • fees— 在指定日期范围内对产品收取的费用。

  • fnsku— 商品的配送网络库存单位 (FNSKU)。

  • msku— 商品的卖家库存单位 (MSKU)。

  • netProceeds— 该产品在指定日期范围内的净收益。

  • sales— 指定日期范围内产品的销售数据。