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 sub-API Reporting. 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 a linguagem de consulta do Merchant Center (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

Note que, 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 endpoint v1alpha. 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 da 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,
  gross_sales,
  net_sales,
  commissions,
  orders,
  clicks,
  views
FROM youtube_creator_performance_view
WHERE date >= '2025-05-01' AND date < '2025-05-02'
ORDER BY gross_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 brutas 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 mais assistidos entre 1º e 2 de maio de 2025, transmita a seguinte instrução MCQL para o accounts.reports.search método:

SELECT
  title,
  video_id,
  gross_sales,
  net_sales,
  commissions,
  orders,
  clicks,
  views
FROM youtube_content_performance_view
WHERE date >= '2025-05-01' AND date < '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.

Conferir os produtos marcados com mais engajamento

Para entender quais produtos marcados têm mais engajamento e vendas, consulte a youtube_product_tagged_stats_view. Essa visualização agrega métricas por produtos marcados individuais, incluindo títulos e IDs de ofertas.

Confira um exemplo de instrução SELECT da MCQL que você pode usar para conferir os 10 produtos mais assistidos entre 20 e 21 de janeiro de 2026:

SELECT
  title,
  offer_id,
  tagged_creator_count,
  tagged_video_count,
  gross_sales,
  net_sales,
  commissions,
  views,
  clicks,
  impressions,
  orders,
  conversion_rate
FROM youtube_product_tagged_stats_view
WHERE date >= '2026-01-20' AND date < '2026-01-21'
ORDER BY views DESC LIMIT 10

Essa consulta extrai os títulos, a contagem de vídeos marcados e as principais métricas dos 10 produtos com melhor classificação pelo número total de views no período especificado.

Conferir os produtos mais vendidos

Para entender quais produtos têm mais vendas, consulte a youtube_product_sold_stats_view.

Confira um exemplo de instrução SELECT da MCQL que você pode usar para conferir os 10 produtos com melhor classificação por vendas brutas entre 20 e 21 de janeiro de 2026:

SELECT
  title,
  offer_id,
  gross_sales,
  net_sales,
  commissions,
  orders
FROM youtube_product_sold_stats_view
WHERE date >= '2026-01-20' AND date < '2026-01-21'
ORDER BY gross_sales DESC LIMIT 10

Essa consulta extrai os dados de vendas, as comissões e as principais métricas dos 10 produtos com melhor classificação por vendas brutas 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 que abrangem grandes conjuntos de dados levam mais tempo e podem causar tempos limite.