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"
]
}
]
}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:clicksReproduções do anúncio até 100%
O número de anúncios exibidos que foram tocados até o final
spotify_ads:completesTaxa de finalização
A porcentagem de anúncios tocados até o final
spotify_ads:completion_rateTaxa de Cliques
A porcentagem de anúncios que foram clicados
spotify_ads:ctrCPM
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_cpmCPCL
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_cpclAnúncio Reproduzido Até 25%
O número de usuários que ouviram ou visualizaram 25% do tempo total do anúncio
spotify_ads:first_quartilesFrequê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:frequencyImpressões
O número de vezes que um anúncio foi exibido
spotify_ads:impressionsAnú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:midpointsImpressões Fora do Spotify
O número de anúncios exibidos fora do Spotify
spotify_ads:off_spotify_impressionsAudiçõ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_listensFrequência de Audições Pagas
A frequência média de audições em uma campanha CPCL
spotify_ads:paid_listens_frequencyAlcance 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_reachAlcance dos Anúncios Exibidos
O número de usuários únicos que receberam seu anúncio
spotify_ads:reachValor investido
O valor total gasto nesta campanha
spotify_ads:spendInícios
O número de vezes que um usuário começa a ouvir/visualizar seu anúncio
spotify_ads:startsPuladas
O número de vezes que um usuário pula um anúncio
spotify_ads:skipsReproduçõ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_quartilesDesmutados
O número de vezes que um usuário desmuta um anúncio
spotify_ads:unmutesExpansões de Vídeo
O número de vezes que alguém tocou no seu anúncio para expandi-lo
spotify_ads:video_expandsTaxa 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_rateVisualizações dos Vídeos
O número de vezes que seu vídeo foi reproduzido por pelo menos 3 segundos
spotify_ads:video_viewsMé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_userMé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_listenerTaxa 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_rateTaxa 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_rateOuvintes
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:listenersStreams de Novos Ouvintes
O número de streams de novos ouvintes que ouviram ou viram seu anúncio.
spotify_ads:new_listener_streamsNovos 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_listenersTaxa 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_rateStreams
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:streamsImpressões Transmitidas
O número de vezes que um anúncio foi transmitido
spotify_ads:streamed_impressionsLeads
O número de eventos de lead atribuídos aos seus anúncios em uma janela de 30 dias
spotify_ads:leadsCompras
O número de eventos de compra atribuídos aos seus anúncios em uma janela de 30 dias
spotify_ads:purchasesReceita 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:revenueROAS
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_dayCliques 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_dayGasto ao longo do tempo
O valor total gasto nesta campanha ao longo do tempo.
spotify_ads:spend_by_dayOuvintes 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_dayCliques por Faixa Etária
O número de vezes que um anúncio foi clicado por faixa etária
spotify_ads:clicks_by_ageCliques por Gênero
O número de vezes que um anúncio foi clicado por gênero
spotify_ads:clicks_by_genderAlcance 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:adsCampanhas em destaque
Campanhas que tiveram o maior impacto em sua audiência, no período analisado.
spotify_ads:featured_campaignsConjunto de anúncios em destaque
Resumo dos principais dados dos conjuntos de anúncios do período analisado.
spotify_ads:ad_setsGêneros Musicais em Destaque
Resumo dos dados principais para gêneros
spotify_ads:insights_by_genrePaises em Destaque
Resumo dos dados principais para países
spotify_ads:insights_by_countryPosicionamentos 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.
