Analisar a performance de afiliados do YouTube (Alfa)

Você pode recuperar 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, conteúdo de vídeo, produtos individuais e campanhas segmentadas.

O uso das APIs do Programa de Afiliados do YouTube e dos dados associados precisa obedecer às políticas para desenvolvedores do YouTube Shopping.

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:

Consultar o endpoint Alfa

Como esse recurso está em versão Alfa pública, o endpoint é diferente. Para recuperar os dados de performance de afiliados do YouTube, envie a solicitação POST para o endpoint v1alpha. Para mais informações sobre como recuperar relatórios, consulte accounts.reports.search. Confira um exemplo de solicitação:

HTTP

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

{
  "query": "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"
}

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' \
  --header 'Content-Type: application/json' \
  --data '{
    "query": "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"
  }' \
  --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 o youtube_creator_performance_view. Essa visualização agrega métricas por criador de conteúdo individual 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 receber os três criadores de conteúdo com melhor desempenho 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 principais criadores de conteúdo classificados pela métrica de vendas brutas 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.

Para extrair os três principais vídeos por visualizações entre 1º e 2 de maio de 2025, transmita a seguinte instrução MCQL ao método accounts.reports.search: 

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 recupera o título, o ID do vídeo e as principais métricas dos três vídeos mais assistidos, classificados pelo número total de views no período especificado.

Ver os produtos marcados com mais engajamento

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

Confira um exemplo de instrução MCQL SELECT que você pode usar para receber os 10 principais produtos por visualizações 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 recupera os títulos, a contagem de vídeos marcados e as principais métricas dos 10 principais produtos classificados pelo número total de views no período especificado.

Conferir os produtos mais vendidos

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

Confira um exemplo de instrução MCQL SELECT que você pode usar para receber os 10 principais produtos classificados 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 recupera os dados de vendas, as comissões e as principais métricas dos 10 principais produtos ordenados por vendas brutas no período especificado.

Conferir a performance em todas as campanhas

Para entender a performance geral das suas campanhas de afiliados, consulte youtube_campaigns_stats_view. Essa visualização agrega métricas de todas as campanhas, incluindo nomes, datas de início e término, contagem de criadores ativos e métricas de vendas e engajamento.

Use a seguinte instrução MCQL SELECT para receber as 10 principais campanhas por pedidos em 23 de abril de 2026: 

SELECT
  campaign_id,
  campaign_name,
  start_date,
  end_date,
  active_creators,
  gross_sales,
  net_sales,
  commissions,
  views,
  clicks,
  impressions,
  orders,
  conversion_rate
FROM youtube_campaigns_stats_view
WHERE date = '2026-04-23'
ORDER BY orders DESC LIMIT 10

Essa consulta recupera o ID da campanha, o nome da campanha, o período, a contagem de criadores ativos e as principais métricas de performance das 10 principais campanhas classificadas pelo número total de orders na data especificada.

Ver a performance da campanha por criador de conteúdo

Para analisar a performance de criadores de conteúdo individuais que participam de uma campanha específica, consulte o youtube_individual_campaign_stats_view. Essa visualização agrega métricas por criador de conteúdo em uma campanha, incluindo títulos de canais, contagem de vídeos e títulos de produtos marcados.

Use a seguinte instrução MCQL SELECT para receber os 10 principais criadores de conteúdo por visualizações de uma campanha específica em 23 de abril de 2026: 

SELECT
  channel_title,
  video_count,
  product_titles,
  gross_sales,
  net_sales,
  commissions,
  views,
  clicks,
  impressions,
  orders,
  conversion_rate
FROM youtube_individual_campaign_stats_view
WHERE date = '2026-04-23'
  AND campaign_id = 'YOUR_CAMPAIGN_ID'
ORDER BY views DESC LIMIT 10

Essa consulta recupera o título do canal do criador de conteúdo, a contagem de vídeos, os títulos dos produtos e as principais métricas de performance dos 10 principais criadores de conteúdo classificados por total de visualizações na campanha e data especificadas.

Ver a performance da campanha por vídeo

Para saber como vídeos específicos de criadores estão performando em uma campanha, consulte o youtube_campaign_videos_stats_view. Essa visualização fornece métricas de performance no nível do vídeo para um criador de conteúdo em uma campanha, incluindo títulos e formatos de vídeo e produtos marcados.

Use a seguinte instrução MCQL SELECT para receber os 10 principais vídeos por visualizações de um criador de conteúdo e uma campanha específicos em 20 de maio de 2026: 

SELECT
  video_title,
  content_type,
  product_titles,
  gross_sales,
  net_sales,
  commissions,
  views,
  clicks,
  impressions,
  orders,
  conversion_rate
FROM youtube_campaign_videos_stats_view
WHERE date = '2026-05-20'
  AND campaign_id = 'YOUR_CAMPAIGN_ID'
  AND channel_id = 'YOUR_CHANNEL_ID'
ORDER BY views DESC LIMIT 10

Essa consulta recupera o título e o formato do vídeo (content_type), os títulos dos produtos marcados e as principais métricas de performance dos 10 principais vídeos classificados pelo número total de views do canal, da campanha e da data especificados do criador de conteúdo.

Ver a performance da campanha por produto

Para entender a performance de cada produto em uma campanha, consulte youtube_campaign_products_stats_view. Essa visualização fornece métricas de performance no nível do produto em uma campanha, incluindo títulos de produtos, detalhes de vídeo associados e métricas de vendas.

Use a seguinte instrução MCQL SELECT para receber os 10 principais produtos por visualizações de uma campanha específica em 20 de junho de 2026: 

SELECT
  channel_title,
  product_title,
  video_title,
  video_url,
  gross_sales,
  net_sales,
  commissions,
  views,
  clicks,
  impressions,
  orders,
  conversion_rate
FROM youtube_campaign_products_stats_view
WHERE date = '2026-06-20'
  AND campaign_id = 'YOUR_CAMPAIGN_ID'
ORDER BY views DESC LIMIT 10

Essa consulta recupera o título do canal do criador de conteúdo, o título do produto, o título do vídeo, o URL do vídeo e as principais métricas de performance dos 10 principais produtos classificados pelo número total de views na campanha e data especificadas.

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.
  • Filtros obrigatórios: algumas visualizações de campanha exigem filtros adicionais na cláusula WHERE:
    • youtube_individual_campaign_stats_view: campaign_id e date.
    • youtube_campaign_videos_stats_view: campaign_id, channel_id e date.
    • youtube_campaign_products_stats_view: campaign_id e date.
  • Latência: a latência das consultas depende do volume de dados solicitado. Consultas que abrangem grandes conjuntos de dados levam mais tempo e podem causar tempos limite.
Anterior
Explore your competitive landscape
Avançar
Use Merchant Center Query Language