Dados disponíveis por meio do Amazon Selling Partner API

O Amazon Selling Partner API (SP-API) é uma REST base API que ajuda vendedores e fornecedores da Amazon a acessar programaticamente seus dados sobre pedidos, remessas, pagamentos e muito mais. Os dados disso API podem aumentar a eficiência de vendas, reduzir os requisitos de mão de obra e melhorar o tempo de resposta aos clientes. Este guia se concentra nos dados que você pode acessar por meio do Selling Partner API for Reports (ReportsAPI) e do Selling Partner API for Data Kiosk (Data API Kiosk).

Relatórios API

Os dados dos Relatórios API foram projetados para ajudar você a gerenciar seus negócios no mercado da Amazon. Os relatórios analíticos fornecem informações valiosas sobre seus produtos, clientes e desempenho geral, como:

• Desempenho de vendas — A análise dos dados de vendas pode ajudar você a identificar tendências e padrões de compra dos clientes. Use essas informações para otimizar sua estratégia de vendas.

• Desempenho do produto — A análise dos dados do produto pode ajudá-lo a identificar quais produtos estão vendendo bem e quais não estão. Use essas informações para otimizar suas ofertas de produtos.

• Comportamento do cliente — Analisar os dados do cliente pode ajudá-lo a entender as preferências e necessidades de seus clientes. Você pode usar essas informações para personalizar suas estratégias de marketing e vendas.

A tabela a seguir explica cada relatório de análise de marca. Os relatórios a seguir estão disponíveis para vendedores e fornecedores da Amazon que têm a API função de parceiro de vendas do Brand Analytics e estão registrados no Registro de Marcas da Amazon.

Relatório	Descrição	Parâmetros
Relatório de análise da cesta de mercado	Fornece dados sobre os itens que são comprados com mais frequência em combinação com os itens na cesta do cliente (carrinho) na finalização da compra	O relatório pode ser solicitado para diferentes períodos de relatório (DAY,WEEK,MONTH, ouQUARTER). Os dados são fornecidos nesses períodos.
Relatório de termos de pesquisa da Amazon	Contém dados sobre os números de identificação padrão da Amazon (ASINs) selecionados com mais frequência, por palavra-chave de pesquisa e departamento de um mercado	O relatório pode ser solicitado para diferentes períodos de relatório (DAY,WEEK,MONTH, ouQUARTER). As solicitações não podem abranger vários períodos de geração de relatórios.
Relatório de compra repetida	Contém dados sobre a quantidade de compras repetidas dos itens do parceiro de vendas	O relatório pode ser solicitado para diferentes períodos de relatório (WEEK,MONTH, ouQUARTER). Os dados podem abranger vários períodos de geração de relatórios.

A tabela a seguir explica a análise de varejo de cada fornecedor e o relatório de análise de varejo do vendedor.

Relatório	Descrição	Disponibilidade	Parâmetros
Relatório de inventário do Rapid Retail Analytics	Contém dados de inventário em um ASIN nível, agregados a uma granularidade horária	Fornecedores	O relatório só pode ser solicitado. Os dados podem abranger vários períodos de intervalo de datas, incluindo o dia atual.
Relatório de tráfego do Rapid Retail Analytics	Contém dados sobre o tráfego de clientes nas páginas de detalhes dos itens do fornecedor, com granularidade horária	Fornecedores	O relatório só pode ser solicitado. Os dados podem abranger vários períodos de intervalo de datas.
Relatório de vendas do Rapid Retail Analytics	Contém dados de vendas em um ASIN nível, agregados a uma granularidade horária	Fornecedores	O relatório só pode ser solicitado. Os dados podem abranger vários períodos de intervalo de datas.
Relatório de vendas do fornecedor	Contém as principais métricas de vendas no varejo (como receita e unidades encomendadas e enviadas), relatadas no nível do catálogo e no ASIN nível	Fornecedores	O relatório pode ser solicitado para diferentes: Períodos de relatório (DAYWEEKMONTH,QUARTER,, ouYEAR) Visualizações do distribuidor (MANUFACTURINGouSOURCING) Vendendo programas (RETAIL,BUSINESS, ouFRESH)
Relatório de margem do produto Net Pure	Contém dados sobre as margens líquidas de produtos puros da Amazon para vender os itens de um fornecedor, relatadas no nível do catálogo e no nível ASIN	Fornecedores	O relatório pode ser solicitado para diferentes períodos de relatório (DAY,WEEK,MONTH,QUARTER, ouYEAR).
Relatório de tráfego do fornecedor	Contém as principais métricas de tráfego de varejo, como visualizações rápidas, relatadas no nível do catálogo e no ASIN nível	Fornecedores	O relatório pode ser solicitado para diferentes períodos de relatório (DAY,WEEK,MONTH,QUARTER, ouYEAR).
Relatório de previsão do fornecedor	Contém previsões de demanda de clientes com média prospectiva de 70, 80 e 90 semanas anteriores, relatadas no ASIN nível da data de geração da previsão semanal mais recente	Fornecedores	O relatório pode ser solicitado para diferentes programas de venda (RETAILouFRESH).
Relatório de inventário do fornecedor	Contém métricas de inventário e integridade operacional (como unidades disponíveis comercializáveis e taxa de confirmação do fornecedor), relatadas no nível do catálogo e no nível ASIN	Fornecedores	O relatório pode ser solicitado para diferentes: Períodos de relatório (DAYWEEKMONTH,QUARTER,, ouYEAR) Visualizações do distribuidor (MANUFACTURINGouSOURCING) Vendendo programas (RETAILouFRESH)
Relatório de negócios de vendas e tráfego	Contém as principais métricas de desempenho de vendas (como vendas de produtos pedidos, receita, unidades pedidas e valor da reclamação) e métricas de tráfego de página (como visualizações de página e porcentagem da caixa de compra) de todo o catálogo do vendedor, agregadas por data e ASIN	Vendedores	O relatório pode ser solicitado ou agendado. Os dados podem ser fornecidos para diferentes níveis de agregação de intervalo de datas (DAY,WEEK, ouMONTH) e níveis de ASIN agregação (PARENT,CHILD, ouSKU).

Quiosque de dados API

O Data Kiosk API fornece um conjunto de relatórios dinâmicos baseado em GraphQL. Ele ajuda você a gerar consultas personalizadas do GraphQL e acessar dados em massa dos conjuntos de dados da Amazon. Você pode usar isso API para acessar uma ampla variedade de dados, incluindo:

• Dados de vendas e tráfego do vendedor

• Dados de análise do fornecedor

• Dados econômicos do vendedor

A seguir estão os principais recursos do Data KioskAPI:

• Relatórios dinâmicos baseados em API GraphQL — Suporta operações de consulta GraphQL, ajudando você a criar consultas personalizadas para recuperar os dados específicos de que você precisa.

• Acesso a dados em massa — Você pode acessar grandes conjuntos de dados por meio doAPI, facilitando análises e relatórios abrangentes.

• Exploração flexível de dados — A abordagem baseada em GraphQL permite a exploração dinâmica e ad-hoc de dados. Essa flexibilidade ajuda você a iterar consultas e extrair insights.

• Cobertura de dados abrangente — API Fornece acesso a uma ampla variedade de dados de vendedores e fornecedores, permitindo uma análise holística de desempenho e inteligência comercial.

Os esquemas e diretivas no Data Kiosk API fornecem uma maneira estruturada de acessar seus dados por meio de um GraphQLAPI, com a capacidade de agregar e filtrar os dados com base em suas necessidades específicas. Ao usar o Data KioskAPI, você pode obter insights mais profundos e acionáveis sobre dados de vendas, tráfego e análise. Isso permite que você tome decisões informadas e baseadas em dados para otimizar suas estratégias de negócios.

nota

A retenção de uma consulta varia de acordo com os campos solicitados. Cada campo em um esquema é anotado com uma @resultRetention diretiva que define por quanto tempo uma consulta contendo esse campo será retida. Quando uma consulta contém vários campos com retenções diferentes, a retenção mais curta (mínima) é aplicada. A retenção dos documentos resultantes de uma consulta sempre corresponde à retenção da consulta.

Dados de vendas e tráfego do vendedor

No Data KioskAPI, Analytics_SalesAndTraffic_2024_04_24 é o tipo raiz para consultas de vendas e tráfego. Duas consultas estão disponíveis para esse tipo raiz:

• salesAndTrafficByAsinrecupera dados de vendas e tráfego que são agregados por ASIN (PARENT,CHILD, ouSKU).

• salesAndTrafficByDaterecupera dados de vendas e tráfego que são agregados por data (DAY,WEEK, ouMONTH).

Observe o seguinte sobre essas consultas:

• Tipos enumerados (enums), como AsinGranularity eDateGranularity, especificam o nível de agregação.

• Tipos escalares, como Data, são usados para representar os dados.

Dados de análise do fornecedor

No Data KioskAPI, Analytics_vendorAnalytics_2024_09_30 é o tipo raiz para consultas de análise de fornecedores. Duas visualizações estão disponíveis para esse tipo de raiz:

• manufacturingViewrecupera métricas sobre os produtos que você fabrica, agregadas pela data especificada.

• sourcingViewrecupera métricas sobre produtos que você compra diretamente para a Amazon, agregadas pela data especificada.

Você acessa a visualização relevante e suas métricas associadas com base na função atribuída a você como fornecedor (SOURCINGouMANUFACTURING). Essas consultas incluem as datas de início e término, o identificador do mercado, as métricas agregadas e as métricas totais. Observe o seguinte sobre essas consultas:

• As métricas são agrupadas por vários atributos (como ASIN marca) usando os SourcingViewMetricsGroupedBy tipos ManufacturingViewMetricsGroupedBy e.

• Os tipos de métricascosts, comocustomerSatisfaction,orders, eproductAvailability, representam os diferentes grupos de métricas.

• A DateGranularity enumeração especifica o nível de agregação de datas.

Dados econômicos do vendedor

O relatório econômico do vendedor fornece uma visão abrangente de seu desempenho e suas finanças no mercado da Amazon. Ele abrange dados de vendas, gastos com publicidade, taxas, custos e receita líquida. Você pode agregar os dados por data e identificador do produto.

No Data KioskAPI, Analytics_Economics_2024_03_15 é o tipo raiz para consultas econômicas do vendedor. Os dados econômicos do vendedor de um determinado produto são representados pelo Economics tipo. Esse tipo inclui os seguintes aspectos principais:

• ads— Os dados de gastos com publicidade do produto dentro do intervalo de datas especificado.

• cost— O custo da Amazon fornecido pelo vendedor para este produto (por unidade).

• fees— As taxas aplicadas ao produto dentro do intervalo de datas especificado.

• fnsku— A Unidade de Manutenção de Estoque da Rede de Atendimento (FNSKU) do produto.

• msku— A Unidade de Manutenção de Estoque do Comerciante (MSKU) do produto.

• netProceeds— A receita líquida deste produto dentro do intervalo de datas especificado.

• sales— Os dados de vendas do produto dentro do intervalo de datas especificado.