Metrics
Métricas do Google Ads pela API
Seu cliente conecta a conta do Google Ads e seu produto consulta 94 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": "gads:clicks",
"component": "number_v1",
"metrics": [
"metrics.clicks"
]
}
]
}Mais exemplos de chamadas no Google 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
Cliques por Dispositivo
Esse gráfico mostra o número de cliques nos seus anúncios, agrupados pelo dispositivo que a pessoa estava usando.
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": "gads:clicks_per_device",
"component": "chart_v1",
"metrics": [
"metrics.clicks"
],
"dimensions": [
"device"
]
}
]
}Tabela
Resumo dos Grupos de Anúncio
Todos os seus grupos de anúncio, ordenados pelos cliques
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": "gads:summary_per_adgroups",
"component": "datatable_v1",
"metrics": [
"metrics.clicks",
"metrics.cost_micros",
"metrics.impressions",
"metrics.conversions",
"metrics.absolute_top_impression_percentage",
"metrics.cost_per_conversion"
],
"dimensions": [
"ad_group"
]
}
]
}Número
Número de campanhas
Número de campanhas que tiveram algum investimento.
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": "gads:count_campaigns",
"component": "number_v1",
"metrics": [
"metrics.cost_micros"
],
"dimensions": [
"campaign"
]
}
]
}Números
57 métricas
Cliques
Número de vezes que alguem clicou no link do seu anúncio.
gads:clicksNúmero de campanhas
Número de campanhas que tiveram algum investimento.
gads:count_campaignsNúmero de anúncios
Número de anúncios que tiveram algum investimento.
gads:count_adsTodas as conversões
Todas as conversões engloba os dados da sua coluna "Conversões" e as ações de conversão que você optou por não incluir na coluna "Conversões". Ela também mostra conversões em dispositivos diferentes, visitas à loja, determinadas chamadas telefônicas e muito mais.
gads:all_conversionsValor das conversões
A soma dos valores de conversão das conversões incluídas na coluna 'Conversões'. Essa métrica só é útil se você tiver inserido um valor para suas ações de conversão.
gads:conversions_valueValor de todas as conversões
O valor de todas as conversões engloba os dados da sua coluna "Conversões" e as ações de conversão que você optou por não incluir na coluna "Conversões". Ela também mostra conversões em dispositivos diferentes, visitas à loja, determinadas chamadas telefônicas e muito mais.
gads:all_conversions_valueConversões
Uma ação que é contabilizada quando alguém interage com seu anúncio ou listagem de produto gratuita (por exemplo, clica em um anúncio de texto ou assiste a um anúncio em vídeo) e, em seguida, realiza uma ação que você definiu como valiosa (por exemplo, uma compra on-line ou uma ligação para sua empresa de um smartphone).
gads:conversionsImpressões
Número de vezes que seu anúncio apareceu em uma busca do ou site do Google. Um anúncio pode aparecer várias vezes para o mesmo usuário.
gads:impressionsVisualizações dos Vídeos
Número de vezes que seus vídeos foram visualizados. Uma visualização é contabilizada quando uma pessoa assite 30 segundos do seu vídeo (ou ele inteiro, se for menor) ou interagem com ele. As interações qualificadas variam de acordo com o formato do anúncio e incluem cliques ou toques em CTAs, cartões, banners complementares, miniaturas ou logotipos.
gads:video_viewsCTR (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).
gads:ctrCusto
A quantidade de dinheiro gasta na sua campanha de anúncios no período de tempo especificado.
gads:cost_microsCusto por todas as conversões
Custo por conversão total informa quanto, em média, cada uma das suas conversões custa. É calculado dividindo o custo total pelo número de conversões totais. Todas as conversões consideram dados de todas as ações de conversão, incluindo aquelas que você escolheu não incluir em "Conversões." Também abrange outras origens de conversão especial.
gads:cost_per_all_conversionsCusto por Conversão
Custo total dividido por todas as conversões.
gads:cost_per_conversionCPM médio
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.
gads:average_cpmCPC médio
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.
gads:average_cpcCPV médio
Custo médio por visualização (CPV) é o valor médio que você paga cada vez que alguém o vizualiza sua campanha. O CPV médio é definido pelo custo total de todas as visualizações de anúncios dividido pelo número de visualizações. Uma visualização é contabilizada quando alguém assiste a 30 segundos do seu anúncio em vídeo (ou ao anúncio completo, se ele tiver menos de 30 segundos) ou interage com ele, o que ocorrer primeiro. As interações de vídeo incluem cliques em call-to-action overlays (CTAs), cartões e banners complementares.
gads:average_cpvTaxa de conversão
A taxa de conversão mostra a frequência média com que uma interação com o anúncio resulta em uma conversão. Ela equivale ao número indicado em "Conversões" dividido pelo número de interações com seu anúncio. As interações com anúncios incluem cliques em anúncios de texto e visualizações de anúncios em vídeo. Essa métrica inclui apenas interações que podem gerar conversões.
gads:conversions_from_interactions_rateROAS
O Retorno do Investimento em Publicidade (ROAS) é o lucro obtido com seus anúncios com relação aos investimentos em publicidade. Ele é calculado dividindo o valor das conversões pelo custo.
gads:roasValor de todas as conversões por custo
O valor de todas as conversões por custo avalia o retorno do investimento de todas as conversões. Ele é o valor de todas as conversões dividido pelo custo de todas as interações com anúncios, como cliques em anúncios de texto ou visualizações de anúncios em vídeo. Essa métrica não inclui interações que não levam a conversões, como aquelas que acontecem quando você não usa o acompanhamento de conversões.
gads:all_conversions_value_per_costValor das conversões por custo
O valor de conversão por custo avalia seu retorno do investimento. Ela reflete o valor da conversão dividido pelo custo de todas as interações de anúncios. O custo nessa métrica não inclui interações que não podem levar a conversões, como aquelas que acontecem quando você não usa o acompanhamento de conversões.
gads:conversions_value_per_costLigações telefônicas
Número de vezes que as pessoas clicaram em um número de telefone exibido em um anúncio para dispositivos móveis ou discaram o número de encaminhamento de chamadas do Google exibido em um anúncio em qualquer dispositivo.
gads:phone_callsTaxa de visualização dos vídeos
A métrica "Taxa de visualização" mostra a porcentagem de pessoas que assistiram ao seus vídeos depois de ver o vídeo ou a miniatura pela primeira vez. Ela equivale ao número de visualizações do seu anúncio dividido pelo número de impressões, incluindo impressões da miniatura de anúncios video discovery.
gads:video_view_rateConversões dos vídeos
Número de vezes que os espectadores realizaram a ação desejada após assistir ao anúncio em vídeo durante o período analisado.
gads:video_conversionsTaxa de conversão dos vídeos
A taxa de conversão mostra a frequência média com que uma interação com o anúncio resulta em uma conversão. Ela equivale ao número indicado em "Conversões" dividido pelo número de interações com seu anúncio. As interações com anúncios incluem cliques em anúncios de texto e visualizações de anúncios em vídeo. Essa métrica inclui apenas interações que podem gerar conversões.
gads:video_conversions_rateCTR dos vídeos
A taxa de cliques (CTR) avalia a frequência com que as pessoas clicam no seu anúncio depois de visualizá-lo. Isso pode ajudar você a entender a eficácia do anúncio. Para calcular a CTR, é necessário dividir o número de cliques que seu anúncio recebe pelo número de vezes que ele é exibido.
gads:video_ctrImpressões dos vídeos
Número de vezes que o anúncio em vídeo foi exibido para os espectadores na plataforma do YouTube durante o período analisado. Isso significa que cada vez que um espectador vê o anúncio, é contabilizada uma impressão, independentemente de ele ter assistido ao vídeo inteiro ou apenas uma parte dele.
gads:video_impressionsCliques dos vídeos
Número de vezes que o espectador clicou no anúncio em vídeo durante sua exibição no período analisado.
gads:video_clicksTaxa de Interação
A "taxa de interação" é o número de interações dividido pelo total de impressões. Ele mede a frequência com que as pessoas interagem com seu anúncio depois de serem expostas a dele. Isso ajuda a avaliar a eficácia do anúncio.
gads:interaction_rateInterações
Uma interação é a principal ação associada a um formato de anúncio. Pode incluir cliques em anúncios de texto e do Shopping, visualizações em anúncios em vídeo e muito mais.
gads:interactions% de impressões (parte superior)
A taxa de impressões na parte superior da pesquisa é a porcentagem de impressões exibidas em qualquer lugar acima dos resultados da pesquisa orgânica.
gads:top_impression_percentageEngajamentos
Um engajamento ocorre quando um consumidor interage com um anúncio, por exemplo, ao visualizar pelo menos 10 segundos ou clicar em um anúncio em vídeo. Assim, ele ajuda a medir a performance do anúncio. Anúncios relevantes altamente segmentados com conteúdo atraente incentivam os usuários a interagir mais ativamente com sua marca.
gads:engagementsTaxa de engajamento
A taxa de engajamento é usada para medir a frequência com que as pessoas interagem com seu anúncio depois que ele é exibido para elas. Use-a para avaliar a eficácia do seu anúncio. A taxa de engajamento é o número de engajamentos dividido pelo total de impressões.
gads:engagement_rateCPE Médio
O custo por engajamento (CPE) médio é o valor médio cobrado por um engajamento de anúncio. Esse valor representa o custo total dos engajamentos de anúncios dividido pelo número total de engajamentos de anúncios.
gads:cpe% de impressões (1ª posição)
A taxa de impressões na primeira posição da rede de pesquisa é a porcentagem de impressões exibidas como o primeiro anúncio acima dos resultados da pesquisa orgânica.
gads:absolute_top_impression_percentageParcela de impressões da Rede de Pesquisa
A parcela de impressões (IS) é a porcentagem de impressões que seus anúncios recebem em comparação com o número total de impressões que eles poderiam receber. Valores abaixo de 10% aparecem como 9,99%, porque o Google não informa o número exato nessa faixa.
gads:search_impression_shareVisualizações da Página
O número de vezes que uma página foi visualizada após uma interação com o anúncio.
gads:conversions_page_viewsAdições ao carrinho
Número de vezes que os produtos foram adicionados ao carrinho de compras por usuários após interagirem com anúncios.
gads:conversion_add_to_cartIniciar Checkout
O número de vezes que uma pessoa iniciou o processo de checkout após uma interação com o anúncio.
gads:conversion_begin_checkoutCompras
Número de transações concluídas através de anúncios, indicando quantas Compras/vendas foram geradas diretamente pelas campanhas do Google Ads.
gads:conversion_purchaseSolicitações de agendamento
O número de vezes que um compromisso foi agendado após uma interação com o anúncio.
gads:conversion_book_appointmentContatos
Essa métrica conta o número de contatos feitos através de formulários, chats ou outras formas de comunicação oferecidas no site, após interagir com os anúncios.
gads:conversion_contactDownload
Número de downloads de arquivos ou aplicativos que foram feitos após os usuários clicarem nos anúncios durante o período analisado.
gads:conversion_downloadLead Convertido
Número de leads convertidos no período analisado. Um lead convertido ou "fechado" ajuda a rastrear leads gerados pelo Google que completaram uma etapa escolhida no processo de conversão de leads, tipicamente offline (fora do Google Ads). Esta etapa pode ser definida como completar uma venda, uma transação fechada offline ou online, ou qualquer etapa que você determine como "conversão".
gads:conversion_converted_leadConversões (Engajamento)
O número de vezes que uma pessoa se engajou com seu anúncio após uma interação com o anúncio.
gads:conversion_engagementSolicitações de rotas
O número de vezes que uma pessoa solicitou direções para o seu negócio após uma interação com o anúncio.
gads:conversion_get_directionsClique de Saída
O número de vezes que uma pessoa clicou em um link para outro site após uma interação com o anúncio.
gads:conversion_outbound_clickLead de Chamada Telefônica
"Phone Call Lead" mostra quantas vezes seu anúncio foi exibido com um número de redirecionamento de chamadas do Google, ou quantas vezes um número de redirecionamento de chamadas do Google poderia ter sido exibido para alguém no seu site.
gads:conversion_phone_call_leadLead Qualificado
Número de leads qualificados no período analisado. Um lead qualificado ou "interessado" ajuda a rastrear leads gerados pelo Google que também foram qualificados offline (fora do Google Ads) no seu sistema de gerenciamento de relacionamento com o cliente (CRM) ou sistema interno de geração de leads.
gads:conversion_qualified_leadPedidos de cotação
O número de vezes que uma pessoa solicitou uma cotação após uma interação com o anúncio.
gads:conversion_request_quoteInscrições
Número de vezes que alguém se inscreveu em um boletim informativo ou teste gratuito, criou uma conta ou fez uma pré-inscrição.
gads:conversion_sign_upVisitas à Loja
Número de clientes que receberam ou clicaram em seus anúncios online e depois visitaram sua loja física.
gads:conversion_store_visitVendas na Loja
Número de compras offline que ocorreram após os clientes interagirem com seus anúncios do Google.
gads:conversion_store_saleEnviar Formulário de Lead
Número de conversões de formulários de lead enviados após interagir com anúncios. Esses formulários geralmente coletam informações de usuários interessados em produtos ou serviços, sendo essenciais para gerar leads qualificados. Este dado só retorna as conversões configuradas em "Incluir em 'Conversões'".
gads:conversion_submit_lead_formEnviar Formulário de Lead (todas as conversões)
Número total de conversões* de formulários de lead enviados após interagir com anúncios. Esses formulários geralmente coletam informações de usuários interessados em produtos ou serviços, sendo essenciais para gerar leads qualificados. *Todas as conversões inclui o que está configurado como "Conversões" e outros dados, como conversões marcadas como ações secundárias.
gads:conversion_submit_lead_form_all_conversionsInscrições pagas
Esta métrica conta o número de inscrições ou registros feitos por usuários após clicarem em um anúncio.
gads:conversion_subscribe_paidPTR (Taxa de Passagem)
O número total de chamadas (ligações telefônicas) recebidas dividido pelo número de vezes que seu número de telefone foi exibido (impressões do número de telefone).
gads:ptrCusto por Ligações Telefônicas
O custo total dos seus anúncios dividido pelo número de chamadas telefônicas recebidas.
gads:cost_per_phone_calls
Gráficos
13 métricas
Cliques por Dispositivo
Esse gráfico mostra o número de cliques nos seus anúncios, agrupados pelo dispositivo que a pessoa estava usando.
gads:clicks_per_deviceCliques e CTR durante o tempo
Esse gráfico mostra o número de cliques e a porcentagem de CTR no período de tempo especificado
gads:clicks_ctr_per_dayConversões por Dispositivo
Esse gráfico mostra o número de conversões geradas por seus anúncios, agrupados pelo dispositivo que a pessoa estava usando.
gads:conversions_by_deviceImpressões por Gênero
Este gráfico mostra o número de impressões que seus anúncios geraram, agrupados por gênenro.
gads:impressions_by_genderImpressões por Idade
Este gráfico mostra o número de impressões que seus anúncios geraram, agrupados pela idade.
gads:impressions_by_ageCusto por Dispositivo
Custo de seus anúncios, agrupados pelo dispositivo que a pessoa estava usando.
gads:cost_per_deviceTodas as conversões e Taxa de Conversão durante o tempo
Esse gráfico mostra o número de todas conversões e a taxa de conversão no período de tempo especificado.
gads:all_conversion_conversion_rate_per_dayConversões e Taxa de Conversão durante o tempo
Esse gráfico mostra o número de conversões e a taxa de conversão no período de tempo especificado.
gads:conversion_conversion_rate_per_dayCusto e CPC Médio durante o tempo
Esse gráfico mostra o custo e o CPC médio no período de tempo especificado.
gads:cost_average_cpc_per_dayImpressões e visualizações dos vídeos
Este gráfico representa o número de vezes que os anúncios em vídeo foram exibidos (impressões) e quantas vezes foram reproduzido (visualizações) durante o período de tempo analisado.
gads:video_impressions_by_timeCliques e CTR dos vídeos
Este gráfico permite verificar o número de cliques que os anúncios em vídeo receberam (Cliques) e a taxa de cliques em relação ao número de vezes que os anúncio foram exibido (CTR - Click-through Rate) durante o período analisado.
gads:video_clicks_ctr_by_timeConversão e taxa de conversão dos vídeos
Este gráfico demonstra o número de ações desejadas (Conversão) que foram realizadas pelo espectador dos anúncios após assisti-los, bem como a taxa de conversão em relação ao número de vezes que os anúncios foram exibidos (Taxa de Conversão) durante o período analisado.
gads:video_conversions_by_timeCusto e CPM médio dos vídeos
Este gráfico mostra o custo total das campanhas de anúncios em vídeo (Custo) e o custo médio para exibir mil impressões (CPM - Cost Per Mille) durante o período analisado.
gads:video_cost_by_time
Tabelas
24 métricas
Resumo dos Grupos de Anúncio
Todos os seus grupos de anúncio, ordenados pelos cliques
gads:summary_per_adgroupsTodas as Campanhas
Todas suas campanhas de anúncio, ordenadas pelos cliques.
gads:top_campaignsDesempenho de Campanhas por ID
Todas as suas campanhas de anúncio com IDs de campanha, ordenadas pelos cliques.
gads:campaign_performance_by_idResumo das Palavras-Chave de Pesquisa
Todas as palavras-chave de pesquisa que você colocou algum dinheiro, ordenadas pelos cliques.
gads:summary_per_keywordsResumo de termos de pesquisa das campanhas inteligentes
Resumo de desempenho de cada um dos termos de pesquisa das campanhas inteligentes do período analisado. Os termos de pesquisa são as palavras ou frases que os usuários digitam na busca do Google, e que acionam a exibição de anúncios.
gads:summary_per_smart_campaign_search_termDesempenho da URL de destino
Resumo de como cada URL de destino performou no período analisado.
gads:destination_url_performanceVídeos em destaque
Esta tabela fornece informações detalhadas sobre cada anúncio em vídeo no YouTube. Ele apresenta dados como número de visualizações, cliques, custo, taxa de visualização e outros indicadores importantes para que você possa avaliar o desempenho individual de cada vídeo.
gads:featured_videosAções de Conversão
Todos os tipos de conversão personalizada que a campanha recebeu depois das interações de anúncio.
gads:custom_conversion_actionsTermos de Pesquisa
Resumo de desempenho de seus termos de pesquisa, durante o período analisado. Os termos de pesquisa são os termos usados por um número significativo de pessoas e que resultaram na exibição do seu anúncio, no momento da pesquisa.
gads:search_termCanais em destaque
Resumo de desempenho dos canais em que seus anúncios apareceram, durante o período de análise. Os canais são locais em que seus anúncios aparecem no YouTube ou na Rede de Display do Google. Um canal pode ser um site ou uma página específica, um app para dispositivos móveis, conteúdo em vídeo ou um bloco de anúncios individual.
gads:detail_group_placementAnúncios em Destaque
Resumo do desempenho de seus anúncios que não são smart, no período analisado.
gads:ads_summary_tablePrincipais Anúncios de Texto
Resumo do desempenho dos seus anúncios, no período analisado.
gads:text_ads_summary_tableDesempenho por cidade
Esta tabela detalha o desempenho dos anúncios segmentados por diferentes cidades. Ela permite avaliar como suas campanhas estão se saindo em cidades específicas, ajudando a identificar quais cidades estão gerando mais cliques e conversões.
gads:performance_by_cityDesempenho por estado
Esta tabela detalha o desempenho dos anúncios segmentados por diferentes estados. Ela permite avaliar como suas campanhas estão se saindo em estados específicos, ajudando a identificar quais estados estão gerando mais cliques e conversões.
gads:performance_by_stateDesempenho por região
Esta tabela detalha o desempenho dos anúncios segmentados por diferentes estados. Ela permite avaliar como suas campanhas estão se saindo em estados específicos, ajudando a identificar quais estados estão gerando mais cliques e conversões.
gads:performance_by_regionDesempenho por aeroporto
Esta tabela detalha o desempenho dos anúncios segmentados por diferentes aeroportos. Ela permite avaliar como suas campanhas estão se saindo em aeroportos específicos, ajudando a identificar quais aeroportos estão gerando mais cliques e conversões.
gads:performance_by_airportDesempenho por condado
Esta tabela detalha o desempenho dos anúncios segmentados por diferentes condados. Ela permite avaliar como suas campanhas estão se saindo em condados específicos, ajudando a identificar quais condados estão gerando mais cliques e conversões.
gads:performance_by_countyDesempenho por distrito
Esta tabela detalha o desempenho dos anúncios segmentados por diferentes distritos. Ela permite avaliar como suas campanhas estão se saindo em distritos específicos, ajudando a identificar quais distritos estão gerando mais cliques e conversões.
gads:performance_by_districtDesempenho por código postal
Esta tabela detalha o desempenho dos anúncios segmentados por diferentes códigos postais. Ela permite avaliar como suas campanhas estão se saindo em códigos postais específicos, ajudando a identificar quais códigos postais estão gerando mais cliques e conversões.
gads:performance_by_postal_codeDesempenho por região metropolitana
Esta tabela detalha o desempenho dos anúncios segmentados por diferentes regiões metropolitanas. Ela permite avaliar como suas campanhas estão se saindo em regiões metropolitanas específicas, ajudando a identificar quais regiões estão gerando mais cliques e conversões.
gads:performance_by_metroDesempenho por país
Esta tabela detalha o desempenho dos anúncios segmentados por diferentes países. Ela permite avaliar como suas campanhas estão se saindo em países específicos, ajudando a identificar quais países estão gerando mais cliques e conversões.
gads:performance_by_countryDesempenho por Grupo de Recursos PMAX
Desempenho detalhado por Grupo de Recursos
gads:pmax_asset_group_performanceDesempenho por Recurso PMAX
Desempenho de cada Recurso criativo
gads:pmax_asset_performanceDesempenho por Localização PMAX
Desempenho por região geográfica
gads:pmax_location_performance
Veja o Connect aplicado ao seu produto.
Teste por 15 dias sem cartão, ou mostre seu cenário ao nosso time.
