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

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:impressions
  • Clics

    El número de veces que los usuarios hicieron clic en su anuncio

    microsoft_ads:clicks
  • Valor gastado

    El valor total gastado en sus campañas

    microsoft_ads:spend
  • Conversiones

    El número de conversiones atribuidas a sus anuncios

    microsoft_ads:conversions
  • Todas las conversiones

    Total de conversiones incluyendo conversiones entre dispositivos y navegadores

    microsoft_ads:all_conversions
  • CPA de todas las conversiones

    El costo promedio por conversión considerando todas las conversiones

    microsoft_ads:all_conversions_cpa
  • Tasa 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_rate
  • Ingresos de todas las conversiones

    Los ingresos totales de todas las conversiones incluyendo conversiones entre dispositivos

    microsoft_ads:all_conversions_revenue
  • ROAS 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_roas
  • Valor de la conversión

    El valor total de todas las conversiones

    microsoft_ads:conversion_value
  • Ingresos

    Los ingresos totales generados a partir de las conversiones

    microsoft_ads:revenue
  • CTR (Tasa de clics)

    El porcentaje de impresiones que resultaron en clics

    microsoft_ads:ctr
  • CPC promedio

    El costo promedio por clic

    microsoft_ads:average_cpc
  • CPM medio

    El costo promedio por mil impresiones

    microsoft_ads:average_cpm
  • Tasa de conversión

    El porcentaje de clics que resultaron en conversiones

    microsoft_ads:conversion_rate
  • Costo por conversión

    El costo promedio de cada conversión

    microsoft_ads:cost_per_conversion
  • ROAS (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_score
  • Tasa de impresiones

    El porcentaje estimado de impresiones del total de impresiones disponibles en el mercado que usted estaba segmentando

    microsoft_ads:impression_share
  • Tasa 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_rate
  • Tasa 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_day
  • Gasto a lo largo del tiempo

    El valor total gastado en sus campañas a lo largo del tiempo

    microsoft_ads:spend_by_day
  • Conversiones a lo largo del tiempo

    El número de conversiones a lo largo del tiempo

    microsoft_ads:conversions_by_day
  • Clics 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_day
  • Clics por dispositivo

    Distribución de clics por tipo de dispositivo (Escritorio, Móvil, Tableta)

    microsoft_ads:clicks_by_device
  • Impresiones por dispositivo

    Distribución de impresiones por tipo de dispositivo

    microsoft_ads:impressions_by_device
  • Gasto por dispositivo

    Distribución de gasto por tipo de dispositivo

    microsoft_ads:spend_by_device
  • Clics 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_age
  • Clics 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_campaigns
  • Grupos de anuncios

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

    microsoft_ads:ad_groups
  • Principales palabras clave

    Palabras clave con mejor rendimiento durante el período analizado.

    microsoft_ads:keywords
  • Anuncios destacados

    Rendimiento de sus anuncios durante el período analizado.

    microsoft_ads:ads
  • Rendimiento geográfico

    Resumen de los principales datos por ubicación geográfica.

    microsoft_ads:insights_by_geographic
  • Rendimiento 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.