Analiza el rendimiento de los afiliados de YouTube (alfa)

Puedes recuperar las métricas de rendimiento clave de tus productos que participan en el Programa de afiliados de YouTube con la sub-API de Reporting. 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 de segmentación.

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 consulta de Merchant Center (MCQL) para seleccionar métricas y dimensiones de vistas dedicadas de afiliados de YouTube, 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 se encuentra en fase alfa pública, el extremo es diferente. Para recuperar los datos de rendimiento de los 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. A continuación, se muestra 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 participación y ventas, puedes consultar la vista youtube_creator_performance_view. Esta vista agrega métricas por creadores de YouTube individuales y, además, incluye los títulos de los creadores y los IDs de los canales.

Este es un ejemplo de una declaració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 de rendimiento clave de los 3 creadores principales clasificados según la métrica de ventas brutas dentro del período especificado.

Consulta el rendimiento por contenido

Para ver qué videos de YouTube específicos tienen el mejor rendimiento, puedes consultar el recurso youtube_content_performance_view. Esta vista agrega métricas por videos de YouTube individuales y, además, incluye los títulos y los IDs de los videos. En el caso de los mercados, incluye account_id para desglosar el rendimiento por cuentas de vendedores secundarios individuales. Para ver los importes de las comisiones financiadas por los 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 sentencia de MCQL al 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

Esta consulta recupera el título del video, el ID de video, el ID de la cuenta del subrevendedor (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 mayor participación

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

Este es un ejemplo de una sentencia 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 producto etiquetado

Para comprender qué categorías de productos etiquetados generan la mayor cantidad de participación y ventas, consulta la tabla youtube_product_category_tagged_stats_view. Esta vista agrega métricas por categoría de producto (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 sentencia de MCQL SELECT 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 del producto (product_type), el recuento de creadores etiquetados, el recuento de videos etiquetados y las métricas de rendimiento clave para las 10 categorías de productos principales clasificadas por gross_sales en la fecha especificada.

Ver los productos más vendidos

Para comprender qué productos tienen más ventas, puedes consultar la tabla youtube_product_sold_stats_view.

Este es un ejemplo de una declaració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 de todas las campañas

Para comprender el rendimiento general de tus campañas de afiliados, consulta el recurso youtube_campaigns_stats_view. En esta vista, se agregan las métricas de 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 declaració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 de rendimiento clave 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 recurso youtube_individual_campaign_stats_view. Esta vista agrega métricas por creador dentro de una campaña, incluidos los títulos de los canales, los recuentos de videos y los títulos de los productos etiquetados.

Usa la siguiente sentencia 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 de rendimiento clave 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 los videos de creadores específicos en una campaña, consulta el recurso 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 los videos y los productos etiquetados.

Usa la siguiente sentencia SELECT de MCQL para obtener los 10 videos principales por vistas de 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 de rendimiento clave de los 10 videos principales clasificados por la cantidad total de views para el canal, la campaña y la fecha del creador especificados.

Consulta el rendimiento de la campaña por producto

Para comprender el rendimiento de los productos individuales en una campaña, consulta el recurso 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 sentencia 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, la URL del video y las métricas de rendimiento clave 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ña requieren filtros adicionales en la cláusula WHERE:
    • 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.
Anterior
Explore your competitive landscape
Siguiente
Analyze UCP agentic performance (Alpha)