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

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

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:

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 participació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 creadores principales 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 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.

Para recuperar los 3 videos principales 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 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 participación

Para comprender qué productos etiquetados tienen la mayor participació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 el objeto youtube_product_sold_stats_view.

A continuación, se muestra un ejemplo de una declaración SELECT de MCQL que puedes usar para obtener los 10 productos principales ordenados 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 agotar el tiempo de espera.