Analisar a performance de afiliados do YouTube (Alfa)

É possível acessar 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, 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.

Você pode usar a linguagem de consulta do Merchant Center (MCQL, na sigla em inglês) 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á na versão Alfa pública, o endpoint é diferente. Para acessar os dados de performance de afiliados do YouTube, envie a solicitação POST para o endpoint v1alpha. Para mais informações sobre como acessar 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 a youtube_creator_performance_view. Essa visualização agrega métricas por criador de conteúdo do YouTube e inclui títulos de criadores e IDs de canais.

Confira um exemplo de instrução SELECT da MCQL que pode ser usada para acessar os três principais criadores de conteúdo 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.

Conferir a performance por conteúdo

Para saber quais vídeos específicos do YouTube estão com a 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 marketplaces, inclua account_id para detalhar a performance por contas de subvendedores individuais. Para conferir os valores de comissão financiados por subvendedores e pela plataforma do marketplace, inclua seller_commissions e platform_commissions.

Para acessar os três principais vídeos por visualizações 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,
  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), as comissões totais (commissions), as comissões financiadas pelo vendedor (seller_commissions), as comissões financiadas pela plataforma (platform_commissions) e outras métricas importantes 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.

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 da oferta.

Confira um exemplo de instrução SELECT da MCQL que pode ser usada para acessar 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 o desempenho por categoria dos produtos marcada

Para entender quais categorias dos produtos marcados geram mais engajamento e vendas, consulte a youtube_product_category_tagged_stats_view. Essa visualização agrega métricas por categoria dos produtos (product_type) na sua 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 SELECT da MCQL para acessar 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 dos produtos (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 dos produtos classificadas por gross_sales na data especificada.

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 pode ser usada para acessar 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 classificados 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 a youtube_campaigns_stats_view. Essa visualização agrega métricas em todas as campanhas, incluindo nomes de campanhas , datas de início e término, contagens de criadores de conteúdo ativos e métricas de vendas e engajamento.

Use a seguinte instrução SELECT da MCQL para acessar 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.

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 a 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 acessar 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 pelo número 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 de conteúdo estão se saindo em uma campanha, consulte a 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 de vídeos, formatos de vídeos e produtos marcados.

Use a seguinte instrução SELECT da MCQL para acessar os 10 principais vídeos por visualizações de um criador de conteúdo e 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), títulos dos produtos marcados e as principais métricas de performance dos 10 principais vídeos classificados pelo número total de views para o canal do criador de conteúdo, a campanha e a data especificados.

Conferir a performance da campanha por produto

Para entender a performance de produtos individuais em uma campanha, consulte a 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ídeos associados e métricas de vendas.

Use a seguinte instrução SELECT da MCQL para acessar 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 título, 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 solicitados. 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)