Categorias de ação de conversão

Este guia fornece uma lista dos diferentes tipos de ações de conversão que você pode criar usando a API Google Ads, além de informações sobre como elas são mapeadas para a interface da Web do Google Ads.

Conversões off-line

As conversões off-line ajudam você a acompanhar eventos de conversão que ocorrem no mundo off-line, como no seu escritório, na sua 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 de ação de conversão específico:

Tipo de ação de conversão	Origem do Google Ads	Guia de configuração da API
UPLOAD_CLICKS	Acompanhar conversões de cliques e conversões otimizadas para leads	Guia de gerenciamento de conversões de clique off-line Guia de conversões otimizadas para leads
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 (site)

Com uma conversão no site, você pode rastrear ações como vendas on-line, cliques em links, visualizações de página e inscrições.

Para acompanhar as conversões no seu site, crie um 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 diferenciados 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 deve ser colocado em páginas da Web que indicam uma ação de conversão, como uma página de confirmação de finalização da compra ou de envio de formulário de lead, e global_site_tag, que precisa ser instalado em todas as páginas do seu site. É possível recuperar os 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

Observação: WEBPAGE e WEBPAGE_ONCLICK têm as mesmas fontes que Website. A diferença está na opção Snippet de evento na interface da Web. WEBPAGE corresponde a Carregamento de página para essa opção, enquanto WEBPAGE_ONCLICK corresponde a Clique. Consulte este artigo da Central de Ajuda para mais informações.

Conversões de apps

Com uma conversão de app, é possível acompanhar instalações de apps para dispositivos móveis ou 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 apps de terceiros, consulte Outros tipos de ação de conversão.

Observação: se você também estiver especificando o campo category, defina-o como DOWNLOAD somente se o tipo de conversão for GOOGLE_PLAY_DOWNLOAD.

Conversões de ligações telefônicas

Com o acompanhamento de conversões de chamada, você acompanha chamadas de anúncios, ligações para um número no seu site e cliques em números em sites para dispositivos 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	Clica em um número no seu website para dispositivos móveis

AD_CALL

Uma ação de conversão de 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 dela 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 de WEBSITE_CALL aparece como uma conversão de Chamadas de um site na interface da Web do Google Ads.

Ao contrário do AD_CALL, esse rastreador exige que event_snippet e global_site_tag sejam adicionados ao site para recuperar o número dinâmico de encaminhamento de chamadas do Google para o rastreamento de chamadas nos números listados no site. Além disso, é preciso configurar um recurso de ligação e vincular 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 no site móvel na interface da Web do Google Ads.

O tipo CLICK_TO_CALL é diferente do tipo AD_CALL porque não acompanha chamadas telefônicas. Em vez disso, o CLICK_TO_CALL rastreia apenas cliques em um número de telefone de um dispositivo móvel. Isso é útil quando você não pode usar um número de encaminhamento de chamadas do Google para rastrear 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 de conversão, como e-mail, nome, endereço residencial e número de telefone.

A tabela a seguir mostra os parâmetros de API equivalentes 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 Melhora a medição das transações off-line de um lead ou visitante do site	Guia de configuração da API
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 em relatórios, mas pode limitar ou proibir a criação ou modificação delas.

Conversões da SKAdNetwork

Se você veicular campanhas para apps iOS e tiver implementado a SKAdNetwork, poderá acessar os dados da SKAdNetwork fornecidos ao Google no nível 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 a datas.
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. Ela 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 uma conversão informada pela Apple. Esse segmento não pode ser aplicado a métricas diferentes de metrics.sk_ad_network_installs, metrics.sk_ad_network_total_conversions e só pode ser combinado com segmentos relacionados a datas. Um valor de 0 será retornado se a Apple informar um valor de 0. Caso contrário, nenhum valor será retornado. 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 detalhados registrados retornados pela Apple e dos valores nulos estimados do Google.
segments.sk_ad_network_version	A versão da API AdNetwork do StoreKit do iOS que foi usada.

Google Analytics

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

• Conversão da propriedade do GA4:

  • GOOGLE_ANALYTICS_4_CUSTOM
  • GOOGLE_ANALYTICS_4_PURCHASE

  Também é possível 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 status de HIDDEN para ENABLED.
• Modifique os campos primary_for_goal e category para indicar como ele deve afetar os relatórios e os lances 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. Essas mudanças só podem ser feitas usando a interface do Google Ads.

Firebase e análise de apps 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_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: importação para ação de conversão com relatórios

Embora não seja possível criar ações de conversão STORE_SALES ou STORE_SALES_DIRECT_UPLOAD usando a API Google Ads, ela permite importar transações de vendas na loja.

• STORE_SALES
• STORE_SALES_DIRECT_UPLOAD

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

Os seguintes tipos de ação de conversão 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, talvez as consultas e os relatórios retornem 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 das principais métricas de conversão, como metrics.conversions e metrics.conversions_value.