Categorias de ações de conversão

Este guia fornece uma lista dos diferentes tipos de ações de conversão que podem ser criadas 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 de ação de conversão certo

Para ajudar a selecionar o tipo de ação de conversão correto e o guia de configuração da sua integração, use o seguinte caminho de decisão:

  1. 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.
    • Em uma chamada telefônica feita diretamente dos seus anúncios: use Chamadas de anúncios (AD_CALL) (usando CallAsset).
  2. Conversões off-line

  3. Conversões on-line (no site)

    • Você quer acompanhar carregamentos de página (compras, recibos) ou cliques do usuário?
    • Você quer acompanhar chamadas feitas a partir de um número de telefone listado no seu site?
  4. Conversões de apps para dispositivos móveis

    • O acompanhamento de instalações ou compras na Google Play Store é suficiente?
    • Você acompanha ações de apps usando o Google Analytics (GA4) ou a análise de apps de terceiros?

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, local da empresa ou por telefone.

A tabela a seguir mostra os parâmetros equivalentes ConversionActionType da API a serem usados para cada origem na interface da Web do Google Ads e um link para a documentação de cada tipo de ação de conversão específica:

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 Usar a API Data Manager
UPLOAD_CALLS Acompanhar conversões de chamadas Guia de importação de conversões de chamada
STORE_SALES Acompanhar conversões de vendas na loja Guia de importação de conversões de vendas na loja

Conversões on-line (no site)

Uma conversão no site permite acompanhar ações como vendas on-line, cliques em links, visualizações de páginas 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 do seu site.

O ConversionAction abrange vários tipos de conversões no site, que são diferenciadas na API pelo campo type em cada TagSnippet listado no campo tag_snippets de um ConversionAction.

Um 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 precisa ser colocado em 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 a global_site_tag, que precisa ser instalada em todas as páginas do seu site. Você pode recuperar esses dois atributos com o ConversionActionService. Consulte nossa Central de Ajuda para mais informações sobre como marcar suas páginas.

A tabela a seguir mostra os parâmetros equivalentes da API 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 instalações de apps para dispositivos móveis ou compras no app da 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 apps de terceiros, consulte Tipos de ação de conversão adicionais.

Conversões de chamadas

O rastreamento de conversões de chamada permite acompanhar chamadas a partir de anúncios, chamadas 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 Chamadas a partir de anúncios conversão na interface da Web do Google Ads. Depois de criar sua AD_CALL ação de conversão, especifique o nome do recurso no call_conversion_action campo ao criar um CallAsset. Os recursos de ligação permitem 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 de 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 dinâmico do Google para o acompanhamento de chamadas em números listados no seu site. Além disso, você precisa configurar um recurso de ligação e vinculá-lo no nível do cliente, da campanha ou do grupo de anúncios.

CLICK_TO_CALL

Uma ação de conversão CLICK_TO_CALL aparece como uma conversão de Cliques no seu número no seu site móvel na interface da Web do Google Ads.

O tipo CLICK_TO_CALL difere do tipo AD_CALL porque ele não acompanha chamadas telefônicas reais. Em vez disso, CLICK_TO_CALL acompanha apenas 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 chamadas telefônicas.

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 de conversão como endereço de e-mail, nome, endereço residencial e número de telefone.

A tabela a seguir mostra os parâmetros equivalentes da API a serem usados 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
Melhoram a medição das transações off-line de um lead ou visitante do site
Usar a API Data Manager
WEBPAGE Conversões otimizadas para a Web
Melhoram a medição das conversões on-line
Guia de configuração da API

Tipos de ação de conversão adicionais

A API Google Ads disponibiliza outros tipos de ações de conversão em relatórios, mas pode limitar ou proibir a criação ou modificação dessas ações.

Conversões da SKAdNetwork

Se você veicula campanhas para apps iOS e implementou a SKAdNetwork, você pode acessar os dados da SKAdNetwork fornecidos ao Google no nível da Customer e da 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 informados pela Apple. Essa métrica só pode ser segmentada por segmentos relacionados à SKAdNetwork e segmentos relacionados à 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 uma conversão informado pela Apple. Esse segmento não pode ser aplicado a nenhuma métrica que não seja metrics.sk_ad_network_installs, metrics.sk_ad_network_total_conversions, e só pode ser combinado com segmentos relacionados à data.

Um valor de 0 é retornado se a Apple informar um valor de 0 e nenhum valor caso contrário. Verifique a presença do campo para distinguir entre os dois casos.

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 é do 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 é aplicável (por exemplo, uma campanha que não é do iOS) ou que nem o domínio de origem 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 observados retornados pela Apple e os valores nulos modelados do Google.
segments.sk_ad_network_version A versão da API da rede de publicidade do kit da loja do iOS que foi usada.

Google Analytics

As conversões de uma propriedade vinculada do Google Analytics têm um dos seguintes valores type:

  • Conversão de propriedade do GA4:

    • GOOGLE_ANALYTICS_4_CUSTOM
    • GOOGLE_ANALYTICS_4_PURCHASE

    Você também pode recuperar o ID da propriedade do GA4, o nome da propriedade e o nome do evento no google_analytics_4_settings campo.

É possível fazer as seguintes alterações 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 status de HIDDEN para ENABLED.
  • Modifique os campos primary_for_goal e category para indicar como ela deve afetar os lances e relatórios do Google Ads.
  • Atualize o name ou value_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 de terceiros e do Firebase

Para importar conversões de análise de apps de terceiros ou do Firebase, mude o status da ConversionAction de HIDDEN para ENABLED usando o método mutate de ConversionActionService. A atualização do app_id está indisponível para essas ações de conversão.

  • FIREBASE_ANDROID_FIRST_OPEN
  • FIREBASE_ANDROID_IN_APP_PURCHASE
  • FIREBASE_ANDROID_CUSTOM
  • FIREBASE_IOS_FIRST_OPEN
  • FIREBASE_IOS_IN_APP_PURCHASE
  • FIREBASE_IOS_CUSTOM
  • THIRD_PARTY_APP_ANALYTICS_ANDROID_FIRST_OPEN
  • THIRD_PARTY_APP_ANALYTICS_ANDROID_IN_APP_PURCHASE
  • THIRD_PARTY_APP_ANALYTICS_ANDROID_CUSTOM
  • THIRD_PARTY_APP_ANALYTICS_IOS_FIRST_OPEN
  • THIRD_PARTY_APP_ANALYTICS_IOS_IN_APP_PURCHASE
  • THIRD_PARTY_APP_ANALYTICS_IOS_CUSTOM

Vendas na loja: importar para ação de conversão com relatórios

Embora não seja possível criar STORE_SALES ou STORE_SALES_DIRECT_UPLOAD ações de conversão usando a API Google Ads, a API oferece suporte à importação de vendas na loja.

  • STORE_SALES
  • STORE_SALES_DIRECT_UPLOAD

Tipos de ação de conversão somente leitura

Os tipos de ação de conversão a seguir são somente leitura na API Google Ads e são fornecidos para fins de relatórios.

  • ANDROID_APP_PRE_REGISTRATION
  • ANDROID_INSTALLS_ALL_OTHER_APPS
  • FLOODLIGHT_ACTION
  • FLOODLIGHT_TRANSACTION
  • GOOGLE_HOSTED
  • LEAD_FORM_SUBMIT
  • SALESFORCE
  • SEARCH_ADS_360
  • SMART_CAMPAIGN_AD_CLICKS_TO_CALL
  • SMART_CAMPAIGN_MAP_CLICKS_TO_CALL
  • SMART_CAMPAIGN_MAP_DIRECTIONS
  • SMART_CAMPAIGN_TRACKED_CALLS
  • STORE_VISITS
  • WEBPAGE_CODELESS

Desconhecido

Se a sua conta do Google Ads incluir outros tipos de ações de conversão, você poderá descobrir que as consultas e os relatórios retornam ações de conversão em que o ConversionAction.type é UNKNOWN. A API não oferece suporte ao gerenciamento dessas ações de conversão, mas as retorna em relatórios para fornecer resultados completos para métricas de conversão importantes, como metrics.conversions e metrics.conversions_value.