Metrics
Métricas de Microsoft Ads con la API
Tu cliente conecta su cuenta de Microsoft Ads y tu producto consulta 36 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": "microsoft_ads:impressions",
"component": "number_v1",
"metrics": [
"impressions"
]
}
]
}Más ejemplos de llamadas a Microsoft 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
Impresiones y clics a lo largo del tiempo
El número de impresiones y clics que sus anuncios recibieron 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": "microsoft_ads:impressions_clicks_by_day",
"component": "chart_v1",
"metrics": [
"impressions",
"clicks"
],
"dimensions": [
"day"
]
}
]
}Tabla
Campañas destacadas
Campañas que tuvieron mayor impacto en su público durante el período analizado.
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
Clics
El número de veces que los usuarios hicieron clic en su anuncio
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
Impresiones
El número de veces que su anuncio fue mostrado a los usuarios
microsoft_ads:impressionsClics
El número de veces que los usuarios hicieron clic en su anuncio
microsoft_ads:clicksValor gastado
El valor total gastado en sus campañas
microsoft_ads:spendConversiones
El número de conversiones atribuidas a sus anuncios
microsoft_ads:conversionsTodas las conversiones
Total de conversiones incluyendo conversiones entre dispositivos y navegadores
microsoft_ads:all_conversionsCPA de todas las conversiones
El costo promedio por conversión considerando todas las conversiones
microsoft_ads:all_conversions_cpaTasa de todas las conversiones
La tasa de conversión considerando todas las conversiones, calculada como todas las conversiones divididas por los clics
microsoft_ads:all_conversions_rateIngresos de todas las conversiones
Los ingresos totales de todas las conversiones incluyendo conversiones entre dispositivos
microsoft_ads:all_conversions_revenueROAS de todas las conversiones
Retorno sobre el gasto en anuncios considerando todas las conversiones, calculado como ingresos de todas las conversiones dividido por el gasto
microsoft_ads:all_conversions_roasValor de la conversión
El valor total de todas las conversiones
microsoft_ads:conversion_valueIngresos
Los ingresos totales generados a partir de las conversiones
microsoft_ads:revenueCTR (Tasa de clics)
El porcentaje de impresiones que resultaron en clics
microsoft_ads:ctrCPC promedio
El costo promedio por clic
microsoft_ads:average_cpcCPM medio
El costo promedio por mil impresiones
microsoft_ads:average_cpmTasa de conversión
El porcentaje de clics que resultaron en conversiones
microsoft_ads:conversion_rateCosto por conversión
El costo promedio de cada conversión
microsoft_ads:cost_per_conversionROAS (Retorno sobre gasto en anuncios)
El retorno sobre el gasto en anuncios calculado como ingresos dividido por el gasto
microsoft_ads:roasÍndice de calidad
Una medida de la calidad y relevancia de sus anuncios, palabras clave y páginas de destino
microsoft_ads:quality_scoreTasa de impresiones
El porcentaje estimado de impresiones del total de impresiones disponibles en el mercado que usted estaba segmentando
microsoft_ads:impression_shareTasa de impresiones superiores
El porcentaje de veces que su anuncio fue mostrado en las posiciones superiores sobre los resultados orgánicos
microsoft_ads:top_impression_rateTasa de impresiones superiores absolutas
El porcentaje de veces que su anuncio estuvo en la primera posición de todos los resultados
microsoft_ads:absolute_top_impression_rate
Gráficos
9 métricas
Impresiones y clics a lo largo del tiempo
El número de impresiones y clics que sus anuncios recibieron a lo largo del tiempo
microsoft_ads:impressions_clicks_by_dayGasto a lo largo del tiempo
El valor total gastado en sus campañas a lo largo del tiempo
microsoft_ads:spend_by_dayConversiones a lo largo del tiempo
El número de conversiones a lo largo del tiempo
microsoft_ads:conversions_by_dayClics y CTR a lo largo del tiempo
El número de clics y tasa de clics a lo largo del tiempo
microsoft_ads:clicks_ctr_by_dayClics por dispositivo
Distribución de clics por tipo de dispositivo (Escritorio, Móvil, Tableta)
microsoft_ads:clicks_by_deviceImpresiones por dispositivo
Distribución de impresiones por tipo de dispositivo
microsoft_ads:impressions_by_deviceGasto por dispositivo
Distribución de gasto por tipo de dispositivo
microsoft_ads:spend_by_deviceClics por edad
Distribución de clics por grupo de edad. Disponible solo para campañas con segmentación de público o emitidas en la Microsoft Audience Network.
microsoft_ads:clicks_by_ageClics por género
Distribución de clics por género. Disponible solo para campañas con segmentación de público o publicadas en la Microsoft Audience Network.
microsoft_ads:clicks_by_gender
Tablas
6 métricas
Campañas destacadas
Campañas que tuvieron mayor impacto en su público durante el período analizado.
microsoft_ads:featured_campaignsGrupos de anuncios
Resumen de datos clave para grupos de anuncios durante el período analizado.
microsoft_ads:ad_groupsPrincipales palabras clave
Palabras clave con mejor rendimiento durante el período analizado.
microsoft_ads:keywordsAnuncios destacados
Rendimiento de sus anuncios durante el período analizado.
microsoft_ads:adsRendimiento geográfico
Resumen de los principales datos por ubicación geográfica.
microsoft_ads:insights_by_geographicRendimiento por dispositivo
Resumen de los principales datos por tipo de dispositivo.
microsoft_ads:insights_by_device
Mira Connect aplicado a tu producto.
Pruébalo durante 15 días sin tarjeta, o cuéntale tu caso a nuestro equipo.
