É necessário ativar o acompanhamento de conversões na sua conta de conversão do Google Ads para registrar conversões. Este guia fornece detalhes sobre como confirmar se o acompanhamento de conversões está ativado, ativar se não estiver e recuperar informações sobre as ações de conversão atuais.
A maioria das ações de conversão também exige outras etapas para que você as acompanhe. Para mais informações sobre os vários tipos de ações de conversão e os requisitos, consulte o guia Criar ações de conversão.
Configurar o site para acompanhar conversões
Se você estiver iniciando a integração da importação de conversões off-line, a primeira etapa é seguir as etapas no guia Configurar a tag do Google para conversões otimizadas para leads para configurar seu site para acompanhar conversões otimizadas para leads. Também é possível usar o Gerenciador de tags do Google para configurar seu site seguindo as etapas no guia Configurar o Gerenciador de tags do Google para conversões otimizadas para leads.
Ative o acompanhamento de conversões na sua conta de conversão do Google Ads
Extrair informações sobre a configuração do acompanhamento de conversões
Você pode verificar a configuração do acompanhamento de conversões da sua conta e confirmar se o acompanhamento de conversões está ativado, consultando o recurso Customer
para ConversionTrackingSetting
.
Faça a seguinte consulta 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 as conversões desse cliente. Para clientes que usam o acompanhamento de conversões de várias contas, esse é o ID de uma conta de administrador. O ID do 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 estará ativado para a conta. Ative o acompanhamento de conversões
criando 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 interface 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 pela interface do Google Ads.
Exemplo de código
Java
private void runExample(GoogleAdsClient googleAdsClient, long customerId) { // Creates a ConversionAction. ConversionAction conversionAction = ConversionAction.newBuilder() // Note that conversion action names must be unique. If a conversion action already // exists with the specified conversion_action_name the create operation will fail with // a ConversionActionError.DUPLICATE_NAME error. .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.V19.ConversionActionService); // Note that conversion action names must be unique. // If a conversion action already exists with the specified name the create operation // will fail with a ConversionAction.DUPLICATE_NAME error. string ConversionActionName = "Earth to Mars Cruises Conversion #" + ExampleUtilities.GetRandomString(); // Add a conversion action. ConversionAction conversionAction = new ConversionAction() { Name = ConversionActionName, 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([ // Note that conversion action names must be unique. // If a conversion action already exists with the specified conversion_action_name // the create operation will fail with a ConversionActionError.DUPLICATE_NAME error. '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 # Note that conversion action names must be unique. If a conversion action # already exists with the specified conversion_action_name, the create # operation will fail with a ConversionActionError.DUPLICATE_NAME error. 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) = @_; # Note that conversion action names must be unique. # If a conversion action already exists with the specified conversion_action_name, # the create operation fails with error ConversionActionError.DUPLICATE_NAME. my $conversion_action_name = "Earth to Mars Cruises Conversion #" . uniqid(); # Create a conversion action. my $conversion_action = Google::Ads::GoogleAds::V19::Resources::ConversionAction->new({ name => $conversion_action_name, category => DEFAULT, type => WEBPAGE, status => ENABLED, viewThroughLookbackWindowDays => 15, valueSettings => Google::Ads::GoogleAds::V19::Resources::ValueSettings->new({ defaultValue => 23.41, alwaysUseDefaultValue => "true" })}); # Create a conversion action operation. my $conversion_action_operation = Google::Ads::GoogleAds::V19::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; }
Confira se o conversion_action_type
está definido com o valor
correto de ConversionActionType
.
Para mais orientações sobre como criar ações de conversão na API Google Ads, consulte Criar ações de conversão.
Extrair uma ação de conversão
Para extrair detalhes de uma ação de conversão, emita a seguinte consulta. Verifique se o ID do 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 correto de ConversionActionType
.
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
vai retornar as seguintes ações de conversão:
- Todas as ações de conversão definidas pela conta de administrador usada pela conta 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 ações pertencentes ao administrador, mesmo que ele desvincule posteriormente
- Todas as ações que o cliente definiu na própria conta
- Conversões do Google Analytics criadas em propriedades vinculadas do Google Analytics.
Isso inclui ações para conversões do Google Analytics não importadas para o Google Ads,
que têm o status de
HIDDEN
.
A partir da versão v19.1
, é possível usar a
API Google Ads para ativar o acompanhamento de conversões cruzadas ao criar contas de cliente.
Ao criar um novo Customer
, defina o
conversion_tracking_setting.google_ads_conversion_customer
como o nome do recurso da conta de administrador que vai gerenciar as ações de conversão
em nome da conta de cliente. Essa conta de administrador também precisa ser a
conta que emite a solicitação create
para a nova conta de cliente.
Para ativar o acompanhamento de conversões cruzadas em contas de clientes existentes, use a interface do Google Ads seguindo estas instruções.
Criar ações de conversão
Para medir as conversões, configure um
ConversionAction
para o
type
da
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 melhor maneira de configurar novas ações de conversão na API é usar o
exemplo de código abaixo para adicionar uma ação de conversão. O exemplo processa
todas as tarefas de autenticação em segundo plano e orienta você na criação
de um ConversionAction
.
A maioria das ações de conversão também exige outras etapas para que você as acompanhe. Por exemplo, para acompanhar conversões no seu site, adicione um snippet de código chamado tag à página de conversão. Para requisitos detalhados de outros tipos de ação de conversão, consulte nosso artigo da Central de Ajuda.
Exemplo de código
O exemplo de código abaixo orienta você no processo de criação de uma nova ação de conversão. Especificamente, ele cria uma ação de conversão com o
type
definido como
UPLOAD_CLICKS
.
Esse é o mesmo fluxo da interface do Google Ads usado para criar uma nova ação de conversão usando
Importação > Importação manual usando a API ou uploads > Acompanhar conversões de
cliques. Ele também define a category
como DEFAULT
.
As configurações padrão a seguir são aplicadas:
A API Google Ads define o campo
primary_for_goal
automaticamente, mas você pode definir esse campo explicitamente para controlar como uma ação de conversão afeta os relatórios e lances na sua conta quando combinada com suas metas de conversão.A API Google Ads define o
counting_type
automaticamente paraMANY_PER_CLICK
. Consulte Sobre as opções de contagem de conversões para mais detalhes.A API Google Ads define o modelo de atribuição como orientado a dados definindo o campo
attribution_model_settings
como o valorGOOGLE_SEARCH_ATTRIBUTION_DATA_DRIVEN
deAttributionModel
. Consulte este artigo da Central de Ajuda para saber mais sobre os modelos de atribuição.
Java
private void runExample(GoogleAdsClient googleAdsClient, long customerId) { // Creates a ConversionAction. ConversionAction conversionAction = ConversionAction.newBuilder() // Note that conversion action names must be unique. If a conversion action already // exists with the specified conversion_action_name the create operation will fail with // a ConversionActionError.DUPLICATE_NAME error. .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.V19.ConversionActionService); // Note that conversion action names must be unique. // If a conversion action already exists with the specified name the create operation // will fail with a ConversionAction.DUPLICATE_NAME error. string ConversionActionName = "Earth to Mars Cruises Conversion #" + ExampleUtilities.GetRandomString(); // Add a conversion action. ConversionAction conversionAction = new ConversionAction() { Name = ConversionActionName, 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([ // Note that conversion action names must be unique. // If a conversion action already exists with the specified conversion_action_name // the create operation will fail with a ConversionActionError.DUPLICATE_NAME error. '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 # Note that conversion action names must be unique. If a conversion action # already exists with the specified conversion_action_name, the create # operation will fail with a ConversionActionError.DUPLICATE_NAME error. 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) = @_; # Note that conversion action names must be unique. # If a conversion action already exists with the specified conversion_action_name, # the create operation fails with error ConversionActionError.DUPLICATE_NAME. my $conversion_action_name = "Earth to Mars Cruises Conversion #" . uniqid(); # Create a conversion action. my $conversion_action = Google::Ads::GoogleAds::V19::Resources::ConversionAction->new({ name => $conversion_action_name, category => DEFAULT, type => WEBPAGE, status => ENABLED, viewThroughLookbackWindowDays => 15, valueSettings => Google::Ads::GoogleAds::V19::Resources::ValueSettings->new({ defaultValue => 23.41, alwaysUseDefaultValue => "true" })}); # Create a conversion action operation. my $conversion_action_operation = Google::Ads::GoogleAds::V19::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; }
Esse exemplo também pode ser encontrado na pasta "Remarketing" da biblioteca de cliente e na coleção de exemplos de código: Adicionar exemplo de código de ação de conversão.
Validações
O Google Ads e a API Google Ads oferecem suporte a uma grande variedade de ações de conversão. Portanto, algumas regras de validação variam com base no type
da ação.
O erro mais comum ao criar uma ação de conversão é
DUPLICATE_NAME
.
Use um nome exclusivo para cada ação de conversão.
Confira algumas dicas para definir os campos ConversionAction
:
- Todos os campos de tipo enumerado
- Tentar definir qualquer campo de tipo enumerado como
UNKNOWN
resulta em um erroRequestError.INVALID_ENUM_VALUE
. app_id
- O atributo
app_id
é imutável e só pode ser definido ao criar uma nova conversão de app. attribution_model_settings
- Definir esse valor como uma opção
descontinuada
resulta em um
erro
CANNOT_SET_RULE_BASED_ATTRIBUTION_MODELS
. O Google Ads oferece suporte apenas aGOOGLE_ADS_LAST_CLICK
eGOOGLE_SEARCH_ATTRIBUTION_DATA_DRIVEN
. click_through_lookback_window_days
Definir esse atributo como um valor fora do intervalo permitido resulta em um erro
RangeError.TOO_LOW
ouRangeError.TOO_HIGH
.Esse atributo precisa estar no intervalo
[1,60]
para uma ação de conversãoAD_CALL
ouWEBSITE_CALL
. Para a maioria das outras ações de conversão, o intervalo permitido é[1,30]
.include_in_conversions_metric
A definição desse valor em uma operação
create
ouupdate
falha com um erroFieldError.IMMUTABLE_FIELD
. Em vez disso, definaprimary_for_goal
conforme descrito no guia de metas de conversão.phone_call_duration_seconds
Tentar definir esse atributo em uma ação de conversão que não é para chamadas resulta em um erro
FieldError.VALUE_MUST_BE_UNSET
.type
O atributo
type
é imutável e só pode ser definido ao criar uma nova conversão.Atualizar uma ação de conversão com
type
igual aUNKNOWN
resulta em um erroMutateError.MUTATE_NOT_ALLOWED
.value_settings
O
value_settings
de uma ação de conversãoWEBSITE_CALL
ouAD_CALL
precisa teralways_use_default_value
definido comotrue
. Especificar um valor defalse
ao criar ou atualizar esse valor resulta em um erroINVALID_VALUE
.view_through_lookback_window_days
Definir esse atributo como um valor fora do intervalo permitido resulta em um erro
RangeError.TOO_LOW
ouRangeError.TOO_HIGH
. Para a maioria das ações de conversão, o intervalo permitido é[1,30]
.Esse atributo não pode ser definido em ações de conversão
AD_CALL
ouWEBSITE_CALL
. Especificar um valor resulta em um erroVALUE_MUST_BE_UNSET
.