É possível usar o serviço Reports
para recuperar métricas de performance da sua conta.
Consulte a documentação do metrics
para ver 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 atribuir o papel de administrador de relatórios a uma conta, use accounts.update
para definir o campo reportingManager
como true
.
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.
Amostra 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'
Clique em Executar para testar o exemplo na API Explorer. Depois de clicar em Executar, atualize o marcador para seu próprio ID do comerciante no URL da solicitação. É possível modificar a consulta. A consulta completa precisa permanecer em uma linha para trabalhar com o API 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
.