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"
      ]
    }
  ]
}
Ejemplo: "Clics" en octubre, comparado con septiembre.

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:clicks
  • Anuncio Reproducido Hasta el 100%

    El número de anuncios servidos que se reprodujeron hasta el final

    spotify_ads:completes
  • Tasa de finalización

    El porcentaje de anuncios reproducidos hasta el final

    spotify_ads:completion_rate
  • Tasa de Clics

    El porcentaje de anuncios que fueron clickeados

    spotify_ads:ctr
  • CPM

    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_cpm
  • CPCL

    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_cpcl
  • Anuncio 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_quartiles
  • Frecuencia de Anuncios Servidos

    El número promedio de veces que cada persona escuchó o vio su anuncio

    spotify_ads:frequency
  • Impresiones

    El número de veces que un anuncio ha sido servido

    spotify_ads:impressions
  • Anuncio 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:midpoints
  • Impresiones Fuera de Spotify

    El número de anuncios servidos fuera de Spotify

    spotify_ads:off_spotify_impressions
  • Escuchas Pagadas

    El número de escuchas para una campaña CPCL donde el usuario NO saltó el anuncio

    spotify_ads:paid_listens
  • Frecuencia de Escuchas Pagadas

    La frecuencia promedio de escuchas en una campaña CPCL

    spotify_ads:paid_listens_frequency
  • Alcance 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_reach
  • Alcance de Anuncios Servidos

    El número de usuarios únicos que recibieron su anuncio

    spotify_ads:reach
  • Valor invertido

    El monto total gastado en esta campaña

    spotify_ads:spend
  • Inicios

    El número de veces que un usuario comienza a escuchar/ver su anuncio

    spotify_ads:starts
  • Saltos

    El número de veces que un usuario salta un anuncio

    spotify_ads:skips
  • Anuncio 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_quartiles
  • Desmutar

    El número de veces que un usuario desmuta un anuncio

    spotify_ads:unmutes
  • Expansión de Video

    El número de veces que alguien tocó su anuncio para expandirlo

    spotify_ads:video_expands
  • Tasa de Expansión de Video

    El número de expansiones del video dividido por el número de impresiones

    spotify_ads:video_expand_rate
  • Reproducciones de vídeo

    El número de veces que su video se reprodujo durante al menos 3 segundos

    spotify_ads:video_views
  • Promedio 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_user
  • Promedio 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_listener
  • Tasa 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_rate
  • Tasa de Conversión de Oyentes

    El porcentaje de oyentes que transmitieron su contenido después de ver o escuchar su anuncio.

    spotify_ads:conversion_rate
  • Oyentes

    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:listeners
  • Streams de Nuevos Oyentes

    El número de streams de nuevos oyentes que escucharon o vieron su anuncio.

    spotify_ads:new_listener_streams
  • Nuevos 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_listeners
  • Tasa 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_rate
  • Streams

    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:streams
  • Impresiones Transmitidas

    El número de veces que un anuncio ha sido transmitido

    spotify_ads:streamed_impressions
  • Registros

    El número de eventos de registro atribuidos a tus anuncios en una ventana de 30 días

    spotify_ads:leads
  • Compras

    El número de eventos de compra atribuidos a tus anuncios en una ventana de 30 días

    spotify_ads:purchases
  • Ingresos 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:revenue
  • ROAS

    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_day
  • Clics 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_day
  • Gasto a lo largo del tiempo

    El monto total gastado en esta campaña a lo largo del tiempo.

    spotify_ads:spend_by_day
  • Oyentes 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_day
  • Clics por Edad

    El número de veces que un anuncio fue clickeado por grupo etario

    spotify_ads:clicks_by_age
  • Clics por Género

    El número de veces que un anuncio fue clickeado por género

    spotify_ads:clicks_by_gender
  • Alcance 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:ads
  • Campañas destacadas

    Campañas que han tenido mayor impacto en tu audiencia, en el periodo analizado.

    spotify_ads:featured_campaigns
  • Conjunto de anuncios destacados

    Resumen de datos clave para conjuntos de anuncios para el período analizado.

    spotify_ads:ad_sets
  • Género Destacado

    Resumen de datos clave para géneros

    spotify_ads:insights_by_genre
  • País Destacado

    Resumen de datos clave para países

    spotify_ads:insights_by_country
  • Ubicació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.