Vamos começar

Ative o acompanhamento de conversões na sua conta do Google Ads para registrar as conversões. Este guia mostra como confirmar se o rastreamento 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 etapas adicionais da sua parte para o acompanhamento. Para mais informações sobre os vários tipos de ações de conversão e os requisitos deles, consulte Categorias de ações de conversão e Criar ações de conversão.

Preparar-se para dar consentimento

Ao importar conversões ou dados do usuário, você precisa confirmar que tem permissão para compartilhar dados de conversão com o Google. Isso pode ser feito de duas maneiras:

1. Defina as configurações de consentimento padrão no nível da conta. Na interface do Google Ads, clique em Ferramentas > Central de dados > Configurações de consentimento > Configurações de consentimento padrão.
2. Defina o campo de consentimento em cada conversão importada ou payload de dados do usuário (por exemplo, ClickConversion.consent, CallConversion.consent ou UserData.consent).

Configurar seu site para acompanhar conversões

Se você estiver acompanhando conversões no site ou implementando conversões otimizadas para leads, configure a inclusão de tag no site primeiro. Siga as etapas em Configurar a tag do Google para conversões otimizadas para leads ou use o Google Tag Manager seguindo as instruções em Configurar o Google Tag Manager para conversões otimizadas para leads.

Ativar o acompanhamento de conversões na sua conta de conversão do Google Ads

Siga estas etapas para verificar a configuração do rastreamento de conversões da sua conta e criar ou recuperar ações de conversão.

Etapas para ativar o rastreamento de conversões

Recuperar informações sobre a configuração do rastreamento 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 o 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 conversões para esse cliente. Para clientes que usam o acompanhamento de conversões entre contas, esse é o ID de uma conta de administrador. O ID de cliente de conversão do Google Ads precisa ser fornecido como o customer_id nas solicitações da API Google Ads para criar e gerenciar conversões. Observação: este campo é preenchido mesmo que o rastreamento de conversões não esteja ativado.

O campo conversion_tracking_status indica se o rastreamento de conversões está ativado e se a conta está usando o rastreamento de conversões entre 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 rastreamento 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, é possível criar uma ação de conversão na interface seguindo as instruções no artigo da Central de Ajuda do Google Ads sobre a configuração do rastreamento de conversões 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 interface do Google Ads.

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());
    }
  }
}
AddConversionAction.java
      

public void Run(GoogleAdsClient client, long customerId)
{
    // Get the ConversionActionService.
    ConversionActionServiceClient conversionActionService =
        client.GetService(Services.V26.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;
    }
}
AddConversionAction.cs
      

    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
            );
        }
    }
AddConversionAction.php
      

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}".'
    )
add_conversion_action.py
      

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
add_conversion_action.rb
      

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

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

Recuperar uma ação de conversão atual

Para recuperar detalhes de uma ação de conversão, 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 que você identificou anteriormente e se o tipo de ação de conversão está definido como o valor correto de ConversionActionType.

SELECT
  conversion_action.id,
  conversion_action.resource_name,
  conversion_action.name,
  conversion_action.type,
  conversion_action.category,
  conversion_action.status
FROM conversion_action

WHERE conversion_action.type = 'INSERT_CONVERSION_ACTION_TYPE'

Acompanhamento de conversões de várias contas

O rastreamento de conversões entre contas permite que as contas do Google Ads importem conversões em nome de outras contas, que podem ter veiculado os anúncios que geraram conversões. Isso pode ajudar a simplificar sua integração, permitindo consolidar as contas que fazem solicitações de importação.

Ativar o rastreamento de conversões entre contas na API Google Ads

Use a API Google Ads para ativar o acompanhamento de conversões cruzadas ao criar ou atualizar contas de cliente.

Em um recurso Customer, defina o campo 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.

As solicitações que modificam o cliente de conversão de uma conta de cliente precisam ser enviadas pela conta de administrador que está se tornando o novo cliente de conversão do cliente. Para isso, defina o login-customer-id como o ID da conta de administrador.

Ao ativar o rastreamento de conversões entre 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 de valor da conversão padrão e as metas do ciclo de vida do cliente padrão do novo administrador de rastreamento 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 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 do gerenciador 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 rastreamento de conversões for especificada, a conta vai usar a si mesma como a conta de rastreamento de conversões por padrão.

Importar conversões em várias contas

Com o acompanhamento entre contas ativado, as contas de cliente e de administrador podem importar conversões em nome da conta de veiculação. Isso simplifica a lógica de importação, já que você não precisa determinar a conta de veiculação de cada conversão no momento da importação. Basta escolher uma conta na árvore para importar todas as conversões.

Para fazer upload de uma conversão, a conta de upload precisa ter acesso à ação de conversão. Em uma hierarquia de acompanhamento entre contas, a conta de upload tem acesso à ação se for uma conta principal (de administrador) ou descendente do proprietário da ação de conversão na árvore de contas.

O diagrama a seguir ilustra a estrutura de autorização para importar conversões. Aqui, C1 é a conta de cliente que veiculou o anúncio que gerou a conversão, M2 é o proprietário da ação de conversão e o pai do rastreamento de conversões de C1. As contas destacadas em verde podem importar conversões em nome de C1, enquanto as contas destacadas em vermelho não podem.

Criar ações de conversão

Para medir conversões, configure uma ConversionAction para a type da ação de conversão que você quer acompanhar. Por exemplo, uma compra on-line e uma ligação 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 para adicionar uma ação de conversão. 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 etapas adicionais da sua parte para o acompanhamento. Por exemplo, para acompanhar as conversões no seu site, você precisa adicionar um snippet de código chamado tag à página de conversão do site. Para requisitos detalhados de outros tipos de ação de conversão, consulte nosso artigo da Central de Ajuda do Google Ads sobre tipos de conversão.

Se você estiver usando o rastreamento de conversões entre contas, o ConversionActionService vai retornar as seguintes ações de conversão:

• Todas as ações de conversão definidas pela conta de admin usada pela conta para o rastreamento de conversões entre 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 definidas pelo cliente na própria conta
• Conversões do Analytics criadas em propriedades vinculadas do Google Analytics. Isso inclui ações de conversões do Analytics não importadas para o Google Ads, que têm o status HIDDEN.

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 category como DEFAULT.

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

• A API Google Ads define o campo primary_for_goal automaticamente, mas você pode defini-lo de forma explícita para controlar como uma ação de conversão afeta os relatórios e os lances na sua conta quando combinada com suas metas de conversão.

• A API Google Ads define o counting_type automaticamente como MANY_PER_CLICK. Consulte Sobre as opções de contabilização de conversões para mais detalhes.

• A API Google Ads define o modelo de atribuição como Baseado em dados ao definir o campo attribution_model_settings como o valor GOOGLE_SEARCH_ATTRIBUTION_DATA_DRIVEN de AttributionModel. Consulte Sobre os modelos de atribuição para saber mais.

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());
    }
  }
}
AddConversionAction.java
      

public void Run(GoogleAdsClient client, long customerId)
{
    // Get the ConversionActionService.
    ConversionActionServiceClient conversionActionService =
        client.GetService(Services.V26.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;
    }
}
AddConversionAction.cs
      

    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
            );
        }
    }
AddConversionAction.php
      

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}".'
    )
add_conversion_action.py
      

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
add_conversion_action.rb
      

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

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

Confira 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.

Referência do campo ConversionActionService.MutateConversionActions

Use MutateConversionActions em ConversionActionService para criar, atualizar ou remover ações de conversão no cliente de conversão do Google Ads:

POST https://googleads.googleapis.com/v26/customers/{customer_id}/conversionActions:mutate

A tabela a seguir lista os campos de solicitação e operação de nível superior em MutateConversionActionsRequest:

Ao configurar um ConversionAction em operations[].create ou operations[].update, observe os seguintes requisitos de campo e restrições de mutabilidade. Consulte Validações para regras de erro específicas do tipo:

Estrutura de solicitação e resposta REST

Para criar ou atualizar um ConversionAction por REST, envie uma solicitação POST para ConversionActionService.MutateConversionActions. Ao atualizar uma ação de conversão, especifique updateMask no objeto de operação como um irmão de update:

POST https://googleads.googleapis.com/v26/customers/{customer_id}/conversionActions:mutate

{
  "operations": [
    {
      "create": {
        "name": "Earth to Mars Cruise Conversion",
        "type": "UPLOAD_CLICKS",
        "category": "DEFAULT",
        "status": "ENABLED",
        "primaryForGoal": true,
        "countingType": "ONE_PER_CLICK",
        "clickThroughLookbackWindowDays": "60",
        "valueSettings": {
          "defaultValue": 23.41,
          "defaultCurrencyCode": "USD",
          "alwaysUseDefaultValue": true
        }
      }
    },
    {
      "updateMask": "primary_for_goal,value_settings.default_value",
      "update": {
        "resourceName": "customers/{customer_id}/conversionActions/6666666666",
        "primaryForGoal": false,
        "valueSettings": {
          "defaultValue": 45.00
        }
      }
    }
  ]
}

Uma resposta bem-sucedida retorna entradas MutateConversionActionResult em results[]:

{
  "results": [
    {
      "resourceName": "customers/{customer_id}/conversionActions/7777777777"
    },
    {
      "resourceName": "customers/{customer_id}/conversionActions/6666666666"
    }
  ]
}

Inspecionar configurações de ação de conversão e snippets de tag com GAQL

Além da consulta básica mostrada em Etapas para ativar o acompanhamento de conversões, é possível consultar o recurso conversion_action usando GoogleAdsService.SearchStream para inspecionar primary_for_goal, o status do modelo de atribuição, as janelas de lookback, as configurações de valor e o tag_snippets do site:

SELECT
  conversion_action.id,
  conversion_action.resource_name,
  conversion_action.name,
  conversion_action.type,
  conversion_action.category,
  conversion_action.status,
  conversion_action.primary_for_goal,
  conversion_action.counting_type,
  conversion_action.click_through_lookback_window_days,
  conversion_action.view_through_lookback_window_days,
  conversion_action.value_settings.default_value,
  conversion_action.value_settings.default_currency_code,
  conversion_action.value_settings.always_use_default_value,
  conversion_action.attribution_model_settings.attribution_model,
  conversion_action.attribution_model_settings.data_driven_model_status,
  conversion_action.tag_snippets
FROM conversion_action
WHERE conversion_action.status = 'ENABLED'

Validações

O Google Ads e a API Google Ads são compatíveis com 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.

De longe, 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 tipo enumerado 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 só aceita GOOGLE_ADS_LAST_CLICK e GOOGLE_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 ou RangeError.TOO_HIGH.

Esse atributo precisa ser de 1 a 60 dias 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 é de 1 a 90 dias.

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 seja para chamadas, vai receber 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 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 é de 1 a 30 dias.

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.