Analyze Youtube Affiliate Performance (Alpha)

Puedes recuperar 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 y productos individuales.

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 cumplir con 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.

Cómo consultar el extremo alfa

Ten en cuenta que, como está en versión alfa pública, el extremo es diferente. Para recuperar datos de rendimiento de afiliados de YouTube, debes enviar la solicitud POST al extremo v1alpha. 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 interacció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 MCQL SELECT 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.

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. 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 MCQL al accounts.reports.search método:

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 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.

Cómo ver los productos etiquetados con más interacción

Para comprender qué productos etiquetados tienen la mayor cantidad de interacció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.

Cómo 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 instrucción 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.

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 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.