Considera-se uma conversão no Google Ads quando um usuário executa alguma ação específica depois de visualizar ou clicar em um anúncio da Rede de Display. Compra de produtos, instalação de aplicativos para dispositivos móveis e inscrição em listas de e-mail são exemplos dessas ações.
O acompanhamento de conversões fornece insights importantes sobre as ações dos usuários depois que visualizam ou clicam em um anúncio. Você pode acompanhar usuários que fazem chamadas, compram produtos, instalam aplicativos para dispositivos móveis e muito mais.
Ações de conversão
Para medir as conversões, configure um ConversionAction
para o tipo de ação de conversão que você quer acompanhar. Por exemplo, uma compra on-line e uma chamada telefônica
exigem ações de conversão diferentes.
A maioria das ações de conversão também exige etapas adicionais para o acompanhamento. Por exemplo, para acompanhar conversões no seu site, você precisa criar um ConversionAction
com o ConversionActionType
definido como WEBPAGE
e adicionar um snippet de código chamado tag à página de conversão no seu site.
Conversões off-line e otimizadas para leads
Use os tipos de ação de conversão off-line para uploads de conversão.
UPLOAD_CLICKS
serve para fazer upload de conversões de clique off-line e conversões otimizadas para leads.UPLOAD_CALLS
serve para fazer upload de conversões de chamada off-line.
Conversões otimizadas para Web
Com as conversões otimizadas para a Web, você pode enviar dados de conversão próprios para ações de conversão de WEBPAGE
em até 24 horas após um evento de conversão, e não ao mesmo tempo. Isso permite localizar dados próprios de várias fontes, como um banco de dados de clientes ou um sistema de CRM.
Conversões de chamadas telefônicas
Uma ação de conversão AD_CALL
aparece como uma conversão de Chamadas a partir de anúncios na interface da Web do Google Ads. Depois de criar sua ação de conversão AD_CALL
, especifique o
nome do recurso no campo call_conversion_action
ao criar uma
CallAsset
.
Uma chamada é considerada como conversão quando ultrapassa a duração especificada. O padrão é 60 segundos.
Conversões de chamada do site
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 do AD_CALL
, esse rastreador requer a adição de event_snippet
e global_site_tag
ao seu site para recuperar o número dinâmico de encaminhamento de chamadas do Google para o acompanhamento de chamadas dos 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.
Conversões no site
O ConversionAction
abrange vários
tipos de conversões no site, diferenciados na API pelo campo
type
em
TagSnippet
.
A tabela a seguir mostra os parâmetros de API equivalentes a serem usados em 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 |
--- |
Site (Google Analytics (UA)) |
As conversões de cliques no site e cliques no número de telefone exigem o event_snippet
, que precisa ser inserido em páginas da Web que indicam uma ação de conversão, como uma página de confirmação de finalização de compra ou de envio de lead, e global_site_tag
, que precisa ser instalado em todas as páginas do seu site. É possível extrair esses dois
atributos com
ConversionActionService
.
O tipo CLICK_TO_CALL
é diferente do tipo AD_CALL
porque não rastreia chamadas telefônicas reais. O CLICK_TO_CALL
só acompanha cliques em um número de telefone provenientes de dispositivos móveis. Isso é útil quando você não consegue usar um número de encaminhamento de chamadas do Google para acompanhar chamadas telefônicas.
Conversões de apps
ConversionActionType
abrange instalações de apps para dispositivos móveis e ações no app Android. A tabela a seguir mostra os parâmetros de API equivalentes a serem usados em cada Origem na interface da Web do Google Ads:
Tipo de ação de conversão | Origem do Google Ads |
---|---|
GOOGLE_PLAY_DOWNLOAD |
Instalação de app Android (primeiro acesso) |
GOOGLE_PLAY_IN_APP_PURCHASE |
Ação no app Android |
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 nos níveis Customer
e Campaign
usando
os seguintes recursos:
Campo do relatório | Descrição |
---|---|
metrics.sk_ad_network_conversions |
O número de conversõ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.
|
segments.sk_ad_network_conversion_value |
O valor de uma conversão informado pela Apple. Esse segmento não pode ser aplicado a nenhuma métrica diferente de Um valor de |
Também é possível salvar um mapeamento de valor da conversão da SKAdNetwork para clientes vinculados específicos com apps iOS usando CustomerSkAdNetworkConversionValueSchema
.
Exemplo de código Python
#!/usr/bin/env python # Copyright 2019 Google LLC # # Licensed under the Apache License, Version 2.0 (the "License"); # you may not use this file except in compliance with the License. # You may obtain a copy of the License at # # https://www.apache.org/licenses/LICENSE-2.0 # # Unless required by applicable law or agreed to in writing, software # distributed under the License is distributed on an "AS IS" BASIS, # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. # See the License for the specific language governing permissions and # limitations under the License. import argparse import sys from google.ads.googleads.client import GoogleAdsClient from google.ads.googleads.errors import GoogleAdsException def main(client, customer_id): """Adds a keyword plan, campaign, ad group, etc. to the customer account. Also handles errors from the API and prints them. Args: client: An initialized instance of GoogleAdsClient customer_id: A str of the customer_id to use in requests. """ res = update_skan_cv_schema( client, customer_id, "my_app_id", "account_link_id" ) print(res) def update_skan_cv_schema(client, customer_id, app_id, account_link_id): skan_service = client.get_service( "CustomerSkAdNetworkConversionValueSchemaService" ) req = client.get_type( "MutateCustomerSkAdNetworkConversionValueSchemaRequest" ) operation = client.get_type( "CustomerSkAdNetworkConversionValueSchemaOperation" ) schema_instance = client.get_type( "CustomerSkAdNetworkConversionValueSchema" ) new_schema = operation.update new_schema.resource_name = ( skan_service.customer_sk_ad_network_conversion_value_schema_path( "customer_id", "account_link_id" ) ) new_schema.schema.app_id = app_id new_schema.schema.measurement_window_hours = 48 skan_cv_mapping = ( schema_instance.SkAdNetworkConversionValueSchema.FineGrainedConversionValueMappings() ) skan_cv_mapping.fine_grained_conversion_value = 0 # 0 - 63 skan_cv_mapping.conversion_value_mapping.min_time_post_install_hours = 0 skan_cv_mapping.conversion_value_mapping.max_time_post_install_hours = 48 skan_cv_event = schema_instance.SkAdNetworkConversionValueSchema.Event() skan_cv_event.mapped_event_name = "TEST" skan_cv_event.event_revenue_value = 10 skan_cv_mapping.conversion_value_mapping.mapped_events.append(skan_cv_event) new_schema.schema.fine_grained_conversion_value_mappings.append( skan_cv_mapping ) req.operation = operation req.customer_id = customer_id res = skan_service.mutate_customer_sk_ad_network_conversion_value_schema( req ) return res if __name__ == "__main__": # GoogleAdsClient will read the google-ads.yaml configuration file in the # home directory if none is specified. googleads_client = GoogleAdsClient.load_from_storage( version="v15" ) parser = argparse.ArgumentParser( description="Creates a keyword plan for specified customer." ) # The following argument(s) should be provided to run the example. parser.add_argument( "-c", "--customer_id", type=str, required=True, help="The Google Ads customer ID.", ) args = parser.parse_args() try: main(googleads_client, args.customer_id) except GoogleAdsException as ex: print( f'Request with ID "{ex.request_id}" failed with status ' f'"{ex.error.code().name}" and includes the following errors:' ) for error in ex.failure.errors: print(f'\tError with message "{error.message}".') if error.location: for field_path_element in error.location.field_path_elements: print(f"\t\tOn field: {field_path_element.field_name}") sys.exit(1)
Outros tipos de conversão
Existem vários tipos de ações de conversão que não podem ser criados com a API Google Ads. No entanto, é possível recuperar as métricas de performance em relatórios e, em alguns casos, modificar alguns atributos.
Metas de conversão
As metas de conversão ajudam a organizar as ações de conversão para otimizar com mais facilidade seus objetivos publicitários. Confira o guia de metas para mais informações.
Regras do valor da conversão
Com as regras do valor da conversão, você pode definir regras para ajustar os valores das suas conversões com base em várias dimensões.
Ativar o acompanhamento de conversões na sua conta do Google Ads
Recuperar informações sobre a configuração do acompanhamento de conversões
Para verificar a configuração do acompanhamento de conversões da sua conta e confirmar se ele está ativado, consulte o recurso Customer
para ConversionTrackingSetting
.
Faça a consulta abaixo com
GoogleAdsService.searchStream
:
SELECT
customer.conversion_tracking_setting.google_ads_conversion_customer,
customer.conversion_tracking_setting.conversion_tracking_status,
customer.conversion_tracking_setting.conversion_tracking_id,
customer.conversion_tracking_setting.cross_account_conversion_tracking_id
FROM customer
O campo google_ads_conversion_customer
indica a conta do Google Ads que cria e gerencia conversões para esse cliente. Para clientes que usam o acompanhamento de conversões de várias contas, esse é o ID de uma conta de administrador. O ID de cliente de conversão do Google Ads precisa ser fornecido como customer_id
nas solicitações da API Google Ads para criar e gerenciar conversões.
Esse campo é preenchido mesmo se o acompanhamento de conversões não estiver ativado.
O campo conversion_tracking_status
indica se o acompanhamento de conversões está ativado e se a conta está usando o acompanhamento de conversões de várias contas.
Criar uma ação de conversão no cliente de conversão do Google Ads
Se o valor de conversion_tracking_status
for NOT_CONVERSION_TRACKED
, o acompanhamento de conversões não será ativado na conta. Para ativar o acompanhamento de conversões, crie pelo menos um ConversionAction
na conta de conversão do Google Ads, como no exemplo a seguir. Como alternativa, você pode criar uma ação de conversão na IU seguindo as instruções na Central de Ajuda para o tipo de conversão que você quer ativar.
As conversões otimizadas são ativadas automaticamente quando enviadas pela API Google Ads, mas podem ser desativadas na IU do Google Ads.
Exemplo de código
Java
private void runExample(GoogleAdsClient googleAdsClient, long customerId) { // Creates a ConversionAction. ConversionAction conversionAction = ConversionAction.newBuilder() .setName("Earth to Mars Cruises Conversion #" + getPrintableDateTime()) .setCategory(ConversionActionCategory.DEFAULT) .setType(ConversionActionType.WEBPAGE) .setStatus(ConversionActionStatus.ENABLED) .setViewThroughLookbackWindowDays(15L) .setValueSettings( ValueSettings.newBuilder() .setDefaultValue(23.41) .setAlwaysUseDefaultValue(true) .build()) .build(); // Creates the operation. ConversionActionOperation operation = ConversionActionOperation.newBuilder().setCreate(conversionAction).build(); try (ConversionActionServiceClient conversionActionServiceClient = googleAdsClient.getLatestVersion().createConversionActionServiceClient()) { MutateConversionActionsResponse response = conversionActionServiceClient.mutateConversionActions( Long.toString(customerId), Collections.singletonList(operation)); System.out.printf("Added %d conversion actions:%n", response.getResultsCount()); for (MutateConversionActionResult result : response.getResultsList()) { System.out.printf( "New conversion action added with resource name: '%s'%n", result.getResourceName()); } } }
C#
public void Run(GoogleAdsClient client, long customerId) { // Get the ConversionActionService. ConversionActionServiceClient conversionActionService = client.GetService(Services.V15.ConversionActionService); // Add a conversion action. ConversionAction conversionAction = new ConversionAction() { Name = "Earth to Mars Cruises Conversion #" + ExampleUtilities.GetRandomString(), Category = ConversionActionCategory.Default, Type = ConversionActionType.Webpage, Status = ConversionActionStatus.Enabled, ViewThroughLookbackWindowDays = 15, ValueSettings = new ConversionAction.Types.ValueSettings() { DefaultValue = 23.41, AlwaysUseDefaultValue = true } }; // Create the operation. ConversionActionOperation operation = new ConversionActionOperation() { Create = conversionAction }; try { // Create the conversion action. MutateConversionActionsResponse response = conversionActionService.MutateConversionActions(customerId.ToString(), new ConversionActionOperation[] { operation }); // Display the results. foreach (MutateConversionActionResult newConversionAction in response.Results) { Console.WriteLine($"New conversion action with resource name = " + $"'{newConversionAction.ResourceName}' was added."); } } catch (GoogleAdsException e) { Console.WriteLine("Failure:"); Console.WriteLine($"Message: {e.Message}"); Console.WriteLine($"Failure: {e.Failure}"); Console.WriteLine($"Request ID: {e.RequestId}"); throw; } }
PHP
public static function runExample(GoogleAdsClient $googleAdsClient, int $customerId) { // Creates a conversion action. $conversionAction = new ConversionAction([ 'name' => 'Earth to Mars Cruises Conversion #' . Helper::getPrintableDatetime(), 'category' => ConversionActionCategory::PBDEFAULT, 'type' => ConversionActionType::WEBPAGE, 'status' => ConversionActionStatus::ENABLED, 'view_through_lookback_window_days' => 15, 'value_settings' => new ValueSettings([ 'default_value' => 23.41, 'always_use_default_value' => true ]) ]); // Creates a conversion action operation. $conversionActionOperation = new ConversionActionOperation(); $conversionActionOperation->setCreate($conversionAction); // Issues a mutate request to add the conversion action. $conversionActionServiceClient = $googleAdsClient->getConversionActionServiceClient(); $response = $conversionActionServiceClient->mutateConversionActions( MutateConversionActionsRequest::build($customerId, [$conversionActionOperation]) ); printf("Added %d conversion actions:%s", $response->getResults()->count(), PHP_EOL); foreach ($response->getResults() as $addedConversionAction) { /** @var ConversionAction $addedConversionAction */ printf( "New conversion action added with resource name: '%s'%s", $addedConversionAction->getResourceName(), PHP_EOL ); } }
Python
def main(client, customer_id): conversion_action_service = client.get_service("ConversionActionService") # Create the operation. conversion_action_operation = client.get_type("ConversionActionOperation") # Create conversion action. conversion_action = conversion_action_operation.create conversion_action.name = f"Earth to Mars Cruises Conversion {uuid.uuid4()}" conversion_action.type_ = ( client.enums.ConversionActionTypeEnum.UPLOAD_CLICKS ) conversion_action.category = ( client.enums.ConversionActionCategoryEnum.DEFAULT ) conversion_action.status = client.enums.ConversionActionStatusEnum.ENABLED conversion_action.view_through_lookback_window_days = 15 # Create a value settings object. value_settings = conversion_action.value_settings value_settings.default_value = 15.0 value_settings.always_use_default_value = True # Add the conversion action. conversion_action_response = ( conversion_action_service.mutate_conversion_actions( customer_id=customer_id, operations=[conversion_action_operation], ) ) print( "Created conversion action " f'"{conversion_action_response.results[0].resource_name}".' )
Ruby
def add_conversion_action(customer_id) # GoogleAdsClient will read a config file from # ENV['HOME']/google_ads_config.rb when called without parameters client = Google::Ads::GoogleAds::GoogleAdsClient.new # Add a conversion action. conversion_action = client.resource.conversion_action do |ca| ca.name = "Earth to Mars Cruises Conversion #{(Time.new.to_f * 100).to_i}" ca.type = :UPLOAD_CLICKS ca.category = :DEFAULT ca.status = :ENABLED ca.view_through_lookback_window_days = 15 # Create a value settings object. ca.value_settings = client.resource.value_settings do |vs| vs.default_value = 15 vs.always_use_default_value = true end end # Create the operation. conversion_action_operation = client.operation.create_resource.conversion_action(conversion_action) # Add the ad group ad. response = client.service.conversion_action.mutate_conversion_actions( customer_id: customer_id, operations: [conversion_action_operation], ) puts "New conversion action with resource name = #{response.results.first.resource_name}." end
Perl
sub add_conversion_action { my ($api_client, $customer_id) = @_; # Create a conversion action. my $conversion_action = Google::Ads::GoogleAds::V15::Resources::ConversionAction->new({ name => "Earth to Mars Cruises Conversion #" . uniqid(), category => DEFAULT, type => WEBPAGE, status => ENABLED, viewThroughLookbackWindowDays => 15, valueSettings => Google::Ads::GoogleAds::V15::Resources::ValueSettings->new({ defaultValue => 23.41, alwaysUseDefaultValue => "true" })}); # Create a conversion action operation. my $conversion_action_operation = Google::Ads::GoogleAds::V15::Services::ConversionActionService::ConversionActionOperation ->new({create => $conversion_action}); # Add the conversion action. my $conversion_actions_response = $api_client->ConversionActionService()->mutate({ customerId => $customer_id, operations => [$conversion_action_operation]}); printf "New conversion action added with resource name: '%s'.\n", $conversion_actions_response->{results}[0]{resourceName}; return 1; }
Verifique se conversion_action_type
está definido com o valor
ConversionActionType
correto.
Para mais orientações sobre como criar ações de conversão na API Google Ads, consulte Criar ações de conversão.
Recuperar uma ação de conversão
Para recuperar detalhes de uma ação de conversão existente, emita a consulta a seguir. Verifique se o ID de cliente na solicitação está definido como o cliente de conversão do Google Ads identificado acima e se o tipo de ação de conversão está definido como o valor ConversionActionType
correto.
SELECT
conversion_action.resource_name,
conversion_action.name,
conversion_action.status
FROM conversion_action
WHERE conversion_action.type = 'INSERT_CONVERSION_ACTION_TYPE'
Acompanhamento de conversões de várias contas
Se você estiver usando o acompanhamento de conversões de várias contas, o ConversionActionService
retornará as seguintes ações de conversão:
- Todas as ações de conversão definidas pela conta de administrador e usadas por ela para o acompanhamento de conversões de várias contas
- Todas as ações de conversão em que o cliente acumulou estatísticas, incluindo ações definidas pelo sistema e aquelas que pertencem ao administrador, mesmo que ele as desvincule posteriormente
- Todas as ações que o cliente definiu na própria conta, incluindo metas do Analytics e transações criadas em perfis vinculados do Google Analytics.
Isso inclui ações não importadas para o Google Ads, que teriam um status
HIDDEN
e só poderiam ser importadas usando a interface da Web do Google Ads.
Você pode configurar e consultar ações de conversão de várias contas usando a API, mas é necessário ativar o acompanhamento de conversões de várias contas pela conta de administrador.