É possível recuperar as principais métricas de performance dos seus produtos participantes do Programa de Afiliados do YouTube usando a API Reports. Neste guia, explicamos como consultar dados de afiliados específicos do YouTube, como vendas, comissões, pedidos, visualizações e cliques, atribuídos a diferentes criadores de conteúdo, conteúdo de vídeo e produtos individuais.
Você pode usar a MCQL para selecionar métricas e dimensões das "visualizações" dedicadas do YouTube Affiliate, que funcionam como tabelas nas suas consultas.
Pré-requisitos
Antes de usar este guia, verifique se:
- A conta usada para autenticar chamadas de API tem a função Performance e insights, que concede acesso às métricas de performance.
- Sua conta do Google Merchant Center participa do Programa de Afiliados do YouTube.
Consultar o endpoint Alfa
Como este recurso está em versão Alfa pública, o endpoint é diferente. Para recuperar dados de performance de afiliados do YouTube, envie a solicitação POST para o endpoint v1alpha.
Confira um exemplo de solicitação:
HTTP
POST https://merchantapi.googleapis.com/reports/v1alpha/accounts/{ACCOUNT_ID}/reports:search
cURL
curl -X POST \
'https://merchantapi.googleapis.com/reports/v1alpha/accounts/{ACCOUNT_ID}/reports:search?key=[YOUR_API_KEY]' \
--header 'Authorization: Bearer [YOUR_ACCESS_TOKEN]' \
--header 'Accept: application/json' \
--compressed
Conferir a performance por criador de conteúdo
Para entender quais criadores de conteúdo do YouTube estão gerando mais engajamento e vendas, consulte a youtube_creator_performance_view.
Essa visualização agrega métricas por criadores de conteúdo individuais do YouTube e inclui títulos de criadores e IDs de canais.
Confira um exemplo de instrução SELECT da MCQL que você pode usar para conferir os três criadores de conteúdo com melhor desempenho por vendas entre 1º e 2 de maio de 2025.
SELECT
title,
channel_id,
sales,
commissions,
orders,
clicks,
views
FROM youtube_creator_performance_view
WHERE date BETWEEN '2025-05-01' AND '2025-05-02'
ORDER BY sales DESC LIMIT 3
Essa consulta busca o título do criador de conteúdo, o ID do canal e as principais métricas de performance dos três principais criadores de conteúdo classificados pela métrica de vendas no período especificado.
Ver a performance por conteúdo
Para saber quais vídeos específicos do YouTube estão com o melhor desempenho, consulte a
youtube_content_performance_view.
Essa visualização agrega métricas por vídeos individuais do YouTube e inclui títulos e IDs de vídeos.
Confira um exemplo de instrução SELECT do MCQL que você pode usar para receber os três principais vídeos por visualizações entre 1º e 2 de maio de 2025.
SELECT
title,
video_id,
views,
clicks,
sales
FROM youtube_content_performance_view
WHERE date BETWEEN '2025-05-01' AND '2025-05-02'
ORDER BY views DESC LIMIT 3
Essa consulta recupera o título, o ID e as principais métricas dos três vídeos mais assistidos, classificados pelo número total de views no período especificado.
Ver a performance por produto
Para analisar a performance de produtos individuais no Programa de Afiliados do YouTube, consulte youtube_product_performance_view.
Essa visualização agrega métricas por produto e inclui títulos e IDs de oferta.
Confira um exemplo de instrução SELECT da MCQL que você pode usar para encontrar os três principais produtos por valor de vendas entre 1º e 2 de maio de 2025:
SELECT
title,
offer_id,
sales,
commissions,
orders,
clicks
FROM youtube_product_performance_view
WHERE date BETWEEN '2025-05-01' AND '2025-05-02'
ORDER BY sales DESC LIMIT 3
Essa consulta retorna o título do produto, o ID da oferta e as métricas de performance dos três principais produtos, ordenados pela métrica sales, durante o período especificado.
Considerações importantes
- Datas: sempre filtre suas consultas por
dateusando cláusulasWHEREpara especificar o período do relatório. As datas estão no formatoYYYY-MM-DD. - Latência: a latência das consultas depende do volume de dados solicitado. Consultas grandes levam mais tempo e podem causar tempos limite.