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

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

    O número de vezes que os usuários clicaram no seu anúncio

    microsoft_ads:clicks
  • Valor gasto

    O valor total gasto nas suas campanhas

    microsoft_ads:spend
  • Conversões

    O número de conversões atribuídas aos seus anúncios

    microsoft_ads:conversions
  • Todas as conversões

    Total de conversões incluindo conversões entre dispositivos e navegadores

    microsoft_ads:all_conversions
  • CPA de todas as conversões

    O custo médio por conversão considerando todas as conversões

    microsoft_ads:all_conversions_cpa
  • Taxa 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_rate
  • Receita de todas as conversões

    A receita total de todas as conversões incluindo conversões entre dispositivos

    microsoft_ads:all_conversions_revenue
  • ROAS 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_roas
  • Valor da conversão

    O valor total de todas as conversões

    microsoft_ads:conversion_value
  • Receita

    A receita total gerada a partir das conversões

    microsoft_ads:revenue
  • CTR (Taxa de cliques)

    A porcentagem de impressões que resultaram em cliques

    microsoft_ads:ctr
  • CPC médio

    O custo médio por clique

    microsoft_ads:average_cpc
  • CPM médio

    O custo médio por mil impressões

    microsoft_ads:average_cpm
  • Taxa de conversão

    A porcentagem de cliques que resultaram em conversões

    microsoft_ads:conversion_rate
  • Custo por conversão

    O custo médio de cada conversão

    microsoft_ads:cost_per_conversion
  • ROAS (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_score
  • Taxa 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_share
  • Taxa 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_rate
  • Taxa 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_day
  • Gasto ao longo do tempo

    O valor total gasto nas suas campanhas ao longo do tempo

    microsoft_ads:spend_by_day
  • Conversões ao longo do tempo

    O número de conversões ao longo do tempo

    microsoft_ads:conversions_by_day
  • Cliques e CTR durante o tempo

    O número de cliques e taxa de cliques ao longo do tempo

    microsoft_ads:clicks_ctr_by_day
  • Cliques por dispositivo

    Distribuição de cliques por tipo de dispositivo (Desktop, Mobile, Tablet)

    microsoft_ads:clicks_by_device
  • Impressões por dispositivo

    Distribuição de impressões por tipo de dispositivo

    microsoft_ads:impressions_by_device
  • Gasto por dispositivo

    Distribuição de gasto por tipo de dispositivo

    microsoft_ads:spend_by_device
  • Cliques 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_age
  • Cliques 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_campaigns
  • Grupos de anúncios

    Resumo dos principais dados dos grupos de anúncios, durante o período analisado.

    microsoft_ads:ad_groups
  • Principais palavras-chave

    Palavras-chave com melhor desempenho durante o período analisado.

    microsoft_ads:keywords
  • Anúncios em destaque

    Desempenho dos seus anúncios durante o período analisado.

    microsoft_ads:ads
  • Desempenho geográfico

    Resumo dos principais dados por localização geográfica.

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