Analyze YouTube Affiliate Performance (Alpha)

É possível extrair as principais métricas de performance dos seus produtos participantes do Programa de Afiliados do YouTube usando a API Reports. Este guia explica 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, vídeos e produtos individuais.

Você pode usar o MCQL para selecionar métricas e dimensões de "visualizações" dedicadas de afiliados do YouTube, 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 o papel de 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 essa versão é Alfa pública, o endpoint é diferente. Para extrair dados de performance de afiliados do YouTube, envie a solicitação POST para o v1alpha endpoint. Confira um exemplo de solicitação:

POST https://merchantapi.googleapis.com/reports/v1alpha/accounts/{ACCOUNT_ID}/reports:search

  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 criador de conteúdo do YouTube e inclui títulos e IDs de canais.

Confira um exemplo de instrução SELECT do MCQL que você pode usar para conferir os três criadores de conteúdo com melhor performance 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 criadores de conteúdo com melhor classificação pela métrica de vendas no período especificado.

Conferir a performance por conteúdo

Para saber quais vídeos específicos do YouTube estão com melhor performance, 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.

Para extrair os três vídeos com mais visualizações entre 1º e 2 de maio de 2025, transmita a seguinte instrução da linguagem de consulta do Merchant Center para o método accounts.reports.search:

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 extrai o título, o ID do vídeo e as principais métricas dos três vídeos com melhor classificação pelo número total de views no 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 solicitados. Consultas grandes levam mais tempo e podem causar tempo limite.