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 "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:

• La cuenta que se usa para autenticar las llamadas a la API tiene el Rendimiento y estadísticas rol que otorga acceso a las métricas de rendimiento.
• Tu cuenta de Google Merchant Center participa en el Programa de Afiliados de YouTube.

Cómo consultar el extremo alfa

Ten en cuenta que, como está en versión alfa pública, el extremo es diferente. Para recuperar los datos de rendimiento de afiliados de YouTube, debes enviar la solicitud POST al v1alpha extremo. Aquí encontrarás un ejemplo de solicitud:

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

  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 cantidad de participación y ventas, puedes consultar 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,
  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 clave de rendimiento de los 3 creadores principales clasificados por 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 youtube_content_performance_view. Esta vista agrega métricas por videos individuales de YouTube e incluye títulos y IDs de videos.

Para recuperar los 3 videos principales por vistas entre el 1 y el 2 de mayo de 2025, pasa la siguiente instrucción del lenguaje de consultas de Merchant Center al método accounts.reports.search:

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 del video, el ID del video y las métricas clave de los 3 videos principales clasificados por la cantidad total de views en el período especificado.

Consideraciones importantes

• Fechas: Siempre filtra tus consultas por date con cláusulas WHERE para especificar el período de informes. Las fechas están en formato YYYY-MM-DD.
• Latencia: La latencia de las consultas dependerá del volumen de datos solicitados. Las consultas grandes tardarán más y pueden causar tiempos de espera agotados.