Metrics

Métricas do ChatGPT Ads pela API

Seu cliente conecta a conta do ChatGPT Ads e seu produto consulta 25 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": "chatgpt_ads:impressions",
      "component": "number_v1",
      "metrics": [
        "impressions"
      ]
    }
  ]
}
Exemplo: "Impressões" em outubro, comparado a setembro.

Mais exemplos de chamadas no ChatGPT 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 por dia

Evolução diária das impressões e cliques dos seus anúncios durante o período selecionado.

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": "chatgpt_ads:impressions_clicks_per_day",
      "component": "chart_v1",
      "metrics": [
        "impressions",
        "clicks"
      ],
      "dimensions": [
        "date"
      ]
    }
  ]
}

Tabela

Melhores campanhas

Desempenho das suas campanhas durante o período selecionado.

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": "chatgpt_ads:campaigns_table",
      "component": "datatable_v1",
      "metrics": [
        "impressions",
        "clicks",
        "spend",
        "ctr",
        "cpc",
        "conversions",
        "cpa"
      ],
      "dimensions": [
        "campaign"
      ]
    }
  ]
}

Número

Cliques

Número de cliques que seus anúncios receberam durante o período selecionado.

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": "chatgpt_ads:clicks",
      "component": "number_v1",
      "metrics": [
        "clicks"
      ]
    }
  ]
}

Números

11 métricas

  • Impressões

    Número de vezes que seus anúncios foram exibidos no ChatGPT durante o período selecionado.

    chatgpt_ads:impressions
  • Cliques

    Número de cliques que seus anúncios receberam durante o período selecionado.

    chatgpt_ads:clicks
  • Valor investido

    Valor total investido pelos seus anúncios durante o período selecionado, na moeda da conta de anúncios.

    chatgpt_ads:spend
  • CTR (Taxa de Cliques)

    O Click Through Rate (CTR) é a taxa de cliques. Ele representa o número total de cliques que seu anúncio recebeu dividido pelo número de vezes que ele foi mostrado (impressões).

    chatgpt_ads:ctr
  • CPC

    O custo por clique (CPC) mostra quanto, em média, cada clique de link custa para você. É calculado dividindo o custo / número de cliques. CPC é uma métrica usada no setor de publicidade online para comparar a eficiência e o desempenho dos anúncios.

    chatgpt_ads:cpc
  • CPM

    Custo Por Mil (CPM) é o preço médio de 1000 impressões. Ele é calculado dividindo o Valor Investido/Número de Impressões x 1000. CPM é uma métrica comum na publicidade online para indicar o custo-beneficio de uma campanha de anúncios. É frequentemente usada para comparar performance entre diferentes campanhas.

    chatgpt_ads:cpm
  • Conversões

    Conversões por clique dos eventos de conversão configurados nas suas campanhas, reportadas na data em que a conversão aconteceu. Exige rastreamento de conversões configurado na conta de anúncios.

    chatgpt_ads:conversions
  • Custo por conversão

    Valor médio investido por conversão durante o período selecionado.

    chatgpt_ads:cpa
  • Taxa de conversão

    Taxa de conversão pós-clique: conversões divididas pelos cliques durante o período selecionado.

    chatgpt_ads:conversion_rate
  • Vendas atribuídas

    Valor dos eventos de compra (pedido criado) atribuídos aos seus anúncios, na moeda da conta de anúncios. Depende do envio de eventos de compra pelo rastreamento de conversões do anunciante.

    chatgpt_ads:attributed_sales
  • ROAS

    Retorno sobre o investimento em anúncios: valor de compras atribuídas dividido pelo valor investido. Um valor 4 significa quatro unidades de vendas atribuídas por unidade investida.

    chatgpt_ads:roas

Gráficos

11 métricas

  • Impressões e cliques por dia

    Evolução diária das impressões e cliques dos seus anúncios durante o período selecionado.

    chatgpt_ads:impressions_clicks_per_day
  • Valor investido por dia

    Evolução diária do valor investido pelos seus anúncios durante o período selecionado.

    chatgpt_ads:spend_per_day
  • CTR por dia

    Evolução diária da taxa de cliques (CTR) dos seus anúncios durante o período selecionado.

    chatgpt_ads:ctr_per_day
  • CPC e CPM por dia

    Evolução diária do custo médio por clique (CPC) e do custo por mil impressões (CPM) durante o período selecionado.

    chatgpt_ads:cpc_cpm_per_day
  • Conversões por dia

    Evolução diária das conversões por clique das suas campanhas, reportadas na data em que a conversão aconteceu.

    chatgpt_ads:conversions_per_day
  • Vendas atribuídas por dia

    Evolução diária do valor de compras atribuídas aos seus anúncios durante o período selecionado.

    chatgpt_ads:attributed_sales_per_day
  • Impressões e cliques por país

    Impressões e cliques dos seus anúncios divididos pelo país onde foram entregues.

    chatgpt_ads:performance_per_country
  • Valor investido por país

    Valor investido pelos seus anúncios dividido pelo país onde foram entregues.

    chatgpt_ads:spend_per_country
  • Cliques por Dispositivo

    Esse gráfico mostra o número de cliques nos seus anúncios, agrupados pelo dispositivo que a pessoa estava usando.

    chatgpt_ads:clicks_per_device
  • Impressões e cliques por plataforma

    Impressões e cliques dos seus anúncios divididos por plataforma do ChatGPT: app iOS, app Android ou navegador web.

    chatgpt_ads:performance_per_platform
  • Valor investido por plataforma

    Valor investido pelos seus anúncios dividido por plataforma do ChatGPT: app iOS, app Android ou navegador web.

    chatgpt_ads:spend_per_platform

Tabelas

3 métricas

  • Melhores campanhas

    Desempenho das suas campanhas durante o período selecionado.

    chatgpt_ads:campaigns_table
  • Melhores grupos de anúncios

    Desempenho dos seus grupos de anúncios durante o período selecionado.

    chatgpt_ads:ad_groups_table
  • Melhores anúncios

    Desempenho dos seus anúncios durante o período selecionado, identificados pelo título do anúncio exibido no ChatGPT.

    chatgpt_ads:ads_table

Veja o Connect aplicado ao seu produto.

Teste por 15 dias sem cartão, ou mostre seu cenário ao nosso time.