Vamos começar

É 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, 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 etapas adicionais da sua parte para serem acompanhadas. Para mais informações sobre os vários tipos de ações de conversão e os requisitos delas, consulte o guia de criação de ações de conversão.

Configurar seu site para acompanhar conversões

Se você estiver começando a integração de importação de conversões off-line, a primeira etapa é seguir as instruções do guia Configurar a tag do Google para conversões otimizadas para leads e configurar seu site para acompanhar essas conversões. 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 sua configuração de 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. Emita 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 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.

Crie 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 da Central de Ajuda para o tipo de conversão que quer ativar.

As conversões otimizadas são ativadas automaticamente quando enviadas pela API Google Ads, mas podem ser desativadas na 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.V20.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::V20::Resources::ConversionAction->new({
      name                          => $conversion_action_name,
      category                      => DEFAULT,
      type                          => WEBPAGE,
      status                        => ENABLED,
      viewThroughLookbackWindowDays => 15,
      valueSettings                 =>
        Google::Ads::GoogleAds::V20::Resources::ValueSettings->new({
          defaultValue          => 23.41,
          alwaysUseDefaultValue => "true"
        })});

  # Create a conversion action operation.
  my $conversion_action_operation =
    Google::Ads::GoogleAds::V20::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 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 atual

Para recuperar detalhes de uma ação de conversão, execute a seguinte consulta. 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 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 gerente, mesmo que ele desvincule a conta depois.
  • Todas as ações definidas pelo cliente na própria conta
  • Conversões do Analytics criadas em propriedades vinculadas do Google Analytics. Isso inclui ações de conversão do Analytics que não foram importadas para o Google Ads e têm o status HIDDEN.

A partir de v19.1, você poderá 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.

A partir de v20, você poderá 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, você pode ativar o acompanhamento de conversões de várias contas definindo o campo conversion_tracking_setting.google_ads_conversion_customer. Esse campo precisa ser definido 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 update para a conta de cliente.

Ao ativar o acompanhamento de conversões de várias contas ou mudar o gerente de acompanhamento de conversões de uma conta de cliente, as mesmas restrições se aplicam como se você fizesse essa mudança na interface. Especificamente:

  • A conta de cliente vai adotar as regras padrão do valor da conversão e as metas padrão de ciclo de vida do cliente do novo gerente de acompanhamento de conversões.
  • As campanhas que segmentam uma ação de conversão específica vão passar a usar as metas de conversão padrão da conta do gerente 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 gerente pode não ter as mesmas metas da conta de cliente. Verifique se as campanhas estão otimizadas para as metas certas.
  • 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 mostra como criar um ConversionAction.

A maioria das ações de conversão também exige etapas adicionais da sua parte para serem acompanhadas. 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 a seguir mostra o 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 o category como DEFAULT.

As seguintes configurações padrão são aplicadas:

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.V20.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::V20::Resources::ConversionAction->new({
      name                          => $conversion_action_name,
      category                      => DEFAULT,
      type                          => WEBPAGE,
      status                        => ENABLED,
      viewThroughLookbackWindowDays => 15,
      valueSettings                 =>
        Google::Ads::GoogleAds::V20::Resources::ValueSettings->new({
          defaultValue          => 23.41,
          alwaysUseDefaultValue => "true"
        })});

  # Create a conversion action operation.
  my $conversion_action_operation =
    Google::Ads::GoogleAds::V20::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;
}
      

Você pode ver esse exemplo na pasta "Remarketing" da sua biblioteca de cliente e na coleção de exemplos de código: Exemplo de código para adicionar uma 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. Por isso, algumas regras de validação variam de acordo com o 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 enumeração
A tentativa de definir qualquer campo de enumeração como UNKNOWN resulta em um erro RequestError.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 isso como uma opção descontinuada resulta em um erro CANNOT_SET_RULE_BASED_ATTRIBUTION_MODELS. O Google Ads é compatível apenas com GOOGLE_ADS_LAST_CLICK e GOOGLE_SEARCH_ATTRIBUTION_DATA_DRIVEN.
click_through_lookback_window_days

Definir esse atributo com um valor fora do intervalo permitido resulta em um erro RangeError.TOO_LOW ou RangeError.TOO_HIGH.

Esse atributo precisa estar no intervalo [1,60] para uma ação de conversão AD_CALL ou WEBSITE_CALL. Para a maioria das outras ações de conversão, o intervalo permitido é [1,30].

include_in_conversions_metric

Definir esse valor em uma operação create ou update falha com um erro FieldError.IMMUTABLE_FIELD. Em vez disso, defina primary_for_goal conforme descrito no guia de metas de conversão.

phone_call_duration_seconds

Se você tentar definir esse atributo em uma ação de conversão que não é para chamadas, vai ocorrer 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 a UNKNOWN resulta em um erro MutateError.MUTATE_NOT_ALLOWED.

value_settings

O value_settings de uma ação de conversão de WEBSITE_CALL ou AD_CALL precisa ter always_use_default_value definido como true. Especificar um valor de false ao criar ou atualizar esse valor resulta em um erro INVALID_VALUE.

view_through_lookback_window_days

Definir esse atributo com um valor fora do intervalo permitido resulta em um erro RangeError.TOO_LOW ou RangeError.TOO_HIGH. Para a maioria das ações de conversão, o intervalo permitido é [1,30].

Não é possível definir esse atributo em ações de conversão AD_CALL ou WEBSITE_CALL. Especificar um valor resulta em um erro VALUE_MUST_BE_UNSET.