Analiza el rendimiento de los afiliados de YouTube (alfa)

Puedes recuperar las métricas clave de rendimiento de tus productos que participan en el Programa de Afiliados de YouTube con la sub-API de informes. En esta guía, se explica cómo consultar datos de afiliados específicos de YouTube, como ventas, comisiones, pedidos, vistas y clics, atribuidos a diferentes creadores, contenido de video, productos individuales, categorías de productos y campañas segmentadas.

El uso que hagas de las APIs del Programa de Afiliados de YouTube y los datos asociados debe cumplir con las políticas para desarrolladores de YouTube Shopping.

Puedes usar el lenguaje de consultas de Merchant Center (MCQL) para seleccionar métricas y dimensiones de las vistas de afiliados de YouTube dedicadas, que funcionan como tablas en tus consultas.

Requisitos previos

Antes de usar esta guía, asegúrate de lo siguiente:

Consulta el extremo alfa

Debido a que esta función está en versión alfa pública, el extremo difiere. Para recuperar los datos de rendimiento de afiliados de YouTube, debes enviar la solicitud POST al extremo v1alpha. Para obtener más información sobre cómo recuperar informes, consulta accounts.reports.search. Aquí encontrarás una solicitud de ejemplo:

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

Consulta el rendimiento por creador

Para comprender qué creadores de YouTube generan la mayor cantidad de participación y ventas, puedes consultar el youtube_creator_performance_view. Esta vista agrega métricas por creadores individuales de YouTube e incluye títulos de creadores y IDs de canales.

A continuación, se muestra un ejemplo de instrucción SELECT de MCQL que puedes usar para obtener los 3 creadores con mejor rendimiento por ventas entre el 1 y el 2 de mayo 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

Esta consulta recupera el título del creador, el ID del canal y las métricas clave de rendimiento de los 3 creadores principales clasificados por la métrica de ventas brutas dentro del período especificado.

Consulta el rendimiento por contenido

Para ver qué videos específicos de YouTube tienen el mejor rendimiento, puedes consultar el youtube_content_performance_view. Esta vista agrega métricas por videos individuales de YouTube e incluye títulos y IDs de videos. Para los mercados, incluye account_id para desglosar el rendimiento por cuentas de subvendedores individuales. Para ver los importes de las comisiones financiadas por subvendedores y la plataforma del mercado, incluye seller_commissions y platform_commissions.

Para recuperar los 3 videos principales por vistas entre el 1 y el 2 de mayo de 2025, pasa la siguiente instrucción MCQL al 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

Esta consulta recupera el título del video, el ID del video, el ID de la cuenta del subvendedor (account_id), las comisiones totales (commissions), las comisiones financiadas por el vendedor (seller_commissions), las comisiones financiadas por la plataforma (platform_commissions) y otras métricas clave de los 3 videos principales clasificados por la cantidad total de views en el período especificado. Nota: No puedes usar account_id en la cláusula WHERE de MCQL para filtrar los resultados.

Consulta los productos etiquetados con más participación

Para comprender qué productos etiquetados tienen la mayor cantidad de participación y ventas, puedes consultar youtube_product_tagged_stats_view. Esta vista agrega métricas por productos etiquetados individuales, incluidos sus títulos y IDs de ofertas.

A continuación, se muestra un ejemplo de instrucción SELECT de MCQL que puedes usar para obtener los 10 productos principales por vistas entre el 20 y el 21 de enero 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

Esta consulta recupera los títulos, el recuento de videos etiquetados y las métricas clave de los 10 productos principales clasificados por la cantidad total de views en el período especificado.

Consulta el rendimiento por categoría de productos etiquetados

Para comprender qué categorías de productos etiquetados generan la mayor cantidad de participación y ventas, consulta youtube_product_category_tagged_stats_view. Esta vista agrega métricas por categoría de productos (product_type) en tu taxonomía de productos, incluida la cantidad de creadores y videos distintos que etiquetaron productos en cada categoría.

Usa la siguiente instrucción SELECT de MCQL para obtener las 10 categorías de productos etiquetados principales clasificadas por ventas brutas el 1 de septiembre 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

Esta consulta recupera la categoría de productos (product_type), el recuento de creadores etiquetados, el recuento de videos etiquetados y las métricas clave de rendimiento de las 10 categorías de productos principales clasificadas por gross_sales en la fecha especificada.

Consulta los productos más vendidos

Para comprender qué productos tienen la mayor cantidad de ventas, puedes consultar el youtube_product_sold_stats_view.

A continuación, se muestra un ejemplo de instrucción SELECT de MCQL que puedes usar para obtener los 10 productos principales clasificados por ventas brutas entre el 20 y el 21 de enero 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

Esta consulta recupera los datos de ventas, las comisiones y las métricas clave de los 10 productos principales ordenados por ventas brutas en el período especificado.

Consulta el rendimiento en todas las campañas

Para comprender el rendimiento general de tus campañas de afiliados, consulta youtube_campaigns_stats_view. Esta vista agrega métricas en todas las campañas, incluidos los nombres de las campañas , las fechas de inicio y finalización, los recuentos de creadores activos y las métricas de ventas y participación.

Usa la siguiente instrucción SELECT de MCQL para obtener las 10 campañas principales por pedidos el 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

Esta consulta recupera el ID de la campaña, el nombre de la campaña, el período, el recuento de creadores activos y las métricas clave de rendimiento de las 10 campañas principales clasificadas por la cantidad total de orders en la fecha especificada.

Consulta el rendimiento de la campaña por creador

Para analizar el rendimiento de los creadores individuales que participan en una campaña específica, consulta el youtube_individual_campaign_stats_view. Esta vista agrega métricas por creador dentro de una campaña, incluidos títulos de los canales, recuentos de videos y títulos de los productos etiquetados.

Usa la siguiente instrucción SELECT de MCQL para obtener los 10 creadores principales por vistas para una campaña específica el 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

Esta consulta recupera el título del canal del creador, el recuento de videos, los títulos de los productos y las métricas clave de rendimiento de los 10 creadores principales clasificados por vistas totales dentro de la campaña y la fecha especificadas.

Consulta el rendimiento de la campaña por video

Para ver el rendimiento de videos específicos de creadores dentro de una campaña, consulta el youtube_campaign_videos_stats_view. Esta vista proporciona métricas de rendimiento a nivel del video para un creador en una campaña, incluidos los títulos de los videos, los formatos de video y los productos etiquetados.

Usa la siguiente instrucción SELECT de MCQL para obtener los 10 videos principales por vistas para un creador y una campaña específicos el 20 de mayo 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

Esta consulta recupera el título del video, el formato del video (content_type), los títulos de los productos etiquetados y las métricas clave de rendimiento de los 10 videos principales clasificados por la cantidad total de views para el canal del creador, la campaña y la fecha especificados.

Consulta el rendimiento de la campaña por producto

Para comprender el rendimiento de los productos individuales dentro de una campaña, consulta youtube_campaign_products_stats_view. Esta vista proporciona métricas de rendimiento a nivel del producto dentro de una campaña, incluidos los títulos de los productos, los detalles de los videos asociados y las métricas de ventas.

Usa la siguiente instrucción SELECT de MCQL para obtener los 10 productos principales por vistas para una campaña específica el 20 de junio 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

Esta consulta recupera el título del canal del creador, el título del producto, el título del video título, la URL del video y las métricas clave de rendimiento de los 10 productos principales clasificados por la cantidad total de views dentro de la campaña y la fecha especificadas.

Consideraciones importantes

  • Fechas: Siempre filtra tus consultas por date con cláusulas WHERE para especificar el período del informe. Las fechas están en formato YYYY-MM-DD.
  • Filtros obligatorios: Algunas vistas de campañas requieren filtros adicionales en la WHERE cláusula:
    • youtube_individual_campaign_stats_view: campaign_id y date.
    • youtube_campaign_videos_stats_view: campaign_id, channel_id y date.
    • youtube_campaign_products_stats_view: campaign_id y date.
  • Latencia: La latencia de las consultas depende del volumen de datos solicitados. Las consultas que abarcan grandes conjuntos de datos tardan más y pueden causar tiempos de espera agotados.
Anterior
Explore your competitive landscape
Siguiente
Analyze UCP agentic performance (Alpha)