É necessário ativar o acompanhamento de conversões na sua conta de conversão do Google Ads para registrar conversões. Este guia mostra como confirmar se o acompanhamento de conversões está ativado, como ativá-lo se ainda não estiver e como recuperar informações sobre as ações de conversão atuais.
A maioria das ações de conversão também exige outras etapas da sua parte para serem acompanhadas. Para mais informações sobre os vários tipos de ação de conversão e os requisitos deles, consulte o guia Criar ações de conversão.
Preparar-se para dar consentimento
É fundamental confirmar que você tem permissão para compartilhar dados de conversão com o Google. Isso pode ser feito de duas maneiras:
- Configure as configurações de consentimento padrão no nível da conta. Na interface do Google Ads, clique em Ferramentas -> Gerenciador de dados -> Configurações de consentimento -> Configurações de consentimento padrão.
- Defina o campo ClickConversion.consent em cada conversão importada.
Configurar seu site para acompanhar conversões
Se você estiver começando a integração da importação de conversões off-line, a primeira etapa é seguir as etapas do guia Configurar a tag do Google para conversões otimizadas para leads para configurar seu site para acompanhar conversões otimizadas para leads. Você também pode usar o Gerenciador de tags do Google para configurar seu site seguindo as etapas do guia Configurar o Gerenciador de tags do Google para conversões otimizadas para leads.
Ativar o acompanhamento de conversões na sua conta de conversão 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 o acompanhamento de conversões está ativado, consulte o Customer recurso
para o ConversionTrackingSetting.
Faça a consulta a seguir 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 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.
Observação: este campo é preenchido mesmo que o acompanhamento de conversões não esteja 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 uma 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.
Observe que 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.V24.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: GoogleAdsClient, customer_id: str) -> None: conversion_action_service: ConversionActionServiceClient = ( client.get_service("ConversionActionService") ) # Create the operation. conversion_action_operation: ConversionActionOperation = client.get_type( "ConversionActionOperation" ) # Create conversion action. conversion_action: ConversionAction = 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: ConversionAction.ValueSettings = ( conversion_action.value_settings ) value_settings.default_value = 15.0 value_settings.always_use_default_value = True # Add the conversion action. conversion_action_response: MutateConversionActionsResponse = ( 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::V24::Resources::ConversionAction->new({ name => $conversion_action_name, category => DEFAULT, type => WEBPAGE, status => ENABLED, viewThroughLookbackWindowDays => 15, valueSettings => Google::Ads::GoogleAds::V24::Resources::ValueSettings->new({ defaultValue => 23.41, alwaysUseDefaultValue => "true" })}); # Create a conversion action operation. my $conversion_action_operation = Google::Ads::GoogleAds::V24::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; }
curl
Verifique se o conversion_action_type está definido como o valor correto
ConversionActionType.
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 atual
Para recuperar detalhes de uma ação de conversão atual, faça a consulta a seguir. 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
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 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 de propriedade do administrador, mesmo que ele desvincule posteriormente
- Todas as ações que o cliente definiu na própria conta
- Conversões do Analytics criadas em propriedades vinculadas do Google Analytics.
Isso inclui ações para conversões do Analytics não importadas para o Google Ads,
que têm o status
HIDDEN.
Você pode usar a API Google Ads para ativar o acompanhamento de conversões cruzadas ao criar contas de cliente.
Ao criar um novo Customer, defina
conversion_tracking_setting.google_ads_conversion_customer
como o
nome do recurso da conta de administrador
que deve 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.
Você pode usar a API Google Ads para ativar o acompanhamento de conversões cruzadas ao criar e atualizar contas de cliente.
Ao atualizar uma conta de cliente atual, você pode ativar o acompanhamento de conversões de várias contas definindo o
conversion_tracking_setting.google_ads_conversion_customer
campo. Esse campo precisa ser definido como o
nome do recurso da conta de administrador
que deve 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 update para a conta de cliente.
OBSERVAÇÃO: o uso da API Google Ads para modificar as configurações de acompanhamento de conversões de várias contas de uma conta de cliente é um recurso apenas da lista de permissões. Para isso, entre em contato com o gerente de contas.
Ao ativar o acompanhamento de conversões de várias contas ou mudar o gerenciador de acompanhamento de conversões de uma conta de cliente atual, as mesmas advertências se aplicam como se você fosse fazer essa mudança na interface. Especificamente:
- A conta de cliente vai adotar as regras de valor de conversão padrão e as metas do ciclo de vida do cliente padrão do novo gerenciador de acompanhamento de conversões.
- As campanhas que segmentam uma ação de conversão específica vão usar as metas de conversão padrão da conta do gerenciador de conversões. Se você continuar segmentando uma ação de conversão específica, isso poderá gerar um comportamento inconsistente, já que a conta de administrador talvez não tenha as mesmas metas da conta de cliente. Verifique se as campanhas estão otimizadas para as metas certas.
- Além disso, se uma conta pertence a mais de uma conta de administrador, ela só pode usar ações de conversão de um administrador. Se nenhuma conta de acompanhamento de conversões for especificada, a conta vai usar a si mesma como a conta de acompanhamento de conversões por padrão.
Criar ações de conversão
Para medir conversões, configure um
ConversionAction para o
type de
ação de conversão que você quer acompanhar. Por exemplo, uma compra on-line e uma ligação 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 Adicionar ação de conversão abaixo. O exemplo processa
todas as tarefas de autenticação em segundo plano para você e orienta a criação
de um ConversionAction.
A maioria das ações de conversão também exige outras etapas da sua parte para serem acompanhadas. Por exemplo, para acompanhar conversões no seu site, você precisa adicionar um snippet de código chamado tag à página de conversão do seu site. 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 a seguir 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.
Ele também define a category
como DEFAULT.
As seguintes configurações padrão são aplicadas:
A API Google Ads define o
primary_for_goalcampo automaticamente, mas você pode definir esse campo explicitamente para controlar como uma ação de conversão afeta os relatórios e os lances na sua conta quando combinada com as metas de conversão.A API Google Ads define o
counting_typeautomaticamente comoMANY_PER_CLICKConsulte Sobre as opções de contagem de conversões para mais detalhes.A API Google Ads define o modelo de atribuição como Baseado em dados por definir o
attribution_model_settingscampo para oGOOGLE_SEARCH_ATTRIBUTION_DATA_DRIVENvalor deAttributionModel. Para saber mais sobre modelos de atribuição, acesse este artigo da Central de Ajuda.
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.V24.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: GoogleAdsClient, customer_id: str) -> None: conversion_action_service: ConversionActionServiceClient = ( client.get_service("ConversionActionService") ) # Create the operation. conversion_action_operation: ConversionActionOperation = client.get_type( "ConversionActionOperation" ) # Create conversion action. conversion_action: ConversionAction = 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: ConversionAction.ValueSettings = ( conversion_action.value_settings ) value_settings.default_value = 15.0 value_settings.always_use_default_value = True # Add the conversion action. conversion_action_response: MutateConversionActionsResponse = ( 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::V24::Resources::ConversionAction->new({ name => $conversion_action_name, category => DEFAULT, type => WEBPAGE, status => ENABLED, viewThroughLookbackWindowDays => 15, valueSettings => Google::Ads::GoogleAds::V24::Resources::ValueSettings->new({ defaultValue => 23.41, alwaysUseDefaultValue => "true" })}); # Create a conversion action operation. my $conversion_action_operation = Google::Ads::GoogleAds::V24::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; }
curl
Você pode conferir esse exemplo na pasta Remarketing da sua biblioteca de cliente e na coleção de exemplos de código: exemplo de código Adicionar ação de conversão exemplo.
Validações
O Google Ads e a API Google Ads oferecem suporte a uma grande variedade de ações de conversão. Por isso, 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.
Verifique se você está usando um nome exclusivo para cada ação de conversão.
Confira algumas dicas para definir os campos ConversionAction:
- Todos os campos de enumeração
- A tentativa de definir qualquer campo de enumeração como
UNKNOWNresulta 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- A definição dessa opção como uma opção descontinuada
resulta em um
CANNOT_SET_RULE_BASED_ATTRIBUTION_MODELSerro. O Google Ads só oferece suporte aGOOGLE_ADS_LAST_CLICKeGOOGLE_SEARCH_ATTRIBUTION_DATA_DRIVEN. click_through_lookback_window_daysA definição desse atributo como um valor fora do intervalo permitido resulta em um erro
RangeError.TOO_LOWouRangeError.TOO_HIGH.Esse atributo precisa estar no intervalo
[1,60]para uma ação de conversãoAD_CALLouWEBSITE_CALL. Para a maioria das outras ações de conversão, o intervalo permitido é[1,30].include_in_conversions_metricA definição desse valor em uma operação
createouupdatefalha com um erroFieldError.IMMUTABLE_FIELD. Em vez disso, definaprimary_for_goalconforme descrito no guia Metas de conversão.phone_call_duration_secondsA tentativa de definir esse atributo em uma ação de conversão que não é para chamadas resulta em um erro
FieldError.VALUE_MUST_BE_UNSET.typeO atributo
typeé imutável e só pode ser definido ao criar uma nova conversão.A atualização de uma ação de conversão com
typeigual aUNKNOWNresulta em um erroMutateError.MUTATE_NOT_ALLOWED.value_settingsAs
value_settingspara uma ação de conversãoWEBSITE_CALLouAD_CALLprecisam teralways_use_default_valuedefinido comotrue. A especificação de um valor defalseao criar ou atualizar esse valor resulta em um erroINVALID_VALUE.view_through_lookback_window_daysA definição desse atributo como um valor fora do intervalo permitido resulta em um erro
RangeError.TOO_LOWouRangeError.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_CALLouWEBSITE_CALL. A especificação de um valor resulta em um erroVALUE_MUST_BE_UNSET.