Analyze YouTube Affiliate Performance (Alpha)

É 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:

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 date usando cláusulas WHERE para especificar o período do relatório. As datas estão no formato YYYY-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.