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.

Seu 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 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 MCQL SELECT 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 a melhor performance, consulte o 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 marketplaces, inclua account_id para detalhar a performance por contas individuais de subvendedores. Para conferir os valores de comissão financiados por subvendedores e pela plataforma do marketplace, inclua seller_commissions e platform_commissions.

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,
  account_id,
  gross_sales,
  net_sales,
  commissions,
  seller_commissions,
  platform_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 e o ID do vídeo, o ID da conta do subrevendedor (account_id), o total de comissões (commissions), as comissões financiadas pelo vendedor (seller_commissions), as comissões financiadas pela plataforma (platform_commissions) e outras métricas principais dos três principais vídeos classificados pelo número total de views no período especificado. Observação: não é possível usar account_id na cláusula WHERE da MCQL para filtrar resultados.

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.

Ver 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 produtos mais vendidos 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.

Conferir 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.

Conferir 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, além de 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 melhores 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 produtos individuais 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