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:
- Cliques no número de telefone correspondem ao
AdWordsConversionTracker
(comtrackingCodeType
comoCLICK_TO_CALL
). - Chamadas a partir de anúncios correspondem a
AdCallMetricsConversion
. - Chamadas a partir de sites correspondem a
WebsiteCallMetricsConversion
.
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:
- 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.
- 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.
- 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:
-
Ao criar seu objeto
UploadConversion
, marque-o como atribuído externamente, definindo a propriedadeisExternallyAttributed
comotrue
. -
Especifique as propriedades
externalAttributionModel
eexternalAttributionCredit
para o objetoOfflineConversionFeed
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
apresentavastatus
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á oUploadConversion
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 erroOfflineConversionError.CONVERSION_PRECEDES_CLICK
. -
conversionTime
precisa ser antes da especificada por você no objetoUploadConversion
para evitar um erroOfflineConversionError.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
dosOfflineConversionFeeds
. -
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:
Java
Fazer upload de conversões off-linePHP
Fazer upload de conversões off-linePython
Fazer upload de conversões off-lineRuby
Fazer upload de conversões off-linePerl
Fazer upload de conversões off-lineC#
Fazer upload de conversões off-lineVB
Fazer upload de conversões off-lineComo 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
apresentavastatus
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á oUploadCallConversion
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:
Java
Fazer upload de conversões de chamada off-linePHP
Fazer upload de conversões de chamada off-linePython
Fazer upload de conversões de chamada off-lineRuby
Fazer upload de conversões de chamada off-linePerl
Fazer upload de conversões de chamada off-lineC#
Fazer upload de conversões de chamada off-lineVB
Fazer upload de conversões de chamada off-lineComo 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: