Analyze YouTube Affiliate Performance (Alpha)

Puedes recuperar las métricas clave de rendimiento de tus productos que participan en el Programa de afiliados de YouTube con la API de Reports. 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 y productos individuales.

Puedes usar MCQL para seleccionar métricas y dimensiones de las "vistas" específicas de los 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 de la versión alfa

Ten en cuenta que, dado que se trata de una 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. A continuación, se muestra una solicitud de ejemplo:

HTTP

POST https://merchantapi.googleapis.com/reports/v1alpha/accounts/{ACCOUNT_ID}/reports:search

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' \
  --compressed

Cómo ver el rendimiento por creador

Para comprender qué creadores de YouTube generan la mayor participación y ventas, puedes consultar 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 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,
  sales,
  commissions,
  orders,
  clicks,
  views
FROM youtube_creator_performance_view
WHERE date BETWEEN '2025-05-01' AND '2025-05-02'
ORDER BY 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 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 el objeto 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.

A continuación, se muestra un ejemplo de una instrucción SELECT de MCQL que puedes usar para obtener los 3 videos más populares por vistas entre el 1 y el 2 de mayo de 2025.

SELECT
  title,
  video_id,
  views,
  clicks,
  sales
FROM youtube_content_performance_view
WHERE date BETWEEN '2025-05-01' AND '2025-05-02'
ORDER BY views DESC LIMIT 3

Esta consulta recupera el título, el ID y las métricas clave de los 3 videos principales ordenados según la cantidad total de views en el período especificado.

Cómo ver el rendimiento por producto

Para analizar el rendimiento de los productos individuales en el Programa de Afiliados de YouTube, puedes consultar youtube_product_performance_view. En esta vista, se agregan las métricas por producto y se incluyen los títulos de los productos y los IDs de las ofertas.

A continuación, se muestra un ejemplo de una sentencia SELECT de MCQL que puedes usar para encontrar los 3 productos principales por importe de ventas entre el 1 y el 2 de mayo de 2025:

SELECT
  title,
  offer_id,
  sales,
  commissions,
  orders,
  clicks
FROM youtube_product_performance_view
WHERE date BETWEEN '2025-05-01' AND '2025-05-02'
ORDER BY sales DESC LIMIT 3

Esta consulta devuelve el título del producto, el ID de la oferta y las métricas de rendimiento de los 3 productos principales, ordenados según la métrica sales, durante el período especificado.

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.
  • Latencia: La latencia de las búsquedas dependerá del volumen de datos solicitados. Las consultas grandes tardarán más y pueden causar tiempos de espera.