Este guia apresenta uma lista dos diferentes tipos de ações de conversão que você pode criar usando a API Google Ads e informações sobre como elas são mapeadas para a interface da Web do Google Ads.
Escolher o tipo certo de ação de conversão
Para selecionar o tipo de ação de conversão e o guia de configuração corretos para sua integração, use o seguinte caminho de decisão:
Onde o evento de conversão ocorre?
- No mundo off-line (por exemplo, no seu escritório, local da empresa ou por telefone): acesse a etapa 2.
- Diretamente no seu site (por exemplo, compras, inscrições ou envios de formulários): acesse a etapa 3.
- Em um app para dispositivos móveis: acesse a etapa 4.
- Por uma ligação feita diretamente dos seus anúncios: use Chamadas de anúncios (
AD_CALL) (usandoCallAsset).
Conversões off-line:
É uma ligação?
Sim:use
Importação de conversões de chamada (
UPLOAD_CALLS) para acompanhar resultados de chamadas.
É uma venda em loja física?
É uma venda off-line ou uma progressão de lead resultante de uma visita ao site?
- Sim:use as conversões otimizadas para leads com a API Data Manager (recomendado) ou consulte Gerenciar conversões de cliques off-line para integrações atuais da API Google Ads. Observação: a partir de 15 de junho de 2026, o upload de conversões de clique usando
UploadClickConversionsserá restrito a tokens de desenvolvedor que já fizeram upload de conversões de clique off-line.
- Sim:use as conversões otimizadas para leads com a API Data Manager (recomendado) ou consulte Gerenciar conversões de cliques off-line para integrações atuais da API Google Ads. Observação: a partir de 15 de junho de 2026, o upload de conversões de clique usando
Conversões on-line (no site):
- Você quer acompanhar carregamentos de página (compras, recibos) ou cliques do usuário?
- Sim:use Conversões no site com o
snippet de tag definido como
WEBPAGEouWEBPAGE_ONCLICK.
- Sim:use Conversões no site com o
snippet de tag definido como
Você quer acompanhar as chamadas feitas para um número de telefone listado no seu site?
Acompanhar a duração real das chamadas?
Sim:use
Chamadas de um site (
WEBSITE_CALL) com um número de encaminhamento de chamadas do Google dinâmico e um snippet de evento de tag.Não (apenas acompanhar cliques em botões/links no site para dispositivos móveis)? Usar
- Você quer acompanhar carregamentos de página (compras, recibos) ou cliques do usuário?
Conversões de apps para dispositivos móveis:
- O acompanhamento de instalações ou compras da Google Play Store é suficiente?
- Sim:use Conversões de app
(
GOOGLE_PLAY_DOWNLOADouGOOGLE_PLAY_IN_APP_PURCHASE).
- Sim:use Conversões de app
(
Você acompanha as ações no app usando o Google Analytics (GA4) ou a análise de apps de terceiros?
Sim:use
Firebase e análise de apps de terceiros (ativando as ações de conversão
FIREBASE_*ouTHIRD_PARTY_*).
- O acompanhamento de instalações ou compras da Google Play Store é suficiente?
Conversões off-line
As conversões off-line ajudam a acompanhar eventos de conversão que ocorrem no mundo off-line, como no seu escritório, no local da empresa ou por telefone.
A tabela a seguir mostra os parâmetros equivalentes da API ConversionActionType a serem usados para cada Origem na interface da Web do Google Ads e um link para a documentação de cada tipo específico de ação de conversão:
| Tipo de ação de conversão | Origem do Google Ads | Guia de configuração da API |
|---|---|---|
UPLOAD_CLICKS |
Acompanhar conversões originadas de cliques e conversões otimizadas para leads | Use a API Data Manager (recomendado) ou consulte Gerenciar conversões de clique off-line para integrações atuais da API Google Ads. |
UPLOAD_CALLS |
rastrear conversões de chamadas | Guia de importação de conversões de chamada |
STORE_SALES |
Acompanhar conversões de vendas na loja | Consulte Vendas na loja: importar para a ação de conversão com relatórios para mais detalhes. |
Conversões on-line (no site)
Uma conversão no site permite acompanhar ações no site, como vendas on-line, cliques em links, visualizações de página e inscrições.
Para acompanhar as conversões no seu site, crie uma
ConversionAction com o
ConversionActionType definido como WEBPAGE e adicione um snippet de código
chamado tag à página de conversão no seu site.
O ConversionAction abrange vários tipos de conversões
de sites, diferenciados na API pelo campo type em cada
TagSnippet listado no campo tag_snippets de
um ConversionAction.
Uma TagSnippet fornece o código de acompanhamento que precisa ser incluído no seu site para acompanhar as ações de conversão.
As conversões de site e clique no número de telefone exigem o
event_snippet, que deve ser colocado nas páginas da Web que
indicam uma ação de conversão, como uma confirmação de finalização de compra ou uma página de envio de formulário de lead,
e o global_site_tag, que precisa ser
instalado em todas as páginas do seu site. É possível recuperar esses dois atributos com o ConversionActionService. Confira
nossa Central de Ajuda para mais informações sobre como adicionar tags às suas páginas.
A tabela a seguir mostra os parâmetros de API equivalentes a serem usados para cada origem na interface da Web do Google Ads:
| Tipo de código de acompanhamento | Origem do Google Ads |
|---|---|
WEBPAGE |
Site, site (Google Analytics (GA4)) |
WEBPAGE_ONCLICK |
Site, Site (Google Analytics (GA4)) |
CLICK_TO_CALL |
Cliques no número de telefone |
Conversões de aplicativos
Uma conversão de app permite acompanhar as instalações de apps para dispositivos móveis ou as compras no app na Google Play Store.
A tabela a seguir mostra os parâmetros equivalentes da API ConversionActionType a serem usados para cada Origem na interface da Web do Google Ads:
| Tipo de ação de conversão | Origem do Google Ads |
|---|---|
GOOGLE_PLAY_DOWNLOAD |
Google Play > Instalações |
GOOGLE_PLAY_IN_APP_PURCHASE |
Google Play > Compras no app |
Para acompanhar outras ações de apps para dispositivos móveis usando as propriedades do Google Analytics 4 ou a análise de aplicativos de terceiros, consulte Outros tipos de ações de conversão.
Conversões de chamadas
Com o acompanhamento de conversões de chamada telefônica, é possível acompanhar chamadas de anúncios, ligações para um número no seu site e cliques em números em sites móveis.
A tabela a seguir mostra os parâmetros equivalentes da API
ConversionActionType a serem usados para cada
Origem na interface da Web do Google Ads:
| Tipo de ação de conversão | Origem do Google Ads |
|---|---|
AD_CALL |
Chamadas a partir de anúncios com extensões de chamada ou anúncios só para chamadas |
WEBSITE_CALL |
Chamadas para um número de telefone no seu site |
CLICK_TO_CALL |
Cliques em um número no seu site móvel |
AD_CALL
Uma ação de conversão AD_CALL aparece como uma conversão de chamadas de anúncios na interface da Web do Google Ads.
Depois de criar a ação de conversão AD_CALL, especifique o nome do recurso no campo call_conversion_action ao criar um CallAsset.
Com os recursos de ligação, você pode mostrar um número de telefone diretamente nos seus anúncios.
Uma chamada é considerada como conversão quando ultrapassa a duração especificada. O padrão é 60 segundos.
WEBSITE_CALL
Uma ação de conversão WEBSITE_CALL aparece como uma conversão Chamadas de um
site na interface da Web do Google Ads.
Ao contrário de AD_CALL, esse rastreador exige que
event_snippet e global_site_tag sejam
adicionados ao seu site para recuperar o
número de encaminhamento de chamadas do Google dinâmico para rastreamento
de chamadas em números listados no seu site. Além disso, é necessário configurar um recurso de ligação e
vincule-o no nível do cliente, da campanha ou do grupo de anúncios.
CLICK_TO_CALL
Uma ação de conversão de CLICK_TO_CALL aparece como uma conversão de Cliques no seu número em um site para dispositivos móveis na interface da Web do Google Ads.
O tipo CLICK_TO_CALL é diferente do tipo AD_CALL porque não acompanha as chamadas telefônicas reais. Em vez disso, o CLICK_TO_CALL só
rastreia cliques em um número de telefone de um dispositivo móvel. Isso é útil quando não é possível usar um número de encaminhamento de chamadas do Google para acompanhar as ligações.
Conversões otimizadas
As conversões otimizadas ajudam a melhorar a precisão da medição de conversões, complementando as tags de conversão atuais com dados próprios, como endereço de e-mail, nome, endereço residencial e número de telefone.
A tabela a seguir mostra os parâmetros de API equivalentes para cada tipo de conversão otimizada:
| Tipo de ação de conversão | Tipo de conversão otimizada | Guia de configuração da API |
|---|---|---|
UPLOAD_CLICKS |
Conversões otimizadas para leads
Melhora a medição das transações off-line de um lead ou visitante do site. |
Use a API Data Manager (recomendado) ou consulte Gerenciar conversões de clique off-line para integrações atuais da API Google Ads. |
WEBPAGE |
Conversões otimizadas para a web
Melhora a medição das conversões on-line |
Guia de configuração da API |
Outros tipos de ação de conversão
A API Google Ads disponibiliza outros tipos de ações de conversão nos relatórios, mas pode limitar ou proibir a criação ou modificação dessas ações. É possível
consultar suas ações de conversão e os tipos delas usando GoogleAdsService:
SELECT
conversion_action.id,
conversion_action.name,
conversion_action.type,
conversion_action.status
FROM conversion_action
Conversões da SKAdNetwork
Se você veicula campanhas para apps iOS e implementou a SKAdNetwork, é possível acessar os dados da SKAdNetwork fornecidos ao Google nos níveis Customer e Campaign usando os seguintes recursos:
| Campo do relatório | Descrição |
|---|---|
metrics.sk_ad_network_installs |
É o número de instalações informado pela Apple. Essa métrica só pode ser segmentada
por qualquer combinação de segments.sk_ad_network_conversion_value e
segmentos relacionados à data.
|
metrics.sk_ad_network_total_conversions |
O número total de conversões, incluindo instalações e outros tipos de conversões informadas pela Apple. Essa métrica só pode ser segmentada por segmentos relacionados à SKAdNetwork e à data. |
segments.sk_ad_network_ad_event_type |
O tipo de evento que ocorreu para uma conversão específica. |
segments.sk_ad_network_attribution_credit |
Como a atribuição é creditada para uma conversão específica. |
segments.sk_ad_network_fine_conversion_value |
O valor de um relatório de conversão informado pela Apple. Esse segmento não pode ser aplicado a nenhuma métrica além de Um valor de |
segments.sk_ad_network_coarse_conversion_value |
O valor aproximado de uma conversão individual. |
segments.sk_ad_network_postback_sequence_index |
A posição do postback, em sequência, para uma conversão específica. |
segments.sk_ad_network_source_app.sk_ad_network_source_app_id |
O ID do app em que o anúncio que gerou a instalação da rede de publicidade do kit da loja do iOS foi mostrado. |
segments.sk_ad_network_source_domain |
O site em que o anúncio que gerou a instalação da rede de publicidade do kit da loja do iOS foi mostrado. Um valor nulo significa que esse segmento não é aplicável (por exemplo, uma campanha que não é para iOS) ou não estava presente em nenhum postback enviado pela Apple. |
segments.sk_ad_network_source_type |
O tipo de origem em que o anúncio que gerou a instalação da rede de publicidade do kit da loja do iOS foi mostrado. Um valor nulo significa que esse segmento não é relevante (por exemplo, campanha que não é para iOS) ou que nem o domínio nem o app de origem estavam presentes em nenhum postback enviado pela Apple. |
segments.sk_ad_network_user_type |
O tipo de usuário que gerou uma conversão específica. |
segments.sk_ad_network_redistributed_fine_conversion_value |
Os valores de conversão nesse segmento incluem valores nulos que foram redistribuídos para valores de conversão. Esse segmento representa a soma dos valores de conversão refinados registrados retornados pela Apple e dos valores nulos estimados do Google. |
segments.sk_ad_network_version |
A versão da API de rede de publicidade do StoreKit do iOS usada. |
Google Analytics
As conversões de uma propriedade do Google Analytics vinculada têm um dos seguintes valores de type:
Conversão da propriedade do GA4:
GOOGLE_ANALYTICS_4_CUSTOMGOOGLE_ANALYTICS_4_PURCHASE
Você também pode recuperar o ID da propriedade do GA4, o nome da propriedade e o nome do evento no campo
google_analytics_4_settings.
É possível fazer as seguintes mudanças em uma conversão de propriedade do GA4:
- Importe a conversão da sua propriedade do GA4 para a conta do Google Ads modificando o campo
statusdeHIDDENparaENABLED. - Modifique os campos
primary_for_goalecategorypara indicar como isso deve afetar os lances e relatórios do Google Ads. - Atualize o
nameou ovalue_settings. - Remova a conversão da sua conta do Google Ads usando uma operação
remove.
Qualquer tentativa de modificar outros atributos de uma conversão importada do GA4 ou qualquer atributo de uma conversão importada do Universal Analytics resulta em um erro MUTATE_NOT_ALLOWED. Só é possível fazer essas mudanças usando a interface do Google Ads.
Análise de apps do Firebase e de terceiros
Para importar conversões de análise de apps de terceiros ou do Firebase, mude o status do ConversionAction de HIDDEN para ENABLED usando o método mutate de ConversionActionService. Não é possível atualizar o
app_id para essas ações de conversão.
FIREBASE_ANDROID_APP_AD_IMPRESSIONFIREBASE_ANDROID_FIRST_OPENFIREBASE_ANDROID_IN_APP_PURCHASEFIREBASE_ANDROID_CUSTOMFIREBASE_IOS_APP_AD_IMPRESSIONFIREBASE_IOS_FIRST_OPENFIREBASE_IOS_IN_APP_PURCHASEFIREBASE_IOS_CUSTOMTHIRD_PARTY_APP_ANALYTICS_ANDROID_FIRST_OPENTHIRD_PARTY_APP_ANALYTICS_ANDROID_IN_APP_PURCHASETHIRD_PARTY_APP_ANALYTICS_ANDROID_CUSTOMTHIRD_PARTY_APP_ANALYTICS_IOS_FIRST_OPENTHIRD_PARTY_APP_ANALYTICS_IOS_IN_APP_PURCHASETHIRD_PARTY_APP_ANALYTICS_IOS_CUSTOM
Vendas na loja: importação para ação de conversão com relatórios
Embora não seja possível criar ações de conversão de STORE_SALES ou STORE_SALES_DIRECT_UPLOAD usando a API Google Ads, ela permite importar transações de vendas na loja.
STORE_SALESSTORE_SALES_DIRECT_UPLOAD
Tipos de ações de conversão somente leitura
Os seguintes tipos de ação de conversão são somente leitura na API Google Ads e fornecidos para fins de relatório.
ANDROID_APP_PRE_REGISTRATIONANDROID_INSTALLS_ALL_OTHER_APPSFLOODLIGHT_ACTIONFLOODLIGHT_TRANSACTIONGOOGLE_HOSTEDLEAD_FORM_SUBMITSALESFORCESEARCH_ADS_360SMART_CAMPAIGN_AD_CLICKS_TO_CALLSMART_CAMPAIGN_MAP_CLICKS_TO_CALLSMART_CAMPAIGN_MAP_DIRECTIONSSMART_CAMPAIGN_TRACKED_CALLSSTORE_VISITSWEBPAGE_CODELESS
Desconhecido
Se a sua conta do Google Ads incluir outros tipos de ações de conversão, talvez as consultas e os relatórios retornem ações de conversão em que o ConversionAction.type é UNKNOWN. A API não é compatível com o gerenciamento dessas ações de conversão, mas as retorna em relatórios para fornecer resultados completos de métricas de conversão importantes, como metrics.conversions e metrics.conversions_value.