Metrics
Métricas do Microsoft Ads pela API
Seu cliente conecta a conta do Microsoft Ads e seu produto consulta 36 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": "microsoft_ads:impressions",
"component": "number_v1",
"metrics": [
"impressions"
]
}
]
}Mais exemplos de chamadas no Microsoft 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
Impressões e cliques ao longo do tempo
O número de impressões e cliques que seus anúncios receberam 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": "microsoft_ads:impressions_clicks_by_day",
"component": "chart_v1",
"metrics": [
"impressions",
"clicks"
],
"dimensions": [
"day"
]
}
]
}Tabela
Campanhas em destaque
Campanhas que tiveram maior impacto no seu público durante o período analisado.
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": "microsoft_ads:featured_campaigns",
"component": "datatable_v1",
"metrics": [
"impressions",
"clicks",
"ctr",
"spend",
"conversions",
"conversion_rate",
"average_cpc"
],
"dimensions": [
"campaign"
]
}
]
}Número
Cliques
O número de vezes que os usuários clicaram no seu anúncio
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": "microsoft_ads:clicks",
"component": "number_v1",
"metrics": [
"clicks"
]
}
]
}Números
21 métricas
Impressões
O número de vezes que seu anúncio foi exibido para os usuários
microsoft_ads:impressionsCliques
O número de vezes que os usuários clicaram no seu anúncio
microsoft_ads:clicksValor gasto
O valor total gasto nas suas campanhas
microsoft_ads:spendConversões
O número de conversões atribuídas aos seus anúncios
microsoft_ads:conversionsTodas as conversões
Total de conversões incluindo conversões entre dispositivos e navegadores
microsoft_ads:all_conversionsCPA de todas as conversões
O custo médio por conversão considerando todas as conversões
microsoft_ads:all_conversions_cpaTaxa de todas as conversões
A taxa de conversão considerando todas as conversões, calculada como todas as conversões divididas pelos cliques
microsoft_ads:all_conversions_rateReceita de todas as conversões
A receita total de todas as conversões incluindo conversões entre dispositivos
microsoft_ads:all_conversions_revenueROAS de todas as conversões
Retorno sobre o gasto com anúncios considerando todas as conversões, calculado como receita de todas as conversões dividida pelo gasto
microsoft_ads:all_conversions_roasValor da conversão
O valor total de todas as conversões
microsoft_ads:conversion_valueReceita
A receita total gerada a partir das conversões
microsoft_ads:revenueCTR (Taxa de cliques)
A porcentagem de impressões que resultaram em cliques
microsoft_ads:ctrCPC médio
O custo médio por clique
microsoft_ads:average_cpcCPM médio
O custo médio por mil impressões
microsoft_ads:average_cpmTaxa de conversão
A porcentagem de cliques que resultaram em conversões
microsoft_ads:conversion_rateCusto por conversão
O custo médio de cada conversão
microsoft_ads:cost_per_conversionROAS (Retorno sobre gasto com anúncios)
O retorno sobre o gasto com anúncios calculado como receita dividida pelo gasto
microsoft_ads:roasÍndice de qualidade
Uma medida da qualidade e relevância dos seus anúncios, palavras-chave e páginas de destino
microsoft_ads:quality_scoreTaxa de impressões
A porcentagem estimada de impressões do total de impressões disponíveis no mercado que você estava segmentando
microsoft_ads:impression_shareTaxa de impressões superiores
A porcentagem de vezes que seu anúncio foi exibido nas posições superiores acima dos resultados orgânicos
microsoft_ads:top_impression_rateTaxa de impressões superiores absolutas
A porcentagem de vezes que seu anúncio esteve na primeira posição de todos os resultados
microsoft_ads:absolute_top_impression_rate
Gráficos
9 métricas
Impressões e cliques ao longo do tempo
O número de impressões e cliques que seus anúncios receberam ao longo do tempo
microsoft_ads:impressions_clicks_by_dayGasto ao longo do tempo
O valor total gasto nas suas campanhas ao longo do tempo
microsoft_ads:spend_by_dayConversões ao longo do tempo
O número de conversões ao longo do tempo
microsoft_ads:conversions_by_dayCliques e CTR durante o tempo
O número de cliques e taxa de cliques ao longo do tempo
microsoft_ads:clicks_ctr_by_dayCliques por dispositivo
Distribuição de cliques por tipo de dispositivo (Desktop, Mobile, Tablet)
microsoft_ads:clicks_by_deviceImpressões por dispositivo
Distribuição de impressões por tipo de dispositivo
microsoft_ads:impressions_by_deviceGasto por dispositivo
Distribuição de gasto por tipo de dispositivo
microsoft_ads:spend_by_deviceCliques por idade
Distribuição de cliques por faixa etária. Disponível apenas para campanhas com segmentação de público ou veiculadas na Microsoft Audience Network.
microsoft_ads:clicks_by_ageCliques por gênero
Distribuição de cliques por gênero. Disponível apenas para campanhas com segmentação de público ou veiculadas na Microsoft Audience Network.
microsoft_ads:clicks_by_gender
Tabelas
6 métricas
Campanhas em destaque
Campanhas que tiveram maior impacto no seu público durante o período analisado.
microsoft_ads:featured_campaignsGrupos de anúncios
Resumo dos principais dados dos grupos de anúncios, durante o período analisado.
microsoft_ads:ad_groupsPrincipais palavras-chave
Palavras-chave com melhor desempenho durante o período analisado.
microsoft_ads:keywordsAnúncios em destaque
Desempenho dos seus anúncios durante o período analisado.
microsoft_ads:adsDesempenho geográfico
Resumo dos principais dados por localização geográfica.
microsoft_ads:insights_by_geographicDesempenho por dispositivo
Resumo dos principais dados por tipo de dispositivo.
microsoft_ads:insights_by_device
Veja o Connect aplicado ao seu produto.
Teste por 15 dias sem cartão, ou mostre seu cenário ao nosso time.
