Metrics
Métricas de Spotify Ads con la API
Tu cliente conecta su cuenta de Spotify Ads y tu producto consulta 50 métricas por el mismo endpoint que las demás plataformas. Cada métrica tiene un identificador (reference_key) que va en la llamada.
POST /api/metrics/get-data
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
{
"customer_integration": "<connection uuid>",
"start": "2026-10-01",
"end": "2026-10-31",
"comparison_start": "2026-09-01",
"comparison_end": "2026-09-30",
"metrics": [
{
"id": "m1",
"reference_key": "spotify_ads:clicks",
"component": "number_v1",
"metrics": [
"clicks"
],
"dimensions": [
"AD_ACCOUNT"
]
}
]
}Más ejemplos de llamadas a Spotify Ads
El mismo endpoint para cada tipo de métrica. Los campos metrics y dimensions de cada ítem vienen del catálogo de la plataforma (GET /api/metrics/{integration_slug}).
Gráfico
Alcance e Impresiones a lo largo del tiempo
El número de usuarios únicos que recibieron su anuncio y el número de veces que su anuncio fue servido a lo largo del tiempo.
POST /api/metrics/get-data
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
{
"customer_integration": "<connection uuid>",
"start": "2026-10-01",
"end": "2026-10-31",
"metrics": [
{
"id": "m1",
"reference_key": "spotify_ads:reach_impressions_by_day",
"component": "chart_v1",
"metrics": [
"reach",
"impressions"
],
"dimensions": [
"DAY"
]
}
]
}Tabla
Anuncios destacados
Tus anuncios en el periodo especificado.
POST /api/metrics/get-data
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
{
"customer_integration": "<connection uuid>",
"start": "2026-10-01",
"end": "2026-10-31",
"metrics": [
{
"id": "m1",
"reference_key": "spotify_ads:ads",
"component": "datatable_v1",
"metrics": [
"reach",
"impressions",
"clicks",
"completes",
"completion_rate",
"ctr",
"e_cpm",
"e_cpcl",
"frequency",
"spend"
],
"dimensions": [
"AD"
]
}
]
}Número
Anuncio Reproducido Hasta el 100%
El número de anuncios servidos que se reprodujeron hasta el final
POST /api/metrics/get-data
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
{
"customer_integration": "<connection uuid>",
"start": "2026-10-01",
"end": "2026-10-31",
"metrics": [
{
"id": "m1",
"reference_key": "spotify_ads:completes",
"component": "number_v1",
"metrics": [
"completes"
],
"dimensions": [
"AD_ACCOUNT"
]
}
]
}Números
37 métricas
Clics
El número de impresiones en las que se hizo clic en su anuncio
spotify_ads:clicksAnuncio Reproducido Hasta el 100%
El número de anuncios servidos que se reprodujeron hasta el final
spotify_ads:completesTasa de finalización
El porcentaje de anuncios reproducidos hasta el final
spotify_ads:completion_rateTasa de Clics
El porcentaje de anuncios que fueron clickeados
spotify_ads:ctrCPM
El Costo Promedio por Mil Impresiones (CPM) es el monto promedio pagado por el anunciante por cada 1,000 impresiones del anuncio, independientemente de si todas ellas son escuchadas o no.
spotify_ads:e_cpmCPCL
El Costo Promedio por Mil Escuchas Completas (ACPL) es el monto promedio pagado por cada 1,000 escuchas completas de tu anuncio. Esta métrica se aplica exclusivamente a campañas activas de audio configuradas con el modelo ACPL.
spotify_ads:e_cpclAnuncio Reproducido Hasta el 25%
El número de usuarios que escucharon o vieron el 25% de la duración total del anuncio
spotify_ads:first_quartilesFrecuencia de Anuncios Servidos
El número promedio de veces que cada persona escuchó o vio su anuncio
spotify_ads:frequencyImpresiones
El número de veces que un anuncio ha sido servido
spotify_ads:impressionsAnuncio Reproducido Hasta el 50%
El número de usuarios para los que el anuncio se reprodujo hasta la mitad de la duración total del anuncio
spotify_ads:midpointsImpresiones Fuera de Spotify
El número de anuncios servidos fuera de Spotify
spotify_ads:off_spotify_impressionsEscuchas Pagadas
El número de escuchas para una campaña CPCL donde el usuario NO saltó el anuncio
spotify_ads:paid_listensFrecuencia de Escuchas Pagadas
La frecuencia promedio de escuchas en una campaña CPCL
spotify_ads:paid_listens_frequencyAlcance de Escuchas Pagadas
Número total de usuarios únicos que escucharon un anuncio pagado en su totalidad dentro de una campaña CPCL.
spotify_ads:paid_listens_reachAlcance de Anuncios Servidos
El número de usuarios únicos que recibieron su anuncio
spotify_ads:reachValor invertido
El monto total gastado en esta campaña
spotify_ads:spendInicios
El número de veces que un usuario comienza a escuchar/ver su anuncio
spotify_ads:startsSaltos
El número de veces que un usuario salta un anuncio
spotify_ads:skipsAnuncio Reproducido Hasta el 75%
El número de usuarios que escucharon o vieron el 75% de la duración total del anuncio
spotify_ads:third_quartilesDesmutar
El número de veces que un usuario desmuta un anuncio
spotify_ads:unmutesExpansión de Video
El número de veces que alguien tocó su anuncio para expandirlo
spotify_ads:video_expandsTasa de Expansión de Video
El número de expansiones del video dividido por el número de impresiones
spotify_ads:video_expand_rateReproducciones de vídeo
El número de veces que su video se reprodujo durante al menos 3 segundos
spotify_ads:video_viewsPromedio de Streams por Oyente
El número promedio de veces que cada oyente transmitió su contenido después de ver o escuchar su anuncio.
spotify_ads:streams_per_userPromedio de Streams por Nuevo Oyente
El número promedio de veces que cada nuevo oyente transmitió su contenido después de ver o escuchar su anuncio.
spotify_ads:streams_per_new_listenerTasa de Intención
El porcentaje de oyentes que realizaron acciones mostrando la intención de transmitir su contenido nuevamente en el futuro. Las acciones incluyen guardar su contenido (tocando el ícono + o "guardar") o agregarlo a una lista de reproducción.
spotify_ads:intent_rateTasa de Conversión de Oyentes
El porcentaje de oyentes que transmitieron su contenido después de ver o escuchar su anuncio.
spotify_ads:conversion_rateOyentes
El número de usuarios únicos de Spotify que transmitieron al menos 30 segundos del contenido promocionado dentro de los 14 días después de ver o escuchar su anuncio.
spotify_ads:listenersStreams de Nuevos Oyentes
El número de streams de nuevos oyentes que escucharon o vieron su anuncio.
spotify_ads:new_listener_streamsNuevos Oyentes
El número de oyentes que no habían transmitido su contenido en los 28 días anteriores a ver o escuchar su anuncio.
spotify_ads:new_listenersTasa de Conversión de Nuevos Oyentes
El porcentaje de nuevos oyentes que transmitieron su contenido después de ver o escuchar su anuncio.
spotify_ads:new_listener_conversion_rateStreams
El número de veces que los oyentes transmitieron su contenido durante al menos 30 segundos dentro de los 14 días después de ver o escuchar sus anuncios.
spotify_ads:streamsImpresiones Transmitidas
El número de veces que un anuncio ha sido transmitido
spotify_ads:streamed_impressionsRegistros
El número de eventos de registro atribuidos a tus anuncios en una ventana de 30 días
spotify_ads:leadsCompras
El número de eventos de compra atribuidos a tus anuncios en una ventana de 30 días
spotify_ads:purchasesIngresos Atribuidos
El monto total de ingresos atribuidos a eventos de compra o registro, según la información recibida de las fuentes de datos conectadas a Spotify
spotify_ads:revenueROAS
El retorno total de la inversión publicitaria a partir de las compras atribuidas, según el valor de los eventos de compra o registro recibidos de las fuentes de datos conectadas a Spotify
spotify_ads:return_on_ad_spend
Gráficos
7 métricas
Alcance e Impresiones a lo largo del tiempo
El número de usuarios únicos que recibieron su anuncio y el número de veces que su anuncio fue servido a lo largo del tiempo.
spotify_ads:reach_impressions_by_dayClics y CTR a lo largo del tiempo
El número de veces que un anuncio fue clickeado y el porcentaje de anuncios que fueron clickeados a lo largo del tiempo.
spotify_ads:clicks_ctr_by_dayGasto a lo largo del tiempo
El monto total gastado en esta campaña a lo largo del tiempo.
spotify_ads:spend_by_dayOyentes y Nuevos Oyentes
El número de usuarios únicos de Spotify que transmitieron al menos 30 segundos del contenido promocionado dentro de los 14 días posteriores a ver o escuchar su anuncio y el número de oyentes que no habían transmitido su contenido en los 28 días previos a ver o escuchar su anuncio en el período de tiempo especificado.
spotify_ads:listeners_by_dayClics por Edad
El número de veces que un anuncio fue clickeado por grupo etario
spotify_ads:clicks_by_ageClics por Género
El número de veces que un anuncio fue clickeado por género
spotify_ads:clicks_by_genderAlcance por Plataforma
El número de usuarios únicos que recibieron tu anuncio por plataforma
spotify_ads:reach_by_platform
Tablas
6 métricas
Anuncios destacados
Tus anuncios en el periodo especificado.
spotify_ads:adsCampañas destacadas
Campañas que han tenido mayor impacto en tu audiencia, en el periodo analizado.
spotify_ads:featured_campaignsConjunto de anuncios destacados
Resumen de datos clave para conjuntos de anuncios para el período analizado.
spotify_ads:ad_setsGénero Destacado
Resumen de datos clave para géneros
spotify_ads:insights_by_genrePaís Destacado
Resumen de datos clave para países
spotify_ads:insights_by_countryUbicación Destacada
Resumen de datos clave para ubicaciones
spotify_ads:insights_by_placement
Mira Connect aplicado a tu producto.
Pruébalo durante 15 días sin tarjeta, o cuéntale tu caso a nuestro equipo.
