Partilhar via


Introdução ao acesso programático a dados analíticos para o mercado comercial

Este guia ajuda você a se integrar ao acesso programático aos dados do Commercial Marketplace Analytics. Você aprenderá como acessar programaticamente relatórios analíticos para monitorar vendas, avaliar o desempenho e otimizar ofertas no mercado comercial. As ferramentas de análise aprimoradas permitem que você atue com base nos resultados de desempenho e mantenha melhores relacionamentos com seus clientes e revendedores.

Importante

A versão 1.1 das APIs já está ativa. Migre a implementação existente para a versão mais recente

Sobre este guia

Você pode usar este guia para acessar programaticamente os dados de análise do mercado comercial. Usando os métodos e APIs documentados neste guia, você pode agendar relatórios personalizados e ingerir conjuntos de dados importantes em seus sistemas internos de análise. Você pode monitorar efetivamente as vendas, avaliar o desempenho e otimizar suas ofertas no mercado comercial.

A API para acessar relatórios do mercado comercial permite que você agende relatórios personalizados de seus dados de análise de forma assíncrona. O recurso permite que você defina consultas/modelos de relatórios com base em suas necessidades, defina um cronograma e obtenha relatórios oportunos e confiáveis em intervalos agendados.

O principal valor do acesso programático aos dados analíticos do mercado comercial é a geração de relatórios personalizados e a integração com sistemas e plataformas de BI internos.

Observação

Os parceiros precisam de recursos de engenharia dedicados para fazer uma integração única na interface da API.

Registo de alterações da versão 1.1

  • Contagem de recorrência: O parâmetro de contagem de recorrência agora é obrigatório. Isso significa que todos os relatórios agendados devem ter uma contagem de recorrência.

  • Execution GET API: A versão 1.1 da API de execução GET retornará informações adicionais sobre a contagem de recorrências (restantes), data de término e o próximo momento de início da execução.

  • API de PUT de Relatório Agendado: A versão 1.1 da API permitirá que os usuários atualizem a data de término dos seus relatórios agendados, além da contagem de recorrência.

  • Os limites de contagem de recorrência são baseados no Intervalo de Recorrência dos relatórios agendados.

Advertência

A versão 1.0 da API será preterida em 6 meses, terminando em 30 de junho de 2024. Isso significa que não forneceremos mais suporte ou atualizações para esta versão após essa data. Planeje a migração de acordo.

Instruções de migração da v1 para a v1.1: Para migrar para a versão 1.1 da API, siga estas etapas:

  • Atualize o seu código para usar o novo endpoint para a versão 1.1 da API.

  • Atualize todas as solicitações ou respostas que fazem referência a campos que foram adicionados ou alterados na versão 1.1.

  • Teste seu código completamente para garantir que ele seja compatível com a versão 1.1 da API.

  • Monitore seu aplicativo para garantir que ele esteja funcionando corretamente com a nova versão da API.