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"
]
}
]
}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:impressionsCliques
Número de cliques que seus anúncios receberam durante o período selecionado.
chatgpt_ads:clicksValor investido
Valor total investido pelos seus anúncios durante o período selecionado, na moeda da conta de anúncios.
chatgpt_ads:spendCTR (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:ctrCPC
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:cpcCPM
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:cpmConversõ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:conversionsCusto por conversão
Valor médio investido por conversão durante o período selecionado.
chatgpt_ads:cpaTaxa de conversão
Taxa de conversão pós-clique: conversões divididas pelos cliques durante o período selecionado.
chatgpt_ads:conversion_rateVendas 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_salesROAS
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_dayValor investido por dia
Evolução diária do valor investido pelos seus anúncios durante o período selecionado.
chatgpt_ads:spend_per_dayCTR por dia
Evolução diária da taxa de cliques (CTR) dos seus anúncios durante o período selecionado.
chatgpt_ads:ctr_per_dayCPC 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_dayConversõ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_dayVendas 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_dayImpressõ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_countryValor investido por país
Valor investido pelos seus anúncios dividido pelo país onde foram entregues.
chatgpt_ads:spend_per_countryCliques 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_deviceImpressõ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_platformValor 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_tableMelhores grupos de anúncios
Desempenho dos seus grupos de anúncios durante o período selecionado.
chatgpt_ads:ad_groups_tableMelhores 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.
