Metrics

Métricas do Spotify Ads pela API

Seu cliente conecta a conta do Spotify Ads e seu produto consulta 50 métricas pelo mesmo endpoint das outras plataformas. Cada métrica tem um identificador (reference_key) que vai na chamada.

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"
      ]
    }
  ]
}
Exemplo: "Cliques" em outubro, comparado a setembro.

Mais exemplos de chamadas no Spotify Ads

O mesmo endpoint para cada tipo de métrica. Os campos metrics e dimensions de cada item vêm do catálogo da plataforma (GET /api/metrics/{integration_slug}).

Gráfico

Alcance e Impressões ao longo do tempo

O número de usuários únicos que receberam seu anúncio e o número de vezes que seu anúncio foi exibido ao longo do tempo.

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"
      ]
    }
  ]
}

Tabela

Anúncios em Destaque

Seus anúncios no período de tempo 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

Reproduções do anúncio até 100%

O número de anúncios exibidos que foram tocados até o 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

  • Cliques

    O número de impressões em que seu anúncio foi clicado

    spotify_ads:clicks
  • Reproduções do anúncio até 100%

    O número de anúncios exibidos que foram tocados até o final

    spotify_ads:completes
  • Taxa de finalização

    A porcentagem de anúncios tocados até o final

    spotify_ads:completion_rate
  • Taxa de Cliques

    A porcentagem de anúncios que foram clicados

    spotify_ads:ctr
  • CPM

    O Custo Médio por Mil Impressões (CPM) é o valor médio pago pelo anunciante a cada 1.000 impressões do anúncio, independentemente de todas serem ou não ouvidas.

    spotify_ads:e_cpm
  • CPCL

    O Custo Médio por Mil Audições Completas (ACPL) é o valor médio pago a cada 1.000 audições completas do seu anúncio. Essa métrica se aplica exclusivamente a campanhas ativas de áudio configuradas com o modelo ACPL.

    spotify_ads:e_cpcl
  • Anúncio Reproduzido Até 25%

    O número de usuários que ouviram ou visualizaram 25% do tempo total do anúncio

    spotify_ads:first_quartiles
  • Frequência de Exibição de Anúncios

    O número médio de vezes que cada pessoa ouviu ou visualizou seu anúncio

    spotify_ads:frequency
  • Impressões

    O número de vezes que um anúncio foi exibido

    spotify_ads:impressions
  • Anúncio Reproduzido Até 50%

    O número de usuários para os quais o anúncio foi tocado até o meio de seu tempo total

    spotify_ads:midpoints
  • Impressões Fora do Spotify

    O número de anúncios exibidos fora do Spotify

    spotify_ads:off_spotify_impressions
  • Audições Pagas

    O número de audições em uma campanha CPCL onde o usuário NÃO pulou o anúncio

    spotify_ads:paid_listens
  • Frequência de Audições Pagas

    A frequência média de audições em uma campanha CPCL

    spotify_ads:paid_listens_frequency
  • Alcance das Audições Pagas

    Número total de usuários únicos que ouviram um anúncio pago na íntegra dentro de uma campanha CPCL.

    spotify_ads:paid_listens_reach
  • Alcance dos Anúncios Exibidos

    O número de usuários únicos que receberam seu anúncio

    spotify_ads:reach
  • Valor investido

    O valor total gasto nesta campanha

    spotify_ads:spend
  • Inícios

    O número de vezes que um usuário começa a ouvir/visualizar seu anúncio

    spotify_ads:starts
  • Puladas

    O número de vezes que um usuário pula um anúncio

    spotify_ads:skips
  • Reproduções do anúncio até 75%

    O número de usuários que ouviram ou visualizaram 75% do tempo total do anúncio

    spotify_ads:third_quartiles
  • Desmutados

    O número de vezes que um usuário desmuta um anúncio

    spotify_ads:unmutes
  • Expansões de Vídeo

    O número de vezes que alguém tocou no seu anúncio para expandi-lo

    spotify_ads:video_expands
  • Taxa de Expansão de Vídeo

    O número de expansões de vídeo dividido pelo número de impressões

    spotify_ads:video_expand_rate
  • Visualizações dos Vídeos

    O número de vezes que seu vídeo foi reproduzido por pelo menos 3 segundos

    spotify_ads:video_views
  • Média de Streams por Ouvinte

    O número médio de vezes que cada ouvinte transmitiu seu conteúdo após ver ou ouvir seu anúncio.

    spotify_ads:streams_per_user
  • Média de Streams por Novo Ouvinte

    O número médio de vezes que cada novo ouvinte transmitiu seu conteúdo após ver ou ouvir seu anúncio.

    spotify_ads:streams_per_new_listener
  • Taxa de Intenção

    A porcentagem de ouvintes que tomaram ações demonstrando intenção de transmitir seu conteúdo novamente no futuro. As ações incluem salvar seu conteúdo (tocando no ícone + ou “salvar”) ou adicioná-lo a uma playlist.

    spotify_ads:intent_rate
  • Taxa de Conversão de Ouvintes

    A porcentagem de ouvintes que transmitiram seu conteúdo após ver ou ouvir seu anúncio.

    spotify_ads:conversion_rate
  • Ouvintes

    O número de usuários únicos do Spotify que transmitiram pelo menos 30 segundos do conteúdo promovido dentro de 14 dias de ver ou ouvir seu anúncio.

    spotify_ads:listeners
  • Streams de Novos Ouvintes

    O número de streams de novos ouvintes que ouviram ou viram seu anúncio.

    spotify_ads:new_listener_streams
  • Novos Ouvintes

    O número de ouvintes que não haviam transmitido seu conteúdo nos 28 dias antes de ver ou ouvir seu anúncio.

    spotify_ads:new_listeners
  • Taxa de Conversão de Novos Ouvintes

    A porcentagem de novos ouvintes que transmitiram seu conteúdo após ver ou ouvir seu anúncio.

    spotify_ads:new_listener_conversion_rate
  • Streams

    O número de vezes que os ouvintes transmitiram seu conteúdo por pelo menos 30 segundos dentro de 14 dias após ver ou ouvir seus anúncios.

    spotify_ads:streams
  • Impressões Transmitidas

    O número de vezes que um anúncio foi transmitido

    spotify_ads:streamed_impressions
  • Leads

    O número de eventos de lead atribuídos aos seus anúncios em uma janela de 30 dias

    spotify_ads:leads
  • Compras

    O número de eventos de compra atribuídos aos seus anúncios em uma janela de 30 dias

    spotify_ads:purchases
  • Receita Atribuída

    O valor total da receita atribuída a eventos de compra ou lead, com base nas informações recebidas das fontes de dados conectadas ao Spotify

    spotify_ads:revenue
  • ROAS

    O retorno total sobre o investimento em anúncios a partir das compras atribuídas, com base no valor dos eventos de compra ou lead recebidos das fontes de dados conectadas ao Spotify

    spotify_ads:return_on_ad_spend

Gráficos

7 métricas

  • Alcance e Impressões ao longo do tempo

    O número de usuários únicos que receberam seu anúncio e o número de vezes que seu anúncio foi exibido ao longo do tempo.

    spotify_ads:reach_impressions_by_day
  • Cliques e CTR durante o tempo

    O número de vezes que um anúncio foi clicado e a porcentagem de anúncios clicados ao longo do tempo.

    spotify_ads:clicks_ctr_by_day
  • Gasto ao longo do tempo

    O valor total gasto nesta campanha ao longo do tempo.

    spotify_ads:spend_by_day
  • Ouvintes e Novos Ouvintes

    O número de usuários únicos do Spotify que transmitiram pelo menos 30 segundos do conteúdo promovido dentro de 14 dias após ver ou ouvir seu anúncio e o número de ouvintes que não haviam transmitido seu conteúdo nos 28 dias anteriores ao ver ou ouvir seu anúncio no período de tempo especificado.

    spotify_ads:listeners_by_day
  • Cliques por Faixa Etária

    O número de vezes que um anúncio foi clicado por faixa etária

    spotify_ads:clicks_by_age
  • Cliques por Gênero

    O número de vezes que um anúncio foi clicado por gênero

    spotify_ads:clicks_by_gender
  • Alcance por Plataforma

    O número de usuários únicos que receberam seu anúncio por plataforma

    spotify_ads:reach_by_platform

Tabelas

6 métricas

  • Anúncios em Destaque

    Seus anúncios no período de tempo especificado.

    spotify_ads:ads
  • Campanhas em destaque

    Campanhas que tiveram o maior impacto em sua audiência, no período analisado.

    spotify_ads:featured_campaigns
  • Conjunto de anúncios em destaque

    Resumo dos principais dados dos conjuntos de anúncios do período analisado.

    spotify_ads:ad_sets
  • Gêneros Musicais em Destaque

    Resumo dos dados principais para gêneros

    spotify_ads:insights_by_genre
  • Paises em Destaque

    Resumo dos dados principais para países

    spotify_ads:insights_by_country
  • Posicionamentos em Destaque

    Resumo dos dados principais para posicionamentos

    spotify_ads:insights_by_placement

Veja o Connect aplicado ao seu produto.

Teste por 15 dias sem cartão, ou mostre seu cenário ao nosso time.