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 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 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 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:
- La cuenta que se usa para autenticar las llamadas a la API tiene el rol de Rendimiento y estadísticas, que otorga acceso a las métricas de rendimiento.
- Tu cuenta de Google Merchant Center participa en el Programa de afiliados de YouTube.
Consulta el extremo alfa
Debido a que esta función se encuentra en versión 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
Cómo ver el rendimiento por creador
Para comprender qué creadores de YouTube generan la mayor interacción y ventas, puedes consultar el objeto youtube_creator_performance_view.
En esta vista, se agregan las métricas de los creadores individuales de YouTube y se incluyen los títulos de los creadores y los IDs de los canales.
A continuación, se muestra 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 principales creadores clasificados según la métrica de ventas brutas dentro del período especificado.
Cómo ver el rendimiento por contenido
Para ver qué videos específicos de YouTube tienen el mejor rendimiento, puedes consultar youtube_content_performance_view.
En esta vista, se agregan las métricas por videos individuales de YouTube y se incluyen los títulos y los IDs de los videos.
Para recuperar los 3 videos más populares por vistas entre el 1 y el 2 de mayo de 2025, pasa la siguiente instrucción de MCQL al método accounts.reports.search:
SELECT title, video_id, gross_sales, net_sales, 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, el ID de video y las métricas clave de los 3 videos principales ordenados según la cantidad total de views en el período especificado.
Consulta los productos etiquetados con más interacción
Para comprender qué productos etiquetados tienen la mayor interacción y ventas, puedes consultar youtube_product_tagged_stats_view.
En esta vista, se agregan las métricas por productos individuales etiquetados, incluidos sus títulos y los IDs de oferta.
A continuación, se muestra un ejemplo de una declaración de MCQL SELECT que puedes usar para obtener los 10 productos más populares 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 según la cantidad total de views en el período especificado.
Ver los productos más vendidos
Para comprender qué productos tienen la mayor cantidad de ventas, puedes consultar youtube_product_sold_stats_view.
A continuación, se muestra un ejemplo de una declaración de MCQL SELECT 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.
En esta vista, se agregan las métricas de todas las campañas, incluidos los nombres, 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 búsqueda 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 según 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 youtube_individual_campaign_stats_view.
En esta vista, se agregan las 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 instrucción de MCQL SELECT para obtener los 10 creadores principales por vistas de 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 principales creadores clasificados según las 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 en una campaña, consulta youtube_campaign_videos_stats_view.
En esta vista, se proporcionan 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 de MCQL SELECT para obtener los 10 videos más populares por cantidad de 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 búsqueda 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 ordenados según 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 dentro de una campaña, consulta youtube_campaign_products_stats_view.
En esta vista, se proporcionan métricas de rendimiento a nivel del producto dentro de una campaña, lo que incluye títulos de productos, detalles de videos asociados y métricas de ventas.
Usa la siguiente instrucción de MCQL SELECT para obtener los 10 productos más populares por vistas de 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 según la cantidad total de views dentro de la campaña y la fecha especificadas.
Consideraciones importantes
- Fechas: Siempre filtra tus consultas por
datecon cláusulasWHEREpara especificar el período del informe. Las fechas están en formatoYYYY-MM-DD. - Filtros obligatorios: Algunas vistas de la campaña requieren filtros adicionales en la cláusula
WHERE:youtube_individual_campaign_stats_view:campaign_idydate.youtube_campaign_videos_stats_view:campaign_id,channel_idydate.youtube_campaign_products_stats_view:campaign_idydate.
- 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 agotar el tiempo de espera.