Conversões

Considera-se uma conversão no Google Ads quando um usuário executa alguma ação específica depois de visualizar ou clicar em um anúncio da Rede de Display. Compra de produtos, instalação de aplicativos para dispositivos móveis e inscrição em listas de e-mail são exemplos dessas ações.

O acompanhamento de conversões fornece insights importantes sobre as ações dos usuários depois que visualizam ou clicam em um anúncio. Você pode acompanhar usuários que fazem chamadas, compram produtos, instalam aplicativos para dispositivos móveis e muito mais.

Ações de conversão

Para medir as conversões, configure um ConversionAction para o tipo de ação de conversão que você quer acompanhar. Por exemplo, uma compra on-line e uma chamada telefônica exigem ações de conversão diferentes.

A maioria das ações de conversão também exige etapas adicionais para o acompanhamento. Por exemplo, para acompanhar conversões no seu site, você precisa criar um ConversionAction com o ConversionActionType definido como WEBPAGE e adicionar um snippet de código chamado tag à página de conversão no seu site.

Conversões off-line e otimizadas para leads

Use os tipos de ação de conversão off-line para uploads de conversão.

Conversões otimizadas para Web

Com as conversões otimizadas para a Web, você pode enviar dados de conversão próprios para ações de conversão de WEBPAGE em até 24 horas após um evento de conversão, e não ao mesmo tempo. Isso permite localizar dados próprios de várias fontes, como um banco de dados de clientes ou um sistema de CRM.

Conversões de chamadas telefônicas

Uma ação de conversão AD_CALL aparece como uma conversão de Chamadas a partir de anúncios na interface da Web do Google Ads. Depois de criar sua ação de conversão AD_CALL, especifique o nome do recurso no campo call_conversion_action ao criar uma CallAsset.

Uma chamada é considerada como conversão quando ultrapassa a duração especificada. O padrão é 60 segundos.

Conversões de chamada do site

Uma ação de conversão WEBSITE_CALL aparece como uma conversão Chamadas de um site na interface da Web do Google Ads.

Ao contrário do AD_CALL, esse rastreador requer a adição de event_snippet e global_site_tag ao seu site para recuperar o número dinâmico de encaminhamento de chamadas do Google para o acompanhamento de chamadas dos números listados no seu site. Além disso, você precisa configurar um recurso de ligação e vinculá-lo no nível do cliente, da campanha ou do grupo de anúncios.

Conversões no site

O ConversionAction abrange vários tipos de conversões no site, diferenciados na API pelo campo type em TagSnippet.

A tabela a seguir mostra os parâmetros de API equivalentes a serem usados em cada Origem na interface da Web do Google Ads:

Tipo de código de acompanhamento Origem do Google Ads
WEBPAGE Site, site (Google Analytics (GA4))
WEBPAGE_ONCLICK Site, site (Google Analytics (GA4))
CLICK_TO_CALL Cliques no número de telefone
--- Site (Google Analytics (UA))

As conversões de cliques no site e cliques no número de telefone exigem o event_snippet, que precisa ser inserido em páginas da Web que indicam uma ação de conversão, como uma página de confirmação de finalização de compra ou de envio de lead, e global_site_tag, que precisa ser instalado em todas as páginas do seu site. É possível extrair esses dois atributos com ConversionActionService.

O tipo CLICK_TO_CALL é diferente do tipo AD_CALL porque não rastreia chamadas telefônicas reais. O CLICK_TO_CALL só acompanha cliques em um número de telefone provenientes de dispositivos móveis. Isso é útil quando você não consegue usar um número de encaminhamento de chamadas do Google para acompanhar chamadas telefônicas.

Conversões de apps

ConversionActionType abrange instalações de apps para dispositivos móveis e ações no app Android. A tabela a seguir mostra os parâmetros de API equivalentes a serem usados em cada Origem na interface da Web do Google Ads:

Tipo de ação de conversão Origem do Google Ads
GOOGLE_PLAY_DOWNLOAD Instalação de app Android (primeiro acesso)
GOOGLE_PLAY_IN_APP_PURCHASE Ação no app Android

Conversões da SKAdNetwork

Se você veicular campanhas para apps iOS e tiver implementado a SKAdNetwork, poderá acessar os dados da SKAdNetwork fornecidos ao Google nos níveis Customer e Campaign usando os seguintes recursos:

Campo do relatório Descrição
metrics.sk_ad_network_conversions O número de conversões informado pela Apple. Essa métrica só pode ser segmentada por qualquer combinação de segments.sk_ad_network_conversion_value e segmentos relacionados a datas.
segments.sk_ad_network_conversion_value

O valor de uma conversão informado pela Apple. Esse segmento não pode ser aplicado a nenhuma métrica diferente de metrics.sk_ad_network_conversions e só pode ser combinado com segmentos relacionados a data.

Um valor de 0 vai ser retornado se a Apple informar um valor de 0 e nenhum outro. Verifique a presença do campo para diferenciar os dois casos.

Também é possível salvar um mapeamento de valor da conversão da SKAdNetwork para clientes vinculados específicos com apps iOS usando CustomerSkAdNetworkConversionValueSchema.

Exemplo de código Python

#!/usr/bin/env python
# Copyright 2019 Google LLC
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
#     https://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.

import argparse
import sys

from google.ads.googleads.client import GoogleAdsClient
from google.ads.googleads.errors import GoogleAdsException


def main(client, customer_id):
    """Adds a keyword plan, campaign, ad group, etc. to the customer account.

    Also handles errors from the API and prints them.

    Args:
        client: An initialized instance of GoogleAdsClient
        customer_id: A str of the customer_id to use in requests.
    """

    res = update_skan_cv_schema(
        client, customer_id, "my_app_id", "account_link_id"
    )
    print(res)


def update_skan_cv_schema(client, customer_id, app_id, account_link_id):
    skan_service = client.get_service(
        "CustomerSkAdNetworkConversionValueSchemaService"
    )

    req = client.get_type(
        "MutateCustomerSkAdNetworkConversionValueSchemaRequest"
    )
    operation = client.get_type(
        "CustomerSkAdNetworkConversionValueSchemaOperation"
    )
    schema_instance = client.get_type(
        "CustomerSkAdNetworkConversionValueSchema"
    )

    new_schema = operation.update
    new_schema.resource_name = (
        skan_service.customer_sk_ad_network_conversion_value_schema_path(
            "customer_id", "account_link_id"
        )
    )
    new_schema.schema.app_id = app_id
    new_schema.schema.measurement_window_hours = 48

    skan_cv_mapping = (
        schema_instance.SkAdNetworkConversionValueSchema.FineGrainedConversionValueMappings()
    )
    skan_cv_mapping.fine_grained_conversion_value = 0  # 0 - 63
    skan_cv_mapping.conversion_value_mapping.min_time_post_install_hours = 0
    skan_cv_mapping.conversion_value_mapping.max_time_post_install_hours = 48

    skan_cv_event = schema_instance.SkAdNetworkConversionValueSchema.Event()
    skan_cv_event.mapped_event_name = "TEST"
    skan_cv_event.event_revenue_value = 10

    skan_cv_mapping.conversion_value_mapping.mapped_events.append(skan_cv_event)
    new_schema.schema.fine_grained_conversion_value_mappings.append(
        skan_cv_mapping
    )

    req.operation = operation
    req.customer_id = customer_id

    res = skan_service.mutate_customer_sk_ad_network_conversion_value_schema(
        req
    )
    return res


if __name__ == "__main__":
    # GoogleAdsClient will read the google-ads.yaml configuration file in the
    # home directory if none is specified.
    googleads_client = GoogleAdsClient.load_from_storage(
        version="v15"
    )

    parser = argparse.ArgumentParser(
        description="Creates a keyword plan for specified customer."
    )
    # The following argument(s) should be provided to run the example.
    parser.add_argument(
        "-c",
        "--customer_id",
        type=str,
        required=True,
        help="The Google Ads customer ID.",
    )
    args = parser.parse_args()

    try:
        main(googleads_client, args.customer_id)
    except GoogleAdsException as ex:
        print(
            f'Request with ID "{ex.request_id}" failed with status '
            f'"{ex.error.code().name}" and includes the following errors:'
        )
        for error in ex.failure.errors:
            print(f'\tError with message "{error.message}".')
            if error.location:
                for field_path_element in error.location.field_path_elements:
                    print(f"\t\tOn field: {field_path_element.field_name}")
        sys.exit(1)
  

Outros tipos de conversão

Existem vários tipos de ações de conversão que não podem ser criados com a API Google Ads. No entanto, é possível recuperar as métricas de performance em relatórios e, em alguns casos, modificar alguns atributos.

Metas de conversão

As metas de conversão ajudam a organizar as ações de conversão para otimizar com mais facilidade seus objetivos publicitários. Confira o guia de metas para mais informações.

Regras do valor da conversão

Com as regras do valor da conversão, você pode definir regras para ajustar os valores das suas conversões com base em várias dimensões.

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

Recuperar informações sobre a configuração do acompanhamento de conversões

Para verificar a configuração do acompanhamento de conversões da sua conta e confirmar se ele está ativado, consulte o recurso Customer para ConversionTrackingSetting. Faça a consulta abaixo com GoogleAdsService.searchStream:

SELECT
  customer.conversion_tracking_setting.google_ads_conversion_customer,
  customer.conversion_tracking_setting.conversion_tracking_status,
  customer.conversion_tracking_setting.conversion_tracking_id,
  customer.conversion_tracking_setting.cross_account_conversion_tracking_id
FROM customer

O campo google_ads_conversion_customer indica a conta do Google Ads que cria e gerencia conversões para esse cliente. Para clientes que usam o acompanhamento de conversões de várias contas, esse é o ID de uma conta de administrador. O ID de cliente de conversão do Google Ads precisa ser fornecido como customer_id nas solicitações da API Google Ads para criar e gerenciar conversões. Esse campo é preenchido mesmo se o acompanhamento de conversões não estiver ativado.

O campo conversion_tracking_status indica se o acompanhamento de conversões está ativado e se a conta está usando o acompanhamento de conversões de várias contas.

Criar uma ação de conversão no cliente de conversão do Google Ads

Se o valor de conversion_tracking_status for NOT_CONVERSION_TRACKED, o acompanhamento de conversões não será ativado na conta. Para ativar o acompanhamento de conversões, crie pelo menos um ConversionAction na conta de conversão do Google Ads, como no exemplo a seguir. Como alternativa, você pode criar uma ação de conversão na IU seguindo as instruções na Central de Ajuda para o tipo de conversão que você quer ativar.

As conversões otimizadas são ativadas automaticamente quando enviadas pela API Google Ads, mas podem ser desativadas na IU do Google Ads.

Exemplo de código

Java

private void runExample(GoogleAdsClient googleAdsClient, long customerId) {

  // Creates a ConversionAction.
  ConversionAction conversionAction =
      ConversionAction.newBuilder()
          .setName("Earth to Mars Cruises Conversion #" + getPrintableDateTime())
          .setCategory(ConversionActionCategory.DEFAULT)
          .setType(ConversionActionType.WEBPAGE)
          .setStatus(ConversionActionStatus.ENABLED)
          .setViewThroughLookbackWindowDays(15L)
          .setValueSettings(
              ValueSettings.newBuilder()
                  .setDefaultValue(23.41)
                  .setAlwaysUseDefaultValue(true)
                  .build())
          .build();

  // Creates the operation.
  ConversionActionOperation operation =
      ConversionActionOperation.newBuilder().setCreate(conversionAction).build();

  try (ConversionActionServiceClient conversionActionServiceClient =
      googleAdsClient.getLatestVersion().createConversionActionServiceClient()) {
    MutateConversionActionsResponse response =
        conversionActionServiceClient.mutateConversionActions(
            Long.toString(customerId), Collections.singletonList(operation));
    System.out.printf("Added %d conversion actions:%n", response.getResultsCount());
    for (MutateConversionActionResult result : response.getResultsList()) {
      System.out.printf(
          "New conversion action added with resource name: '%s'%n", result.getResourceName());
    }
  }
}
      

C#

public void Run(GoogleAdsClient client, long customerId)
{
    // Get the ConversionActionService.
    ConversionActionServiceClient conversionActionService =
        client.GetService(Services.V15.ConversionActionService);

    // Add a conversion action.
    ConversionAction conversionAction = new ConversionAction()
    {
        Name = "Earth to Mars Cruises Conversion #" + ExampleUtilities.GetRandomString(),
        Category = ConversionActionCategory.Default,
        Type = ConversionActionType.Webpage,
        Status = ConversionActionStatus.Enabled,
        ViewThroughLookbackWindowDays = 15,
        ValueSettings = new ConversionAction.Types.ValueSettings()
        {
            DefaultValue = 23.41,
            AlwaysUseDefaultValue = true
        }
    };

    // Create the operation.
    ConversionActionOperation operation = new ConversionActionOperation()
    {
        Create = conversionAction
    };

    try
    {
        // Create the conversion action.
        MutateConversionActionsResponse response =
            conversionActionService.MutateConversionActions(customerId.ToString(),
                    new ConversionActionOperation[] { operation });

        // Display the results.
        foreach (MutateConversionActionResult newConversionAction in response.Results)
        {
            Console.WriteLine($"New conversion action with resource name = " +
                $"'{newConversionAction.ResourceName}' was added.");
        }
    }
    catch (GoogleAdsException e)
    {
        Console.WriteLine("Failure:");
        Console.WriteLine($"Message: {e.Message}");
        Console.WriteLine($"Failure: {e.Failure}");
        Console.WriteLine($"Request ID: {e.RequestId}");
        throw;
    }
}
      

PHP

public static function runExample(GoogleAdsClient $googleAdsClient, int $customerId)
{
    // Creates a conversion action.
    $conversionAction = new ConversionAction([
        'name' => 'Earth to Mars Cruises Conversion #' . Helper::getPrintableDatetime(),
        'category' => ConversionActionCategory::PBDEFAULT,
        'type' => ConversionActionType::WEBPAGE,
        'status' => ConversionActionStatus::ENABLED,
        'view_through_lookback_window_days' => 15,
        'value_settings' => new ValueSettings([
            'default_value' => 23.41,
            'always_use_default_value' => true
        ])
    ]);

    // Creates a conversion action operation.
    $conversionActionOperation = new ConversionActionOperation();
    $conversionActionOperation->setCreate($conversionAction);

    // Issues a mutate request to add the conversion action.
    $conversionActionServiceClient = $googleAdsClient->getConversionActionServiceClient();
    $response = $conversionActionServiceClient->mutateConversionActions(
        MutateConversionActionsRequest::build($customerId, [$conversionActionOperation])
    );

    printf("Added %d conversion actions:%s", $response->getResults()->count(), PHP_EOL);

    foreach ($response->getResults() as $addedConversionAction) {
        /** @var ConversionAction $addedConversionAction */
        printf(
            "New conversion action added with resource name: '%s'%s",
            $addedConversionAction->getResourceName(),
            PHP_EOL
        );
    }
}
      

Python

def main(client, customer_id):
    conversion_action_service = client.get_service("ConversionActionService")

    # Create the operation.
    conversion_action_operation = client.get_type("ConversionActionOperation")

    # Create conversion action.
    conversion_action = conversion_action_operation.create
    conversion_action.name = f"Earth to Mars Cruises Conversion {uuid.uuid4()}"
    conversion_action.type_ = (
        client.enums.ConversionActionTypeEnum.UPLOAD_CLICKS
    )
    conversion_action.category = (
        client.enums.ConversionActionCategoryEnum.DEFAULT
    )
    conversion_action.status = client.enums.ConversionActionStatusEnum.ENABLED
    conversion_action.view_through_lookback_window_days = 15

    # Create a value settings object.
    value_settings = conversion_action.value_settings
    value_settings.default_value = 15.0
    value_settings.always_use_default_value = True

    # Add the conversion action.
    conversion_action_response = (
        conversion_action_service.mutate_conversion_actions(
            customer_id=customer_id,
            operations=[conversion_action_operation],
        )
    )

    print(
        "Created conversion action "
        f'"{conversion_action_response.results[0].resource_name}".'
    )
      

Ruby

def add_conversion_action(customer_id)
  # GoogleAdsClient will read a config file from
  # ENV['HOME']/google_ads_config.rb when called without parameters
  client = Google::Ads::GoogleAds::GoogleAdsClient.new


  # Add a conversion action.
  conversion_action = client.resource.conversion_action do |ca|
    ca.name = "Earth to Mars Cruises Conversion #{(Time.new.to_f * 100).to_i}"
    ca.type = :UPLOAD_CLICKS
    ca.category = :DEFAULT
    ca.status = :ENABLED
    ca.view_through_lookback_window_days = 15

    # Create a value settings object.
    ca.value_settings = client.resource.value_settings do |vs|
      vs.default_value = 15
      vs.always_use_default_value = true
    end
  end

  # Create the operation.
  conversion_action_operation = client.operation.create_resource.conversion_action(conversion_action)

  # Add the ad group ad.
  response = client.service.conversion_action.mutate_conversion_actions(
    customer_id: customer_id,
    operations: [conversion_action_operation],
  )

  puts "New conversion action with resource name = #{response.results.first.resource_name}."
end
      

Perl

sub add_conversion_action {
  my ($api_client, $customer_id) = @_;

  # Create a conversion action.
  my $conversion_action =
    Google::Ads::GoogleAds::V15::Resources::ConversionAction->new({
      name     => "Earth to Mars Cruises Conversion #" . uniqid(),
      category => DEFAULT,
      type     => WEBPAGE,
      status   => ENABLED,
      viewThroughLookbackWindowDays => 15,
      valueSettings                 =>
        Google::Ads::GoogleAds::V15::Resources::ValueSettings->new({
          defaultValue          => 23.41,
          alwaysUseDefaultValue => "true"
        })});

  # Create a conversion action operation.
  my $conversion_action_operation =
    Google::Ads::GoogleAds::V15::Services::ConversionActionService::ConversionActionOperation
    ->new({create => $conversion_action});

  # Add the conversion action.
  my $conversion_actions_response =
    $api_client->ConversionActionService()->mutate({
      customerId => $customer_id,
      operations => [$conversion_action_operation]});

  printf "New conversion action added with resource name: '%s'.\n",
    $conversion_actions_response->{results}[0]{resourceName};

  return 1;
}
      

Verifique se conversion_action_type está definido com o valor ConversionActionType correto. Para mais orientações sobre como criar ações de conversão na API Google Ads, consulte Criar ações de conversão.

Recuperar uma ação de conversão

Para recuperar detalhes de uma ação de conversão existente, emita a consulta a seguir. Verifique se o ID de cliente na solicitação está definido como o cliente de conversão do Google Ads identificado acima e se o tipo de ação de conversão está definido como o valor ConversionActionType correto.

SELECT
  conversion_action.resource_name,
  conversion_action.name,
  conversion_action.status
FROM conversion_action
WHERE conversion_action.type = 'INSERT_CONVERSION_ACTION_TYPE'

Acompanhamento de conversões de várias contas

Se você estiver usando o acompanhamento de conversões de várias contas, o ConversionActionService retornará as seguintes ações de conversão:

  • Todas as ações de conversão definidas pela conta de administrador e usadas por ela para o acompanhamento de conversões de várias contas
  • Todas as ações de conversão em que o cliente acumulou estatísticas, incluindo ações definidas pelo sistema e aquelas que pertencem ao administrador, mesmo que ele as desvincule posteriormente
  • Todas as ações que o cliente definiu na própria conta, incluindo metas do Analytics e transações criadas em perfis vinculados do Google Analytics. Isso inclui ações não importadas para o Google Ads, que teriam um status HIDDEN e só poderiam ser importadas usando a interface da Web do Google Ads.

Você pode configurar e consultar ações de conversão de várias contas usando a API, mas é necessário ativar o acompanhamento de conversões de várias contas pela conta de administrador.