Como acompanhar e importar conversões

Considera-se uma conversão no Google AdWords quando um usuário executa alguma ação específica depois de clicar em um anúncio ou visualizar 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. O Google AdWords oferece diferentes rastreadores de conversão para as diferentes formas de conversões disponibilizadas aos clientes.

Este guia descreve os diferentes tipos de rastreadores de conversão e como aplicá-los. Ele também descreve como usar a API para importar conversões off-line para o Google AdWords.

Tipos de rastreadores de conversão

Para avaliar as conversões, basta configurar um ConversionTracker para o tipo de ação de conversão que você deseja acompanhar. Por exemplo, compras on-line e chamadas telefônicas exigem rastreadores de conversão diferentes.

A maioria dos tipos de conversão também requer ações adicionais da sua parte para o acompanhamento deles. Por exemplo, para acompanhar ações de conversão no seu website, você precisa criar um AdWordsConversionTracker e um snippet de código, chamado tag, que é adicionado à página de conversão do website.

As seções a seguir descrevem os diferentes tipos de rastreadores de conversão.

Conversões de chamadas telefônicas

Para acompanhar chamadas telefônicas a partir de extensões de chamada, é necessário ter um rastreador AdCallMetricsConversion. Elas usam um número de encaminhamento de chamadas do Google e especificam o rastreador de conversão no FeedItem da extensão de chamada telefônica. Na interface do usuário do Google AdWords, esse tipo de conversão é denominado Chamadas de anúncios.

É possível acompanhar esse tipo de conversão ao especificar o rastreador no FeedItem da extensão de chamada telefônica, usando o tipo de marcador em CONVERSION TYPE ID.

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

Conversões em websites

O rastreador AdWordsConversionTracker engloba vários tipos de conversões em websites, distinguidos na API pelo campo trackingCodeType.

A tabela abaixo mostra os parâmetros de API equivalentes para usar em cada Origem na interface do usuário do Google AdWords:

trackingCodeType Origem da IU do Google AdWords
WEBPAGE Website
WEBPAGE_ONCLICK Clique
CLICK_TO_CALL Cliques no número de telefone
--- Google Analytics

Nas conversões de Website e Cliques no número de telefone, é necessário ter o ConversionTrackerService para recuperar um snippet de código e posicioná-lo em páginas da Web que indicam uma ação de conversão (por exemplo, páginas de confirmação de finalização ou de envio de lead).

O tipo CLICK_TO_CALL é diferente de AdCallMetricsConversion, pois não acompanha chamadas telefônicas reais. Em vez disso, ele só acompanha cliques em números 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 reais.

Conversões de aplicativos

Uma AppConversion engloba as instalações de apps para dispositivos móveis e as ações no aplicativo, tanto em dispositivos Android quanto iOS. A tabela abaixo mostra os parâmetros de API equivalentes para usar em cada Origem na interface do usuário do Google AdWords:

appPlatform appConversionType Origem da IU do Google AdWords
ITUNES FIRST_OPEN Instalação de aplicativo para iOS (primeiro acesso)
ITUNES IN_APP_PURCHASE Ação no aplicativo para iOS
ANDROID_MARKET DOWNLOAD Instalação de aplicativo para Android (do Google Play)
ANDROID_MARKET FIRST_OPEN Instalação de aplicativo para Android (primeiro acesso)
ANDROID_MARKET IN_APP_PURCHASE Ação no aplicativo para Android

Ao especificar FIRST_OPEN como o appConversionType, você pode fornecer um appPostbackUrl para receber uma confirmação imediata assim que um usuário abrir seu aplicativo pela primeira vez. Para mais detalhes, consulte o guia de acompanhamento de conversões em aplicativos para dispositivos móveis Android.

Fazer o upload de conversões de clique

O rastreador UploadConversion mapeia a origem de conversão Importar na interface do usuário do Google AdWords seguida por Conversão de cliques. Quando ele é criado na interface da Web, a codificação automática se torna ativa na conta, mas isso não ocorre quando um rastreador de conversão é criado por meio da API. Se você criar um rastreador de conversão usando a API, será preciso ativar a codificação automática usando o CustomerService. Sem a codificação automática, você não terá o parâmetro GCLID que é necessário para fazer upload de conversões correspondentes a um clique.

Depois de criar um UploadConversion, você poderá usar o OfflineConversionFeedService para fazer o upload das conversões por cliques. Para mais detalhes, consulte Como importar conversões de clique abaixo.

Fazer o upload de conversões de chamada

Um rastreador UploadCallConversion mapeia a origem de conversão Importar na interface do usuário do Google AdWords seguida pela escolha Conversão a partir de chamadas.

Depois de criar um rastreador UploadCallConversion, você poderá usar o OfflineCallConversionFeedService para fazer o upload das conversões de chamadas. Para mais detalhes, consulte Como importar conversões de chamada abaixo.

Chamadas de websites

Um rastreador WebsiteCallMetricsConversion mapeia Chamadas de um website na interface do usuário do Google AdWords.

Diferentemente do AdCallMetricsConversion, esse rastreador exige que um snippet de código seja adicionado ao seu website para recuperar o número dinâmico de encaminhamento de chamadas do Google para o acompanhamento de chamadas dos números listados no seu website. Além disso, você precisa definir uma extensão de chamada e vinculá-la à campanha ou aos grupos de anúncios cujas chamadas de website você deseja acompanhar.

Rastreadores de conversão padrão de todo o sistema

O Google AdWords fornece alguns rastreadores de conversão padrão de todo o sistema que não exigem tags. Esses rastreadores apresentam configurações padrão para vários campos, incluindo nome, valor etc.

Se quiser editar as configurações desses rastreadores de conversão padrão, crie um novo rastreador ConversionTracker do mesmo subtipo e forneça o conversionTypeId do rastreador definido pelo sistema no campo originalConversionTypeId do objeto ConversionTracker. Isso é equivalente a editar uma cópia própria do rastreador de conversão de todo o sistema da sua conta. O uso do rastreador de conversão de todo o sistema na sua conta é automaticamente substituído pelo uso do rastreador de conversão que você acabou de criar (com o código do rastreador de conversão de todo o sistema definido como originalConversionTypeId), incluindo as estatísticas de conversão nos relatórios.

Somente um ConversionTracker pode ser criado de um tipo de conversão definido pelo sistema em qualquer conta. Se você tentar criar outro ConversionTracker usando o mesmo rastreador de conversão definido pelo sistema no campo originalConversionTypeId, a operação falhará. Em outras palavras, ao editar um rastreador de conversão de todo o sistema na sua conta, você passa a ter a cópia editada e não o original.

No caso das extensões de chamada, por exemplo, todas as extensões de chamada presentes na conta que utilizam o rastreador AdCallMetricsConversion de todo o sistema serão mapeadas para o novo rastreador que você criou. Todas as estatísticas de conversão anteriores que mostravam o tipo de conversão de todo o sistema passarão a mostrar esse novo.

A tabela abaixo exibe todos os rastreadores de conversão padrão de todo o sistema e os códigos deles.

ConversionTracker Nome conversionTypeId
AdCallMetricsConversion Chamadas a partir de anúncios 179
AppConversion Downloads do Android 214

O rastreador AppConversion padrão é único no sentido de que não é possível especificar o código do aplicativo. Em vez disso, ele acompanha todas as conversões dos aplicativos do Google Play para os quais não há um rastreador AppConversion mais específico.

Acompanhamento de conversões de várias contas

Se você usa o acompanhamento de conversões de várias contas, o ConversionTrackerService retorna os tipos de conversão a seguir:

  1. Todos os tipos de conversão definidos pela conta de administrador que são usados por ela para o acompanhamento de conversões de várias contas.
  2. Todos os tipos de conversão em que o cliente acumulou estatísticas, incluindo os tipos definidos pelo sistema e os tipos pertencentes ao administrador, mesmo que ele os desvincule posteriormente.
  3. Todos os tipos definidos pelo cliente na própria conta dele, incluindo metas e transações do Google Analytics criadas em perfis vinculados do Google Analytics. Isso inclui tipos que não foram importados para o Google AdWords, os quais apresentarão status HIDDEN e só poderão ser importados por meio da interface da Web do Google AdWords.

Você pode configurar e consultar rastreadores de conversão de várias contas usando a API, no entanto, precisa ativar na sua conta o acompanhamento de conversões de várias contas a partir da conta de administrador. Para mais informações, consulte este artigo da Central de Ajuda.

Antes, a coluna Conversões continha apenas as conversões realizadas no mesmo dispositivo. Agora você pode optar por incluir conversões em dispositivos diferentes na coluna Conversões usando a propriedade optimizeOnEstimatedConversions das configurações de acompanhamento de conversões do cliente. Em seguida, essas conversões serão usadas por várias estratégias de lances automáticos que fazem otimizações para conversão. Essas estratégias incluem custo por aquisição (CPA), gasto com retorno do investimento em publicidade (ROAS) desejado ou custo por clique otimizado (ECPC).

Campos de conversão disponíveis nos relatórios

Você pode recuperar estatísticas de conversão de contas, campanhas ou grupos de anúncios usando os campos de conversão disponíveis nos relatórios.

As tabelas abaixo listam alguns dos campos de relatório mais usados relacionados às conversões.

Conversions e seus campos derivados

Nome do campo Descrição
Conversions Campo principal dos relatórios de conversão que reflete nas ações de conversão para as quais você deseja criar lances. Estão incluídas somente conversões provenientes de ações de conversão (ConversionTracker) cujo campo excludeFromBidding esteja definido como false.
ConversionRate O total de Conversions dividido pelo total de cliques cujas conversões podem ser acompanhadas. Esta é a frequência média com que uma interação com o anúncio resulta em uma conversão cujo campo excludeFromBidding esteja definido como false.
ConversionValue O valor total de todas as ações de conversão (ConversionTracker) cujo campo excludeFromBidding esteja definido como false.
CostPerConversion Custo total dividido por Conversions.
ValuePerConversion ConversionValue dividido por Conversions.

AllConversions e seus campos derivados

Nome do campo Descrição
AllConversions Inclui todas as conversões do Google AdWords, independentemente dos valores do campo excludeFromBidding. Todas as origens de conversão (website, dispositivos diferentes, chamadas telefônicas etc.) contribuem para a contagem.
AllConversionRate O total de AllConversions dividido pelo total dos cliques cujas conversões podem ser acompanhadas. Frequência média em que uma interação com o anúncio resulta em uma conversão.
AllConversionValue O valor total de todas as suas conversões. Inclui conversões de chamadas telefônicas, websites, dispositivos diferentes e ações de conversão (ConversionTracker), independentemente dos valores do campo excludeFromBidding.
CostPerAllConversion Custo total dividido por AllConversions.
ValuePerAllConversion AllConversionValue dividido por AllConversions.

CrossDeviceConversions

Nome do campo Descrição
CrossDeviceConversions Conversões que ocorrem quando um cliente interage com um anúncio (por exemplo, clica em um anúncio de texto ou visualiza um anúncio em vídeo) usando um dispositivo, mas realiza a conversão em outro dispositivo ou navegador. CrossDeviceConversions já está incluído no campo AllConversions.

Colunas "Modelo atual" associadas a conversões

Quando você altera o campo attributionModelType de uma ação de conversão no Google AdWords, ela muda somente a forma como as conversões são contabilizadas nas suas colunas "Conversões" e "Todas as conversões" a partir desse momento. Se você quiser ver a aparência dos seus dados do histórico de conversões com o modelo de atribuição selecionado, use as colunas "Modelo atual" listadas abaixo. Ao comparar essas colunas às colunas de acompanhamento de conversões comuns, é possível ver como seriam seus dados se você tivesse usado o modelo de atribuição atual.

Nome do campo Descrição
CostPerCurrentModelAttributedConversion Dados do histórico de CostPerConversion com base no modelo de atribuição atual.
CurrentModelAttributedConversionValue Dados do histórico de ConversionValue com base no modelo de atribuição atual.
CurrentModelAttributedConversions Dados do histórico de Conversions com base no modelo de atribuição atual.
ValuePerCurrentModelAttributedConversion Dados do histórico de ValuePerConversion com base no modelo de atribuição atual.

Como importar conversões de clique

É possível usar a Google AdWords API para fazer upload de conversões off-line para o Google AdWords, o que oferece a você mais flexibilidade na associação de cliques com conversões. Você pode acompanhar os anúncios que resultaram em vendas off-line, por exemplo, por telefone ou por meio de um representante de vendas.

Esta seção descreve como usar a Google AdWords API para criar um feed e importar suas conversões off-line.

Configuração

A primeira etapa é a criação de tipos de conversão de importação. Isso precisa ser feito para cada "classificação" de conversão única. Você pode criar esses tipos de conversão usando a interface do usuário do Google AdWords ou por meio deste código:

UploadConversion uploadConversion = new UploadConversion();
// Set an appropriate category. This field is optional, and will be set to
// DEFAULT if not mentioned.
uploadConversion.setCategory(ConversionTrackerCategory.LEAD);
uploadConversion.setName(conversionName);
uploadConversion.setViewthroughLookbackWindow(30);
uploadConversion.setCtcLookbackWindow(90);

// Optional: Set the default currency code to use for conversions
// that do not specify a conversion currency. This must be an ISO 4217
// 3-character currency code such as "EUR" or "USD".
// If this field is not set on this UploadConversion, AdWords will use
// the account's currency.
uploadConversion.setDefaultRevenueCurrencyCode("EUR");

// Optional: Set the default revenue value to use for conversions
// that do not specify a conversion value. Note that this value
// should NOT be in micros.
uploadConversion.setDefaultRevenueValue(2.50);

ConversionTrackerOperation uploadConversionOperation = new
    ConversionTrackerOperation();
uploadConversionOperation.setOperator(Operator.ADD);
uploadConversionOperation.setOperand(uploadConversion);

ConversionTrackerReturnValue conversionTrackerReturnValue =
    conversionTrackerService.mutate(
        new ConversionTrackerOperation[] {uploadConversionOperation});

Esse snippet cria um objeto UploadConversion usando o ConversionTrackerService. O conversionName especificado é usado para identificar o evento de conversão e precisa ser exclusivo.

Depois de criar os tipos de conversão de importação, você precisará ativar seu website e o sistema de acompanhamento de leads para capturar e armazenar o parâmetro GCLID. Ele é o código exclusivo que o Google AdWords fornece para cada clique que chega ao seu website proveniente de um anúncio do Google AdWords. Também será necessário ativar a codificação automática para que seu website comece a receber o GCLID como um parâmetro de URL. Para mais detalhes sobre essas etapas, consulte Acompanhamento de conversões off-line.

Como fazer o upload de conversões off-line

Depois de criar o objeto UploadConversion, é necessário associar suas conversões off-line a ele. Faça isso passando o GCLID, o momento da conversão (com o código de fuso horário), o nome e o valor da conversão (opcional) para OfflineConversionFeedService:

List<OfflineConversionFeed> conversions = Lists.newArrayList();

// Offline conversion #1
OfflineConversionFeed conversion1 = new OfflineConversionFeed();
conversion1.setConversionName(conversionName1);
conversion1.setConversionTime(conversionTime1); // string format: "yyyyMMdd HHmmss tz"
conversion1.setGoogleClickId(gclId1);

// Optional: Set the conversion value.
conversion1.setConversionValue(conversionValue1);

// Optional: Set the conversion currency to an ISO 4217 3-character currency code
// such as "EUR" or "USD". If this field is not set, then AdWords will assume
// the conversion's value is in the default currency of the tracker.
conversion1.setConversionCurrencyCode(conversionCurrency1);

conversions.add(conversion1);

// Offline conversion #2
OfflineConversionFeed conversion2 = new OfflineConversionFeed();
conversion2.setConversionName(conversionName2);
conversion2.setConversionTime(conversionTime2);
conversion2.setGoogleClickId(gclId2);
conversion2.setConversionValue(conversionValue2);
conversion2.setConversionCurrencyCode(conversionCurrency2);

conversions.add(conversion2);

// Add additional conversions to the conversions list...

List<OfflineConversionFeedOperation> conversionOperations = Lists.newArrayList();
for (OfflineConversionFeed conversion : conversions) {
  OfflineConversionFeedOperation offlineConversionOperation = new OfflineConversionFeedOperation();
  offlineConversionOperation.setOperator(Operator.ADD);
  offlineConversionOperation.setOperand(conversion);

  conversionOperations.add(offlineConversionOperation);
}

OfflineConversionFeedReturnValue offlineConversionReturnValue = offlineConversionFeedService
    .mutate(conversionOperations.toArray(
        new OfflineConversionFeedOperation[conversionOperations.size()]));

Regras de validação

Há vários requisitos para fazer o upload de um OfflineConversionFeed.

Para evitar um erro OfflineConversionError.INVALID_CONVERSION_TYPE, o conversionName precisa fazer referência a um UploadConversion em que:

  • UploadConversion apresentava status ENABLED no momento do clique;

  • UploadConversion estava na conta de conversão em vigor da conta do Google AdWords que recebeu o clique no momento do clique. Se a conta não estava usando um acompanhamento de conversões de várias contas no momento do clique, o Google AdWords procurará o UploadConversion usado para fazer o upload das conversões. É possível encontrar a conta de acompanhamento de conversões em vigor acessando Ferramentas > Conversões na interface do usuário do Google AdWords. No entanto, lembre-se de que a conta de acompanhamento de conversões atualmente em vigor será exibida, e ela pode ser diferente da conta de acompanhamento de conversões que estava em vigor no momento do clique.

Além disso, as condições a seguir precisam ser atendidas:

  • conversionTime precisa ser depois do clique para evitar um erro OfflineConversionError.CONVERSION_PRECEDES_CLICK.

  • conversionTime precisa ser antes da janela de lookback da conversão de clique especificada por você no objeto UploadConversion para evitar um erro OfflineConversionError.EXPIRED_CLICK.

  • conversionValue precisa ser maior ou igual a zero.

  • conversionTime precisa ter um código de fuso horário, que pode ser de qualquer fuso horário válido, ou seja, o código não precisa corresponder ao fuso horário da conta.

Dicas

Observações importantes para lembrar ao criar um OfflineConversionFeed:

  • Operações de upload são atômicas. Se uma conversão tem um GCLID ruim ou é muito antiga, nenhuma das conversões que a acompanham é enviada. Use falhas parciais para evitar essa situação.

  • Embora sejam permitidos uploads duplicados de uma conversão (mesmo GCLID, nome e hora), apenas a primeira instância será gravada.

  • Uma conversão é registrada para a data do clique original, não para quando você enviou o pedido de upload.

  • Depois de criar o UploadConversion, recomendamos que você aguarde seis horas para fazer o upload.

  • Pode levar até três horas para que as estatísticas de conversão importadas apareçam na sua conta do Google AdWords.

Exemplos de código

A pasta Remarketing de cada biblioteca cliente contém um exemplo de código para fazer o upload de conversões off-line:

Java

Fazer upload de conversões off-line

C#

Fazer upload de conversões off-line

PHP

Fazer upload de conversões off-line

Perl

Fazer upload de conversões off-line

Python

Fazer upload de conversões off-line

Ruby

Fazer upload de conversões off-line

Como importar conversões de chamada

É possível usar a Google AdWords API para fazer upload de conversões de chamada off-line para o Google AdWords, o que oferece a você mais flexibilidade na associação de chamadas com conversões.

Esta seção descreve como usar a Google AdWords API para criar um feed e importar suas conversões de chamada off-line.

Configuração

A primeira etapa é criar um rastreador de conversões para as conversões de chamada off-line. Você pode criá-lo usando a interface do usuário do Google AdWords ou por meio de código. Se usar código, você criará um UploadCallConversion. O processo é parecido com o exemplo encontrado em Configurações para importação de conversões de clique. No exemplo, use UploadCallConversion em vez de UploadConversion.

Como fazer o upload de conversões de chamadas off-line

Depois de criar o objeto UploadCallConversion, é necessário associar suas conversões off-line a ele. Faça isso passando o identificador de chamadas, o momento da conversão (com o código de fuso horário), o nome da conversão e o valor e a moeda de conversão (opcional) para OfflineCallConversionFeedService:

Java

/**
 * Runs the example.
 *
 * @param adWordsServices the services factory.
 * @param session the session.
 * @param callerId the caller ID of the call.
 * @param callStartTime the call start time of the call.
 * @param conversionName the name of the conversion tracker.
 * @param conversionTime the date and time of the conversion.
 * @param conversionValue the value of the conversion.
 * @throws ApiException if the API request failed with one or more service errors.
 * @throws RemoteException if the API request failed due to other errors.
 */
public static void runExample(
    AdWordsServicesInterface adWordsServices,
    AdWordsSession session,
    String callerId,
    String callStartTime,
    String conversionName,
    String conversionTime,
    double conversionValue)
    throws RemoteException {

  // Get the OfflineCallConversionFeedService.
  OfflineCallConversionFeedServiceInterface offlineCallConversionFeedService =
      adWordsServices.get(session, OfflineCallConversionFeedServiceInterface.class);

  // Associate offline call conversions with the existing named conversion tracker. If this
  // tracker was newly created, it may be a few hours before it can accept conversions.
  OfflineCallConversionFeed feed = new OfflineCallConversionFeed();
  feed.setCallerId(callerId);
  feed.setCallStartTime(callStartTime);
  feed.setConversionName(conversionName);
  feed.setConversionTime(conversionTime);
  feed.setConversionValue(conversionValue);

  OfflineCallConversionFeedOperation offlineCallConversionOperation =
      new OfflineCallConversionFeedOperation();
  offlineCallConversionOperation.setOperator(Operator.ADD);
  offlineCallConversionOperation.setOperand(feed);

  // This example uploads only one call conversion, but you can upload multiple call conversions
  // by passing additional operations.
  OfflineCallConversionFeedReturnValue offlineCallConversionReturnValue =
      offlineCallConversionFeedService.mutate(
          new OfflineCallConversionFeedOperation[] {offlineCallConversionOperation});

  // Display results.
  for (OfflineCallConversionFeed feedResult : offlineCallConversionReturnValue.getValue()) {
    System.out.printf(
        "Uploaded offline conversion value of %.4f for caller ID '%s'.%n",
        feedResult.getConversionValue(), feedResult.getCallerId());
  }
}

C#

public void Run(AdWordsUser user, String conversionName, String callStartTime, String callerId,
    String conversionTime, double conversionValue) {
  using (OfflineCallConversionFeedService offlineCallConversionFeedService =
       (OfflineCallConversionFeedService) user.GetService(
           AdWordsService.v201710.OfflineCallConversionFeedService)) {

    // Associate offline call conversions with the existing named conversion tracker. If this
    // tracker was newly created, it may be a few hours before it can accept conversions.
    OfflineCallConversionFeed feed = new OfflineCallConversionFeed();
    feed.callerId = callerId;
    feed.callStartTime = callStartTime;
    feed.conversionName = conversionName;
    feed.conversionTime = conversionTime;
    feed.conversionValue = conversionValue;

    OfflineCallConversionFeedOperation offlineCallConversionOperation =
        new OfflineCallConversionFeedOperation();
    offlineCallConversionOperation.@operator = Operator.ADD;
    offlineCallConversionOperation.operand = feed;

    try {
      // This example uploads only one call conversion, but you can upload
      // multiple call conversions by passing additional operations.
      OfflineCallConversionFeedReturnValue offlineCallConversionReturnValue =
          offlineCallConversionFeedService.mutate(
              new OfflineCallConversionFeedOperation[] { offlineCallConversionOperation });

      // Display results.
      foreach (OfflineCallConversionFeed feedResult in
          offlineCallConversionReturnValue.value) {
        Console.WriteLine("Uploaded offline call conversion value of {0} for caller ID '{1}'.",
            feedResult.conversionValue, feedResult.callerId);
      }
    } catch (Exception e) {
      throw new System.ApplicationException("Failed to upload offline call conversions.", e);
    }
  }
}

Visual Basic

Using offlineCallConversionFeedService As OfflineCallConversionFeedService =
    CType(user.GetService(AdWordsService.v201710.OfflineCallConversionFeedService),
        OfflineCallConversionFeedService)

  ' Associate offline call conversions with the existing named conversion tracker. If this
  ' tracker was newly created, it may be a few hours before it can accept conversions.
  Dim feed As New OfflineCallConversionFeed()
  feed.callerId = callerId
  feed.callStartTime = callStartTime
  feed.conversionName = conversionName
  feed.conversionTime = conversionTime
  feed.conversionValue = conversionValue

  Dim offlineCallConversionOperation As New OfflineCallConversionFeedOperation()
  offlineCallConversionOperation.operator = [Operator].ADD
  offlineCallConversionOperation.operand = feed

  Try
    ' This example uploads only one call conversion, but you can upload
    ' multiple call conversions by passing additional operations.
    Dim offlineCallConversionReturnValue As OfflineCallConversionFeedReturnValue =
      offlineCallConversionFeedService.mutate(
          New OfflineCallConversionFeedOperation() {offlineCallConversionOperation})

    ' Display results.
    For Each feedResult As OfflineCallConversionFeed In
        offlineCallConversionReturnValue.value
      Console.WriteLine("Uploaded offline call conversion value of {0} for caller ID '{1}'.",
          feedResult.conversionValue, feedResult.callerId)
    Next
  Catch e As Exception
    Throw New System.ApplicationException("Failed to upload offline call conversions.", e)
  End Try
End Using

Python

def main(client, caller_id, call_start_time, conversion_name, conversion_time,
         conversion_value):
  # Initialize appropriate services.
  occ_feed_service = client.GetService(
      'OfflineCallConversionFeedService', version='v201710')

  # Associate offline call conversions with the existing named conversion
  # tracker. If this tracker was newly created, it may be a few hours before it
  # can accept conversions.
  feed = {
      'callerId': caller_id,
      'callStartTime': call_start_time,
      'conversionName': conversion_name,
      'conversionTime': conversion_time,
      'conversionValue': conversion_value,
  }

  occ_operations = [{'operator': 'ADD', 'operand': feed}]

  occ_response = occ_feed_service.mutate(occ_operations)
  values = occ_response['value']

  if values:
    for occ_feed in values:
      print ('Uploaded offline call conversion value of "%s" for caller ID '
             '"%s".\n' % (occ_feed['conversionName'], occ_feed['callerId']))
  else:
    print 'No offline call conversions were added.'

PHP

public static function runExample(
    AdWordsServices $adWordsServices,
    AdWordsSession $session,
    $callerId,
    $callStartTime,
    $conversionName,
    $conversionTime,
    $conversionValue
) {
    $offlineCallConversionService = $adWordsServices->get(
        $session,
        OfflineCallConversionFeedService::class
    );

    // Associate offline call conversions with the existing named conversion
    // tracker. If this tracker was newly created, it may be a few hours before
    // it can accept conversions.
    $feed = new OfflineCallConversionFeed();
    $feed->setCallerId($callerId);
    $feed->setCallStartTime($callStartTime);
    $feed->setConversionName($conversionName);
    $feed->setConversionTime($conversionTime);
    $feed->setConversionValue($conversionValue);

    $offlineCallConversionOperations = [];
    $offlineCallConversionOperation = new OfflineCallConversionFeedOperation();
    $offlineCallConversionOperation->setOperator(Operator::ADD);
    $offlineCallConversionOperation->setOperand($feed);
    $offlineCallConversionOperations[] = $offlineCallConversionOperation;

    // This example uploads only one call conversion, but you can upload
    // multiple call conversions by passing additional operations.
    $result = $offlineCallConversionService->mutate($offlineCallConversionOperations);

    $feed = $result->getValue()[0];
    printf(
        "Uploaded offline call conversion value of '%s' for caller ID '%s'.\n",
        $feed->getConversionValue(),
        $feed->getCallerId()
    );
}

Perl

sub upload_offline_call_conversions {
  my $client                             = shift;
  my $caller_id                          = shift;
  my $call_start_time                    = shift;
  my $conversion_name                    = shift;
  my $conversion_time                    = shift;
  my $conversion_value                   = shift;
  my @offline_call_conversion_operations = ();

  # Associate offline call conversions with the existing named
  # conversion tracker. If this tracker was newly created, it may be a
  # few hours before it can accept conversions.
  my $feed = Google::Ads::AdWords::v201710::OfflineCallConversionFeed->new({
    callerId        => $caller_id,
    callStartTime   => $call_start_time,
    conversionName  => $conversion_name,
    conversionTime  => $conversion_time,
    conversionValue => $conversion_value
  });

  my $offline_call_conversion_operation =
    Google::Ads::AdWords::v201710::OfflineCallConversionFeedOperation->new({
      operator => "ADD",
      operand  => $feed
    });

  push @offline_call_conversion_operations, $offline_call_conversion_operation;

  # This example uploads only one call conversion, but you can upload multiple
  # call conversions by passing additional operations.
  my $result =
    $client->OfflineCallConversionFeedService()
    ->mutate({operations => \@offline_call_conversion_operations});

  # Display results.
  if ($result->get_value()) {
    foreach my $feed_result (@{$result->get_value()}) {
      printf "Uploaded offline call conversion value of \"%s\" for caller ID " .
        "\"%s\".\n",
        $feed_result->get_conversionValue(),
        $feed_result->get_callerId();
    }
  } else {
    print "No offline call conversions were added.\n";
    return;
  }

  return 1;
}

Ruby

occ_feed_srv =
    adwords.service(:OfflineCallConversionFeedService, API_VERSION)

# Associate offline conversions with the existing named conversion tracker. If
# this tracker was newly created, it may be a few hours before it can accept
# conversions.
feed = {
  :caller_id => caller_id,
  :call_start_time => call_start_time,
  :conversion_name => conversion_name,
  :conversion_time => conversion_time,
  :conversion_value => conversion_value
}

occ_operations = [{
  :operator => 'ADD',
  :operand => feed
}]

occ_response = occ_feed_srv.mutate(occ_operations)

if occ_response[:value]
  occ_response[:value].each do |occ_feed|
    puts 'Uploaded offline call conversion value "%s" for caller ID "%s"' %
        [occ_feed[:conversion_name], occ_feed[:caller_id]]
  end
end

Regras de validação

Há vários requisitos para fazer o upload de um OfflineCallConversionFeed.

Para evitar um erro OfflineCallConversionError.INVALID_CONVERSION_TYPE, conversionName precisa fazer referência a um UploadCallConversion em que:

  • UploadCallConversion apresentava status ENABLED no momento da chamada;

  • UploadCallConversion estava na conta de conversão em vigor da conta do Google AdWords que recebeu o clique no momento da chamada. Se a conta não estava usando um acompanhamento de conversões de várias contas no momento da chamada, o Google AdWords procurará o UploadCallConversion usado para fazer o upload das conversões. É possível encontrar a conta de acompanhamento de conversões em vigor acessando Ferramentas > Conversões na interface do usuário do Google AdWords. No entanto, lembre-se de que a conta de acompanhamento de conversões atualmente em vigor será exibida, e ela pode ser diferente da conta de acompanhamento de conversões que estava em vigor no momento da chamada.

Além disso, as condições a seguir precisam ser atendidas:

  • conversionValue precisa ser maior ou igual a zero.

  • conversionTime precisa ter um código de fuso horário, que pode ser de qualquer fuso horário válido, ou seja, o código não precisa corresponder ao fuso horário da conta.

Dicas

Observações importantes para lembrar ao criar um OfflineCallConversionFeed:

  • Depois de criar o UploadCallConversion, recomendamos que você aguarde seis horas para fazer upload.

  • Pode levar até três horas para que as estatísticas de conversão importadas apareçam na sua conta do Google AdWords.

  • Embora sejam permitidos uploads duplicados de uma conversão (mesmo código de chamada, nome e hora), apenas a primeira instância será gravada.

Exemplos de código

A pasta Remarketing de cada biblioteca cliente contém um exemplo de código para fazer o upload de conversões de chamada off-line:

Java

Fazer upload de conversões de chamada off-line

C#

Fazer upload de conversões de chamada off-line

PHP

Fazer upload de conversões de chamada off-line

Perl

Fazer upload de conversões de chamada off-line

Python

Fazer upload de conversões de chamada off-line

Ruby

Fazer upload de conversões de chamada off-line

Enviar comentários sobre…

Esta página
Comentários sobre a documentação
Google AdWords API
Google AdWords API
Comentários sobre o produto
Precisa de ajuda? Acesse nossa página de suporte.