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 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 proporciona 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 tipos de rastreadores de conversão para as diversas formas de conversão disponíveis aos clientes.

Este guia descreve cada tipo e como aplicá-los. Também explica como usar a API ao importar conversões off-line para o Google AdWords.

Tipos de rastreadores de conversão

Para avaliar as conversões, é preciso configurar um ConversionTracker para o tipo de ação de conversão que você quer 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 fazer o acompanhamento. Por exemplo, para acompanhar ações de conversão no seu site, você precisa criar um AdWordsConversionTracker e um snippet de código, chamado de tag, que é adicionado à página de conversão do site.

As origens de conversão relacionadas a chamadas na IU do Google AdWords (Cliques no número de telefone, Chamadas a partir de anúncios e Chamadas a partir de sites) são mapeadas para um ConversionTracker diferente na Google AdWords API:

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

Conversões em sites

O AdWordsConversionTracker engloba vários tipos de conversões no site, diferenciados na API pelo campo trackingCodeType.

A tabela abaixo mostra os parâmetros de API equivalentes a serem usados em cada Origem na IU do Google AdWords:

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

As conversões de Site e Cliques no número de telefone precisam do googleEventSnippet, que deve ser inserido nas páginas da Web que indicam uma ação de conversão (como uma página de confirmação de compra ou de envio de lead), e da googleGlobalSiteTag, que precisa ser instalada em todas as páginas do site. É possível recuperar esses dois atributos com o ConversionTrackerService.

O tipo CLICK_TO_CALL é diferente de AdCallMetricsConversion porque não acompanha chamadas telefônicas. Em vez disso, ele só acompanha cliques em números de telefone provenientes de dispositivos móveis. Esse recurso é útil quando você não consegue usar um número de encaminhamento de chamadas do Google para acompanhar chamadas telefônicas.

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 IU do Google AdWords, esse tipo de conversão é denominado Chamadas a partir de anúncios.

Para acompanhar esse tipo de conversão, basta especificar o rastreador no FeedItem da extensão de chamada telefônica usando o tipo de marcador referente ao CONVERSION TYPE ID.

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

Conversões de aplicativos

Um AppConversion abrange instalações de apps para dispositivos móveis e ações no aplicativo para Android e iOS. A tabela abaixo mostra os parâmetros de API equivalentes a serem usados em cada Origem na IU do Google AdWords:

appPlatform appConversionType Origem da IU do Google AdWords
ITUNES FIRST_OPEN Instalação de app para iOS (primeiro acesso)
ITUNES IN_APP_PURCHASE Ação no aplicativo para iOS
ANDROID_MARKET DOWNLOAD Instalação de app para Android (pelo Google Play)
ANDROID_MARKET FIRST_OPEN Instalação de app 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 de aplicativos para dispositivos móveis no Android.

Fazer o upload de conversões de cliques

O rastreador UploadConversion mapeia a origem de conversão Importar na IU do Google AdWords seguida por Conversão de cliques. Quando ele é criado na IU 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 o upload das conversões correspondentes a um clique.

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

Fazer o upload de conversões de chamada

O rastreador UploadCallConversion mapeia a origem de conversão Importar na IU do Google AdWords seguida pela escolha de Conversão de cliques.

Não é possível fazer o upload de um clique para ligar (em smartphones) como conversão se não houver um número de encaminhamento de chamadas do Google relacionado à chamada. Sem esse número, não há como o Google ter certeza de que o clique levou a uma chamada e depois a uma conversão. Se o upload de um clique for feito dessa forma, ele será ignorado pelo rastreador de conversões.

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 a partir de sites

Um WebsiteCallMetricsConversion mapeia chamadas a partir de sites na IU do Google AdWords.

Diferentemente do AdCallMetricsConversion, esse rastreador exige que googleEventSnippet e googleGlobalSiteTag sejam adicionados ao seu site para recuperar o número dinâmico de encaminhamento de chamadas do Google e acompanhar chamadas para os números listados no seu site. Além disso, você precisa definir uma extensão de chamada e vinculá-la à campanha ou aos grupos de anúncios cujas chamadas a partir de sites você quer acompanhar.

Conversões diretas de vendas na loja

Com as vendas na loja (upload direto), você ou um parceiro terceirizado pode importar transações off-line diretamente para o Google AdWords. Ao fazer a correspondência dos dados de transações provenientes do seu ponto de vendas ou banco de dados de clientes, você pode ver como seus anúncios do Google se transformam em compras off-line. É possível fazer o upload das transações off-line para um objeto OfflineDataUpload por meio do OfflineDataUploadService.

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. Eles apresentam configurações padrão para vários campos, incluindo nome, valor, entre outros.

Se quiser editar as configurações desses rastreadores de conversão padrão, crie um novo 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 daquele 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 a partir de um tipo de conversão definido pelo sistema em qualquer conta. Se você tentar criar outro ConversionTracker usando o mesmo acompanhamento de conversão definido pelo sistema no campo originalConversionTypeId, a operação falhará. Em outras palavras, ao editar um acompanhamento 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 acompanhamentos 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 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 do cliente, 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 IU da Web do Google AdWords.

Você pode configurar e consultar acompanhamento de conversão de várias contas usando a API, no entanto, precisa ativar na sua 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) desejado, 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 as ações de conversão para as quais você quer 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 (site, 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, sites, 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 históricos de CostPerConversion com base no modelo de atribuição atual.
CurrentModelAttributedConversionValue Dados históricos de ConversionValue com base no modelo de atribuição atual.
CurrentModelAttributedConversions Dados históricos de Conversions com base no modelo de atribuição atual.
ValuePerCurrentModelAttributedConversion Dados históricos de ValuePerConversion com base no modelo de atribuição atual.

Atribuição de conversão em relatórios

A data de uma conversão e a data em que você fez o upload de uma conversão não afetam a data em que os relatórios refletem a conversão e seus valores. Todas as métricas nos relatórios são atribuídas à data de impressão de cada clique.

Por exemplo, digamos que, em 21 de outubro de 2017, você fez o upload das conversões a seguir, todas com um conversionTime que a parte da data é 20171020:

ImpressionDate Conversões ConversionValue
18 de outubro de 2017 500 US$ 1.000
19 de outubro de 2017 250 US$ 200
20 de outubro de 2017 100 US$ 150

Nesse caso, os valores de Conversions e ConversionValues de um relatório de 20 de outubro de 2017 serão alterados apenas por 100 e US$ 150, respectivamente. Para ver as alterações em Conversions e ConversionValues de todas as conversões de que você fez upload, seria necessário expandir o período do relatório para cobrir de 18 de outubro de 2017 a 20 de outubro de 2017.

Da mesma forma, as métricas Conversions e ConversionValue para 21 de outubro de 2017 (a data em que você fez upload das conversões) não vai mudar como resultado do upload.

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 IU do Google AdWords ou por meio deste código:

Java

// Create an upload conversion for offline conversion imports.
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("Upload Conversion #" + System.currentTimeMillis());
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);
// Optional: To upload fractional conversion credits, mark the upload conversion
// as externally attributed. See
// https://developers.google.com/adwords/api/docs/guides/conversion-tracking#importing_externally_attributed_conversions
// to learn more about importing externally attributed conversions.

// uploadConversion.setIsExternallyAttributed(true);

conversionTrackers.add(uploadConversion);

PHP

// Create an upload conversion for offline conversion imports.
$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('Upload Conversion # ' . uniqid());
$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);

// Optional: To upload fractional conversion credits, mark the upload
// conversion as externally attributed. See
// https://developers.google.com/adwords/api/docs/guides/conversion-tracking#importing_externally_attributed_conversions
// to learn more about importing externally attributed conversions.

// uploadConversion->setIsExternallyAttributed(true);

$conversionTrackers[] = $uploadConversion;

Python

upload_conversion = {
    'xsi_type': 'UploadConversion',
    'name': 'Upload Conversion #%s' % uuid.uuid4(),
    # Optional fields.
    # Set an appropriate category. This will be set to DEFAULT if not
    # specified.
    'category': 'LEAD',
    'viewthroughLookbackWindow': '30',
    'ctcLookbackWindow': '90',
    # Set the default currency code to use for conversions that do
    # not specify a conversion currency. This must be an ISO 4217 3-character
    # code such as "EUR" or "USD".
    # If this field is not set, AdWords will use the account's currency.
    'defaultRevenueCurrencyCode': 'EUR',
    # Set the default revenue value to use for conversions that do not specify
    # a converison value. Note that this value should NOT be in micros.
    'defaultRevenueValue': '2.50',
    # To upload fractional conversion credits, mark the upload conversion as
    # externally attributed. To learn more about importing externally
    # attributed conversions, see:
    # https://developers.google.com/adwords/api/docs/guides/conversion-tracking#importing_externally_attributed_conversions
    # 'isExternallyAttributed': 'true'
}

Ruby

# Prepare for adding upload conversion tracker.
operation2 = {
  :operator => 'ADD',
  :operand => {
    # The 'xsi_type' field allows you to specify the xsi:type of the object
    # being created. It's only necessary when you must provide an explicit
    # type that the client library can't infer.
    :xsi_type => 'UploadConversion',

    # Set an appropriate category. This field is optional, and will be set to
    # DEFAULT if not mentioned.
    :category => 'LEAD',
    :name => "Upload Conversion #%d" % (Time.new.to_f * 1000).to_i,
    :viewthrough_lookback_window => 30,
    :ctc_lookback_window => 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 currency.
    :default_revenue_currency_code => '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.
    :default_revenue_value => 2.50,

    # Optional: To upload fractional conversion credits, mark the upload
    # conversion as externally attributed. See
    # https://developers.google.com/adwords/api/docs/guides/conversion-tracking#importing_externally_attributed_conversions
    # to learn more about importing externally attributed conversions.
    #:is_externally_attributed => true
  }
}

Perl

# Create an upload conversion for offline conversion imports.
my $upload_conversion_tracker =
  Google::Ads::AdWords::v201802::UploadConversion->new({
    # Set an appropriate category. This field is optional, and will be set to
    # DEFAULT if not mentioned.
    category                             => "LEAD",
    name                                 => "Upload Conversion #" . uniqid(),
    viewthroughLookbackWindow            => 30,
    ctcLookbackWindow                    => 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.
    defaultRevenueCurrencyCode => "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.
    defaultRevenueValue => 2.50,
    # Optional: To upload fractional conversion credits, mark the upload conversion
    # as externally attributed. See
    # https://developers.google.com/adwords/api/docs/guides/conversion-tracking#importing_externally_attributed_conversions
    # to learn more about importing externally attributed conversions.
    # isExternallyAttributed => true
  });
push @conversion_trackers, $upload_conversion_tracker;

C#

// Create an upload conversion for offline conversion imports.
UploadConversion uploadConversion = new UploadConversion();
// Set an appropriate category. This field is optional, and will be set to
// DEFAULT if not mentioned.
uploadConversion.category = ConversionTrackerCategory.LEAD;
uploadConversion.name = "Upload Conversion #" + ExampleUtilities.GetRandomString();
uploadConversion.viewthroughLookbackWindow = 30;
uploadConversion.ctcLookbackWindow = 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.defaultRevenueCurrencyCode = "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.defaultRevenueValue = 2.50;

// Optional: To upload fractional conversion credits, mark the upload conversion
// as externally attributed. See
// https://developers.google.com/adwords/api/docs/guides/conversion-tracking#importing_externally_attributed_conversions
// to learn more about importing externally attributed conversions.

// uploadConversion.isExternallyAttributed = true;

conversionTrackers.Add(uploadConversion);

VB

' Create an upload conversion for offline conversion imports.
Dim uploadConversion As New UploadConversion()
' Set an appropriate category. This field is optional, and will be set to
' DEFAULT if not mentioned.
uploadConversion.category = ConversionTrackerCategory.LEAD
uploadConversion.name = "Upload Conversion #" + ExampleUtilities.GetRandomString()
uploadConversion.viewthroughLookbackWindow = 30
uploadConversion.ctcLookbackWindow = 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.defaultRevenueCurrencyCode = "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.defaultRevenueValue = 2.5

' Optional: To upload fractional conversion credits, mark the upload conversion
' as externally attributed. See
' https://developers.google.com/adwords/api/docs/guides/conversion-tracking#importing_externally_attributed_conversions
' to learn more about importing externally attributed conversions.

' uploadConversion.isExternallyAttributed = True

conversionTrackers.Add(uploadConversion)

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 site 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 impressão de um anúncio e é enviado para o servidor do Google AdWords quando o anúncio recebe um clique. Também será necessário ativar a codificação automática para que seu site 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:

Java

/**
 * Runs the example.
 *
 * @param adWordsServices the services factory.
 * @param session the session.
 * @param conversionName the name of the conversion tracker.
 * @param gClid the GCLID for the conversion.
 * @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 conversionName, String gClid, String conversionTime,
    double conversionValue) throws RemoteException {

  // Get the OfflineConversionFeedService.
  OfflineConversionFeedServiceInterface offlineConversionFeedService =
      adWordsServices.get(session, OfflineConversionFeedServiceInterface.class);

  // 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.
  OfflineConversionFeed feed = new OfflineConversionFeed();
  feed.setConversionName(conversionName);
  feed.setConversionTime(conversionTime);
  feed.setConversionValue(conversionValue);
  feed.setGoogleClickId(gClid);

  OfflineConversionFeedOperation offlineConversionOperation =
      new OfflineConversionFeedOperation();
  offlineConversionOperation.setOperator(Operator.ADD);
  offlineConversionOperation.setOperand(feed);

  OfflineConversionFeedReturnValue offlineConversionReturnValue = offlineConversionFeedService
      .mutate(new OfflineConversionFeedOperation[] {offlineConversionOperation});

  OfflineConversionFeed newFeed = offlineConversionReturnValue.getValue(0);

  System.out.printf(
      "Uploaded offline conversion value of %.4f for Google Click ID '%s' to '%s'.%n",
      newFeed.getConversionValue(), newFeed.getGoogleClickId(), newFeed.getConversionName());
}

PHP

$offlineConversionService = $adWordsServices->get($session, OfflineConversionFeedService::class);

// 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 = new OfflineConversionFeed();
$feed->setConversionName($conversionName);
$feed->setConversionTime($conversionTime);
$feed->setConversionValue($conversionValue);
$feed->setGoogleClickId($gclid);

// Optional: To upload fractional conversion credits, set the external
// attribution model and credit. To use this feature, your conversion
// tracker should be marked as externally attributed. See
// https://developers.google.com/adwords/api/docs/guides/conversion-tracking#importing_externally_attributed_conversions
// to learn more about importing externally attributed conversions.

// $feed->setExternalAttributionModel('Linear');
// $feed->setExternalAttributionCredit(0.3);

$offlineConversionOperation = new OfflineConversionFeedOperation();
$offlineConversionOperation->setOperator(Operator::ADD);
$offlineConversionOperation->setOperand($feed);
$offlineConversionOperations = [$offlineConversionOperation];

$result = $offlineConversionService->mutate($offlineConversionOperations);

$feed = $result->getValue()[0];
printf(
    "Uploaded offline conversion value of %d for Google Click ID = '%s' to '%s'.\n",
    $feed->getConversionValue(),
    $feed->getGoogleClickId(),
    $feed->getConversionName()
);

Python

# Initialize appropriate services.
offline_conversion_feed_service = client.GetService(
    'OfflineConversionFeedService', version='v201802')

# 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 = {
    'conversionName': conversion_name,
    'conversionTime': conversion_time,
    'conversionValue': conversion_value,
    'googleClickId': click_id,
    # Optional: To upload fractional conversion credits, set the external
    # attribution model and credit. To use this feature, your conversion
    # tracker should be marked as externally attributed. To learn more about
    # importing externally attributed conversins, see:
    # https://developers.google.com/adwords/api/docs/guides/conversion-tracking#importing_externally_attributed_conversions
    # 'externalAttributionCredit': 0.3,
    # 'externalAttributionModel': 'Linear'
}

offline_conversion_operation = {
    'operator': 'ADD',
    'operand': feed
}

offline_conversion_response = offline_conversion_feed_service.mutate(
    [offline_conversion_operation])
new_feed = offline_conversion_response['value']

print ('Uploaded offline conversion value of "%s" for Google Click ID '
       '"%s" to "%s".' % (new_feed['conversionValue'],
                          new_feed['googleClickId'],
                          new_feed['conversionName']))

Ruby

conversion_feed_srv =
    adwords.service(:OfflineConversionFeedService, 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 = {
  :conversion_name => conversion_name,
  :google_click_id => google_click_id,
  :conversion_time => conversion_time,
  :conversion_value => conversion_value
}

# Optional: To upload fractional conversion credits, set the external
# attribution model and credit. To use this feature, your conversion tracker
# should be marked as externally attributed. See
# https://developers.google.com/adwords/api/docs/guides/conversion-tracking#importing_externally_attributed_conversions
# to learn more about importing externally attributed conversions.
#
# feed[:external_attribution_model] = "Linear"
# feed[:external_attribution_credit] = 0.3

return_feeds = conversion_feed_srv.mutate([
  {:operator => 'ADD', :operand => feed}])
return_feeds[:value].each do |return_feed|
  puts ("Uploaded offline conversion value %.2f for Google Click ID '%s', " +
      'to %s') % [return_feed[:conversion_value],
                  return_feed[:google_click_id],
                  return_feed[:conversion_name]]
end

Perl

sub upload_offline_conversions {
  my $client                        = shift;
  my $conversion_name               = shift;
  my $gclid                         = shift;
  my $conversion_time               = shift;
  my $conversion_value              = shift;
  my @offline_conversion_operations = ();

  # 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.
  my $feed = Google::Ads::AdWords::v201802::OfflineCallConversionFeed->new({
      conversionName  => $conversion_name,
      conversionTime  => $conversion_time,
      conversionValue => $conversion_value,
      googleClickId   => $gclid
  });

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

  push @offline_conversion_operations, $offline_conversion_operation;

  # Add the upload conversion.
  my $feed_result =
    $client->OfflineCallConversionFeedService()
    ->mutate({operations => \@offline_conversion_operations});

  # Display results.
  if ($feed_result->get_value()) {
    foreach my $oc_feed (@{$feed_result->get_value()}) {
      printf "Uploaded offline conversion value of \"%s\" for Google Click " .
        "ID \"%s\" was created.\n",
        $oc_feed->get_conversionName(),
        $oc_feed->get_googleClickId();
    }
  } else {
    print "No offline conversion were added.\n";
    return;
  }

  return 1;
}

C#

public void Run(AdWordsUser user, String conversionName, String gClid, String conversionTime,
    double conversionValue) {
  using (OfflineConversionFeedService offlineConversionFeedService =
      (OfflineConversionFeedService) user.GetService(
          AdWordsService.v201802.OfflineConversionFeedService)) {

    try {
      // 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.
      OfflineConversionFeed feed = new OfflineConversionFeed();
      feed.conversionName = conversionName;
      feed.conversionTime = conversionTime;
      feed.conversionValue = conversionValue;
      feed.googleClickId = gClid;

      // Optional: To upload fractional conversion credits, set the external attribution model
      // and credit. To use this feature, your conversion tracker should be marked as externally
      // attributed. See
      // https://developers.google.com/adwords/api/docs/guides/conversion-tracking#importing_externally_attributed_conversions
      // to learn more about importing externally attributed conversions.

      // feed.externalAttributionModel = "Linear";
      // feed.externalAttributionCredit = 0.3;

      OfflineConversionFeedOperation offlineConversionOperation =
          new OfflineConversionFeedOperation();
      offlineConversionOperation.@operator = Operator.ADD;
      offlineConversionOperation.operand = feed;

      OfflineConversionFeedReturnValue offlineConversionRetval =
          offlineConversionFeedService.mutate(
              new OfflineConversionFeedOperation[] { offlineConversionOperation });

      OfflineConversionFeed newFeed = offlineConversionRetval.value[0];

      Console.WriteLine("Uploaded offline conversion value of {0} for Google Click ID = " +
          "'{1}' to '{2}'.", newFeed.conversionValue, newFeed.googleClickId,
          newFeed.conversionName);
    } catch (Exception e) {
      throw new System.ApplicationException("Failed upload offline conversions.", e);
    }
  }
}

VB

''' <summary>
''' Runs the code example.
''' </summary>
''' <param name="user">The AdWords user.</param>
''' <param name="conversionName">The name of the upload conversion to be
''' created.</param>
''' <param name="gClid">The Google Click ID of the click for which offline
''' conversions are uploaded.</param>
''' <param name="conversionValue">The conversion value to be uploaded.
''' </param>
''' <param name="conversionTime">The conversion time, in yyyymmdd hhmmss
''' format.</param>
Public Sub Run(ByVal user As AdWordsUser, ByVal conversionName As String,
    ByVal gClid As String, ByVal conversionTime As String, ByVal conversionValue As Double)
  Using offlineConversionFeedService As OfflineConversionFeedService = CType(user.GetService(
      AdWordsService.v201802.OfflineConversionFeedService),
          OfflineConversionFeedService)

    Try
      ' 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.
      Dim feed As New OfflineConversionFeed()
      feed.conversionName = conversionName
      feed.conversionTime = conversionTime
      feed.conversionValue = conversionValue
      feed.googleClickId = gClid

      ' Optional: To upload fractional conversion credits, set the external attribution model
      ' and credit. To use this feature, your conversion tracker should be marked as externally
      ' attributed. See
      ' https://developers.google.com/adwords/api/docs/guides/conversion-tracking#importing_externally_attributed_conversions
      ' to learn more about importing externally attributed conversions.

      ' feed.externalAttributionModel = "Linear"
      ' feed.externalAttributionCredit = 0.3

      Dim offlineConversionOperation As New OfflineConversionFeedOperation()
      offlineConversionOperation.operator = [Operator].ADD
      offlineConversionOperation.operand = feed

      Dim offlineConversionRetval As OfflineConversionFeedReturnValue =
        offlineConversionFeedService.mutate(
            New OfflineConversionFeedOperation() {offlineConversionOperation})

      Dim newFeed As OfflineConversionFeed = offlineConversionRetval.value(0)

      Console.WriteLine("Uploaded offline conversion value of {0} for Google Click ID = " &
          "'{1}' to '{2}'.", newFeed.conversionValue, newFeed.googleClickId,
          newFeed.conversionName)
    Catch e As Exception
      Throw New System.ApplicationException("Failed to upload offline conversions.", e)
    End Try
  End Using
End Sub

Como importar conversões atribuídas externamente

Se você usar ferramentas de terceiros ou soluções desenvolvidas internamente para acompanhar conversões, atribua ao Google AdWords apenas parte do crédito pela conversão. Às vezes, você também pode distribuir o crédito de uma conversão em vários cliques do Google AdWords. Com as importações de conversões atribuídas externamente, você pode fazer o upload de conversões com créditos fracionários atribuídos a cada gclid.

Para fazer upload de créditos fracionários, você precisa seguir as instruções para fazer o upload de conversões off-line e realizar as seguintes etapas adicionais:

  1. Ao criar seu objeto UploadConversion, marque-o como atribuído externamente, definindo a propriedade isExternallyAttributed como true.

  2. Especifique as propriedades externalAttributionModel e externalAttributionCredit para o objeto OfflineConversionFeed quando fizer o upload das conversões.

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 . 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 IU 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 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 , que pode ser de qualquer fuso horário válido, ou seja, o código 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.

  • As conversões enviadas serão refletidas nos relatórios da data de impressão do clique original, não na data da solicitação de upload ou na data do conversionTime dos OfflineConversionFeeds.

  • 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 para atribuição de último clique. Para outros modelos de atribuição de pesquisa, pode demorar mais tempo.

  • Ao fazer o upload de conversões de cliques para várias contas, você pode especificar o clientCustomerId de uma conta de administrador comum e incluir operações com GCLIDs de várias contas. Uma conversão é atribuída à conta adequada com base na origem do GCLID.

  • Ao fazer o upload de conversões de cliques com o acompanhamento de conversões de várias contas ativado, o tipo de conversão precisa estar na conta de administrador, e não na conta associada ao GCLID.

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:

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 criar esses tipos de conversão usando a IU do Google AdWords ou por meio deste 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());
  }
}

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

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='v201802')

  # 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.'

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

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::v201802::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::v201802::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;
}

C#

public void Run(AdWordsUser user, String conversionName, String callStartTime, String callerId,
    String conversionTime, double conversionValue) {
  using (OfflineCallConversionFeedService offlineCallConversionFeedService =
       (OfflineCallConversionFeedService) user.GetService(
           AdWordsService.v201802.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);
    }
  }
}

VB

Using offlineCallConversionFeedService As OfflineCallConversionFeedService =
    CType(user.GetService(AdWordsService.v201802.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

Regras de validação

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

Para evitar um erro OfflineCallConversionError.INVALID_CONVERSION_TYPE, o 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 . 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 IU 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 , que pode ser de qualquer fuso horário válido, ou seja, o código 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:

Como importar conversões diretas de vendas na loja

Você pode usar a Google AdWords API para fazer o upload das conversões diretas de vendas da loja para o Google AdWords.

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. Para criá-las, use somente a IU do Google AdWords. O conversionName fornecido é um identificador exclusivo para esse evento de conversão. Depois de criar seus tipos de conversão de importação, você poderá começar a fazer o upload de conversões diretas de vendas na loja usando a IU ou a Google AdWords API.

Como fazer o upload de conversões diretas de vendas na loja

Depois de criar o acompanhamento de conversão, é necessário associar as conversões de vendas diretas na loja a ele passando o nome da conversão e as transações na loja no objeto OfflineDataUpload por meio do OfflineDataUploadService.

Regras de validação

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

Para evitar um erro OfflineDataUploadError.INVALID_CONVERSION_TYPE, o conversionName precisa se referir a um rastreador de conversões em que:

  • O rastreador de conversões foi ativado no momento do clique.

  • O rastreador de conversões existia na conta de conversão efetiva da conta do Google AdWords do 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 rastreador de conversões 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 IU 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:

  • O transactionAmount precisa ser maior que zero.

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

Exemplos de código

A pasta Remarketing de cada biblioteca cliente contém um exemplo de código para fazer o upload de dados 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.