Analisar a performance de afiliados do YouTube (Alfa)

É possível recuperar as principais métricas de performance dos seus produtos que participam do Programa de Afiliados do YouTube usando a sub-API Reporting. 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, vídeos, produtos, categorias de produtos 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.

Use a Linguagem de consulta do Merchant Center (MCQL) para selecionar métricas e dimensões de visualizações dedicadas do programa 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 Alfa público, o endpoint é diferente. Para recuperar dados de performance do YouTube Afiliados, 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

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

Confira um exemplo de instrução SELECT da MCQL que você pode usar para ver os três criadores de conteúdo com melhor desempenho em 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, o ID do canal e as principais métricas de performance dos três principais criadores classificados pela métrica de vendas brutas no período especificado.

Ver performance por conteúdo

Para saber quais vídeos do YouTube estão com o melhor desempenho, 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 de sub-vendedores individuais. Para conferir os valores de comissão financiados por subvendedores e pela plataforma de marketplace, inclua seller_commissions e platform_commissions.

Para recuperar os três vídeos mais assistidos entre 1º e 2 de maio de 2025, transmita a seguinte instrução MCQL para o 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 do vídeo, o ID do vídeo, o ID da conta do subvendedor (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 importantes para os três vídeos mais bem 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 individualmente, incluindo os títulos e os IDs de oferta.

Confira um exemplo de instrução MCQL SELECT que você pode usar para ver os 10 produtos mais visualizados 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 produtos mais bem classificados pelo número total de views no período especificado.

Ver o desempenho por categoria dos produtos marcados

Para entender quais categorias dos produtos marcados geram mais engajamento e vendas, consulte o youtube_product_category_tagged_stats_view. Essa visualização agrega métricas por categoria dos produtos (product_type) na taxonomia do produto, incluindo o número de criadores de conteúdo e vídeos distintos que marcaram produtos em cada categoria.

Use a seguinte instrução MCQL SELECT para conferir as 10 principais categorias dos produtos marcados classificadas por vendas brutas em 1º de setembro de 2026: 

SELECT
  product_type,
  tagged_creator_count,
  tagged_video_count,
  gross_sales,
  net_sales,
  commissions,
  views,
  clicks,
  impressions,
  orders,
  conversion_rate
FROM youtube_product_category_tagged_stats_view
WHERE date = '2026-09-01'
ORDER BY gross_sales DESC
LIMIT 10

Essa consulta recupera a categoria do produto (product_type), a contagem de criadores de conteúdo marcados, a contagem de vídeos marcados e as principais métricas de performance das 10 principais categorias de produtos classificadas por gross_sales na data especificada.

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 ver os 10 produtos mais vendidos 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 por vendas brutas no período especificado.

Ver 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 ver 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 de conteúdo 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 específicos que participam de uma campanha, 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, contagens de vídeos e títulos de produtos marcados.

Use a seguinte instrução SELECT da MCQL para ver 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 criadores de conteúdo com mais visualizações na campanha e na data especificadas.

Ver a performance da campanha por vídeo

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

Use a seguinte instrução MCQL SELECT para ver os 10 vídeos mais assistidos 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 do vídeo, o formato do vídeo (content_type), os títulos dos produtos marcados e as principais métricas de performance dos 10 vídeos classificados pelo número total de views para o canal do criador de conteúdo, a campanha e a data especificados.

Ver a performance da campanha por produto

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

Use a seguinte instrução MCQL SELECT para ver os 10 produtos mais visualizados 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 produtos mais bem classificados pelo número total de views na campanha e na 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. As consultas que abrangem grandes conjuntos de dados levam mais tempo e podem causar tempos limite.
Anterior
Explore your competitive landscape
Avançar
Analyze UCP agentic performance (Alpha)