Avaliar a performance

Use o serviço Reports para recuperar métricas de performance da sua conta.

Consulte a documentação do metrics para a lista completa de métricas disponíveis.

Requisitos

É necessário ter o papel de administrador de relatórios para recuperar esse relatório.

Para conceder a uma conta o papel "Administrador de relatórios", use accounts.update para definir o campo reportingManager como true. O papel "Gerente de relatórios" é equivalente ao papel "Performance e insights" no Merchant Center.

accounts.update substitui todo o recurso Account. Use accounts.get para acessar o recurso Account completo e forneça todos os campos na solicitação accounts.update para não perder informações.

Exemplo de consulta

A consulta a seguir recupera o impressions, clicks e ctr de todos os produtos na sua conta durante um período específico de 30 dias. Para fazer a solicitação, transmita a seguinte instrução da linguagem de consulta do Merchant Center para o método reports.search:

SELECT
  metrics.impressions,
  metrics.clicks,
  metrics.ctr
FROM MerchantPerformanceView
WHERE segments.date BETWEEN '2020-12-01' AND '2020-12-30'

Executar

Clique em Executar para testar o exemplo no APIs Explorer. Depois de clicar em Executar, atualize o marcador do ID do comerciante para seu próprio ID no URL da solicitação. É possível modificar a consulta. A consulta completa precisa permanecer em uma única linha para funcionar com o APIs Explorer.

Também é possível segmentar as métricas na consulta para gerar relatórios de desempenho mais granulares.

Consulte o Guia de produtos para saber como recuperar e filtrar produtos com o serviço Reports.