As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá. # Dados disponíveis por meio da API do Amazon Selling Partner A [API Amazon Selling Partner](https://developer-docs.amazon.com/sp-api/docs/welcome) (SP-API) é uma API baseada em REST que ajuda vendedores e fornecedores da Amazon a acessar programaticamente seus dados sobre pedidos, remessas, pagamentos e muito mais. Os dados dessa 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 da [Selling Partner API for Reports](https://developer-docs.amazon.com/sp-api/docs/reports-api-v2021-06-30-use-case-guide) (API Reports) e da [Selling Partner API for Data Kiosk](https://developer-docs.amazon.com/sp-api/docs/data-kiosk-workflow-guide) (API Data Kiosk). ## API de relatórios Os dados da API de relatórios foram projetados para ajudar você a gerenciar seus negócios no mercado da Amazon. Os [relatórios analíticos](https://developer-docs.amazon.com/sp-api/docs/report-type-values-analytics) 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. Você pode usar 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. Você pode usar 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](https://developer-docs.amazon.com/sp-api/docs/report-type-values-analytics#brand-analytics-reports). Os relatórios a seguir estão disponíveis para vendedores e fornecedores da Amazon que têm a função Brand Analytics Selling Partner API e estão registrados no Registro de Marcas da Amazon. **** | Relatório | Description | Parâmetros | | --- | --- | --- | | [Relatório de análise da cesta de mercado](https://developer-docs.amazon.com/sp-api/docs/report-type-values-analytics#market-basket-analysis-report) | 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](https://developer-docs.amazon.com/sp-api/docs/report-type-values-analytics#amazon-search-terms-report) | 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](https://developer-docs.amazon.com/sp-api/docs/report-type-values-analytics#repeat-purchase) | 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](https://developer-docs.amazon.com/sp-api/docs/report-type-values-analytics#vendor-retail-analytics-reports) [de varejo do vendedor](https://developer-docs.amazon.com/sp-api/docs/report-type-values-analytics#seller-retail-analytics-reports). **** | Relatório | Description | Disponibilidade | Parâmetros | | --- | --- | --- | --- | | [Relatório de inventário do Rapid Retail Analytics](https://developer-docs.amazon.com/sp-api/docs/report-type-values-analytics#rapid-retail-analytics-inventory-report) | Contém dados de inventário em um nível ASIN, 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](https://developer-docs.amazon.com/sp-api/docs/report-type-values-analytics#rapid-retail-analytics-traffic-report) | 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](https://developer-docs.amazon.com/sp-api/docs/report-type-values-analytics#rapid-retail-analytics-sales-report) | Contém dados de vendas em um nível ASIN, 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](https://developer-docs.amazon.com/sp-api/docs/report-type-values-analytics#vendor-sales-report) | 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 nível do ASIN | Fornecedores | O relatório pode ser solicitado para diferentes:[See the AWS documentation website for more details](http://docs.aws.amazon.com/pt_br/prescriptive-guidance/latest/strategy-gen-ai-selling-partner-api/data-sp-api.html) | | [Relatório de margem do produto Net Pure](https://developer-docs.amazon.com/sp-api/docs/report-type-values-analytics#net-pure-product-margin-report) | 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 do 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](https://developer-docs.amazon.com/sp-api/docs/report-type-values-analytics#vendor-traffic-report) | 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 nível do ASIN | 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](https://developer-docs.amazon.com/sp-api/docs/report-type-values-analytics#vendor-forecasting-report) | Contém previsões de demanda de clientes com média prospectiva de 70, 80 e 90 semanas anteriores, relatadas no nível ASIN para a data de geração de 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](https://developer-docs.amazon.com/sp-api/docs/report-type-values-analytics#vendor-inventory-report) | 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 do ASIN | Fornecedores | O relatório pode ser solicitado para diferentes:[See the AWS documentation website for more details](http://docs.aws.amazon.com/pt_br/prescriptive-guidance/latest/strategy-gen-ai-selling-partner-api/data-sp-api.html) | | [Relatório de negócios de vendas e tráfego](https://developer-docs.amazon.com/sp-api/docs/report-type-values-analytics#sales-and-traffic-business-report) | 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) para 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 agregação de ASIN (PARENT,CHILD, ou). SKU | ## API de quiosque de dados A API Data Kiosk fornece um pacote de relatórios dinâmicos baseado em [GraphQL](https://graphql.org/). Ele ajuda você a gerar consultas personalizadas do GraphQL e acessar dados em massa dos conjuntos de dados da Amazon. Você pode usar essa API para acessar uma ampla variedade de dados, incluindo: + [Dados de vendas e tráfego do vendedor](#data-kiosk-api-seller-sales-traffic-data) + [Dados de análise do fornecedor](#data-kiosk-api-vendor-analytics-data) + [Dados econômicos do vendedor](#data-kiosk-api-seller-economics-data) A seguir estão os principais recursos da API Data Kiosk: + **Relatórios dinâmicos baseados em GraphQL** — A API suporta operações de consulta do 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 da API, 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** — A 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 na API Data Kiosk fornecem uma maneira estruturada de acessar seus dados por meio de uma API GraphQL, com a capacidade de agregar e filtrar os dados com base em suas necessidades específicas. Ao usar a API Data Kiosk, 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 Na API Data Kiosk, `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: + `salesAndTrafficByAsin`recupera dados de vendas e tráfego que são agregados pelo ASIN (`PARENT`,`CHILD`, ou). `SKU` + `salesAndTrafficByDate`recupera dados de vendas e tráfego que são agregados por data (`DAY`,`WEEK`, ou`MONTH`). Observe o seguinte sobre essas consultas: + Tipos enumerados (enums), como `AsinGranularity` e`DateGranularity`, especificam o nível de agregação. + Tipos escalares, como [Data](https://the-guild.dev/graphql/scalars/docs/scalars/date), são usados para representar os dados. ### Dados de análise do fornecedor Na API Data Kiosk, `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: + `manufacturingView`recupera métricas sobre os produtos que você fabrica, agregadas pela data especificada. + `sourcingView`recupera 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 (`SOURCING`ou`MANUFACTURING`). 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 ou marca) usando os tipos `ManufacturingViewMetricsGroupedBy` e. `SourcingViewMetricsGroupedBy` + Os tipos de métricas`costs`, como`customerSatisfaction`,`orders`, e`productAvailability`, 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. Na API Data Kiosk, `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 Comercial (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.