Google Analytics
Qual versão do Analytics usar
A integração com o Google Analytics funciona apenas para a versão Universal Analytics.
Novas propriedades são criadas por padrão na versão GA4. Nossas solicitações serão ignoradas.
Você precisa criar o Analytics com a chave ativada (como mostrado na captura de tela abaixo)
Como criar e definir uma propriedade em uma mini-landing
Crie uma propriedade em https://analytics.google.com/
Acesse Informações de rastreamento -> Código de rastreamento
Copie o código e cole-o no head da mini-landing
Para facilitar o trabalho futuro, é recomendável adicionar propriedades às mini-landings usando o Google Tag Manager, mas isso não é obrigatório.
Em seguida, você precisa encontrar o Tracking ID nas configurações da propriedade
Copie o Tracking ID, depois abra as configurações do projeto no Salebot e salve o ID em Constantes do Projeto com o nome de google_tracking_id:
Como compartilhar o Google Client ID(_ga) da mini-landing com variáveis
Para compartilhar o client id, você precisa marcar Google Client ID(_ga) nas configurações da mini-landing. Após o lançamento do bot, a variável _ga aparecerá.
Como transferir dados do GA do Salebot
Durante a chamada da função para transferir dados para o Google Analytics, alguns parâmetros são compartilhados será automaticamente, as informações abaixo são mostradas para dar uma ideia geral de como a função funciona.
Para as funções ga_pageview e ga_transaction_pageview o parâmetro “t”: “pageview” é transferido
Para as funções ga_event e ga_transaction_event o parâmetro “t”: “event” é transferido
Para as funções ga_transaction_pageview e ga_transaction_event o parâmetro “pa” com o valor “purchase” também é transferido.
Além disso, ao chamar todas as funções, o parâmetro cid é transferido automaticamente - é o client id para analytics. Se o usuário entrou no bot pela mini-landing, como mostrado acima, então o id é salvo automaticamente nas variáveis do projeto, na variável _ga
Se o cartão do cliente não tiver essa variável, ela é gerada automaticamente como uma sequência aleatória de números, mas nesse caso é recomendável transferir a origem do tráfego nas configurações avançadas (mostrado abaixo - Como redefinir a origem)
Como redefinir a origem
Se você precisar definir manualmente a origem do tráfego para o seu evento, você pode adicionar qualquer tipo de solicitação com os seguintes parâmetros. O dicionário abaixo não é independente - ele é usado apenas ao chamar as funções mencionadas no campo Parâmetros avançados.
'{ "cs":"#{utm_source}", "cm":"#{utm_medium}", "cn":"#{utm_campaign}", "ck":"#{utm_term}", "cc":"#{utm_content}"}'
Documentação sobre os parâmetros:
Como usar solicitações do tipo Events (t:events)
Eles são usados no Google Analytics para determinados eventos. Você pode configurar as metas no GA; elas são acionadas quando certos eventos acontecem (ou seja, nem todos os eventos compartilhados precisam necessariamente ser uma meta).
Você pode encontrar os eventos na seção Comportamento -> Eventos -> Principais eventos
Como configurar metas de eventos
Você pode configurar metas para etapas importantes do fluxo de trabalho e usá-las para rastrear conversões entre as etapas. As metas são configuradas na seção Conversões -> Metas
Como transferir eventos
Para transferir um evento no GA, você precisa, ao passar para uma etapa diferente, chamar a função ga_event() com os parâmetros necessários no campo do calculador.
ga_event (‘category’, ‘event action’, ‘label’, ‘event value’, ‘{“parameter name”: “value”, “parameter name 2”: “value 2”}’)
Esclarecimento sobre os parâmetros do exemplo acima:
category - categoria do evento (parâmetro obrigatório) event action - parâmetro obrigatório label - o valor do evento é transferido como números inteiros e é registrado na moeda definida nas configurações de aquisição o dicionário com parâmetros adicionais; exemplo: '{"ti":"#{order_id}", "tr":"25", "tcc":"#{promocode}"}'
Exemplo da chamada da função:
ga_event('sale', 'list viewing’) ga_event('Salebot', 'Enter bot', '#{tag}', '100', '{"ti":"#{order_id}", "tr":"#{price}", "tcc":"#{promocode}"}') ga_event('Salebot', 'Enter bot', '#{tag}', '100') ga_event('Salebot', 'Enter bot', "", '20')
Como usar solicitações do tipo Page View (t:pageview)
Ao transferir dados de visualização de página, você imita uma visita do usuário ao site. Para ver um relatório padrão das páginas, vá para Comportamento -> Conteúdo do site
Se você configurar uma meta para visitas às páginas, pode obter um fluxo de trabalho virtual seguindo a ramificação do bot sem sair do Google Analytics.
Um exemplo da configuração:
O vantagem deste método é a representação visual do movimento do fluxo de trabalho sem precisar sair do Analytics.
O desvantagem, porém, é o fato de que você está essencialmente transferindo apenas um parâmetro - a visita a um bloco. Dados adicionais, como Label ou Value, como nas solicitações de Evento, não podem ser transferidos assim.
Para transferir dados sobre a visualização da página no GA ao mover para um bloco, é essencial chamar a função ga_pageview() com os parâmetros necessários no campo do calculador.
ga_pageview(‘URL page path’, ‘title’, ‘{“parameter name”: “value”, “parameter name 2”: “value 3”}’)
Esclarecimento sobre os parâmetros do exemplo acima:
URL page path - a parte da URL que contém seu caminho title - o título da página/documento um dicionário com parâmetros adicionais com esta estrutura: ‘{“parameter name”: “value”, “parameter name 2”: “value 2”}’
Exemplo da chamada da função:
ga_pageview('/start, 'Entry point') ga_pageview('/pay', ‘Sale’, '{"cd1": "High Scores"}')
Para a transferência de parâmetros adicionais, consulte a documentação vinculada abaixo. Lá você pode encontrar todos os parâmetros possíveis com descrições detalhadas:
Como usar E-commerce
A configuração de E-commerce na aba All Web Site Data
Os parâmetros de E-commerce precisam ser enviados como as solicitações existentes (pageview, event)
Existem duas funções para isso: ga_transaction_pageview e ga_transaction_event. Mais sobre elas abaixo.
A função ga_transaction_pageview
Os parâmetros obrigatórios estão em negrito:
ga_transaction_pageview('transaction id', 'total income’, 'URL page path', ‘title’, 'list of products’, 'dictionary of additional parameters’)
Esclarecimento sobre os parâmetros do exemplo acima:
transaction id - o ID único da transação total income - a receita total vinculada à transação URL page path - a parte da URL que contém seu caminho title - o título da página/documento list of products - o array de produtos desta estrutura: '[["id", "name", "price", "amount"], ["id", "name", "price", "amount"]]' um dicionário com parâmetros adicionais com esta estrutura: ‘{“parameter name”: “value”, “parameter name 2”: “value 2”}’
Exemplo da chamada da função:
ga_transaction_pageview('#{order_id}', '2200', '/send', ‘Received’, '[["222", "Rate1", "1200", "1"], ["223", "AdditionalRate", "1000", "1"]]') ga_transaction_pageview('123', '100', '/pay', 'Payed', '', '{"cd": "High Scores", "cs":"#{utm_source}", "cm":"#{utm_medium}", "cn":"#{utm_campaign}"}' )
O array de produtos é o seguinte: array de arrays:
'[["product_id", "product name", "product price", "amount of products"], ["product_id", "product name", "product price", "amount of products"]]'
Cada produto deve ter 4 parâmetros, o array inteiro entre aspas simples (‘), os parâmetros internos entre aspas duplas (“)
A função ga_transaction_event
Os parâmetros obrigatórios estão em negrito:
ga_transaction_event('transaction id', 'transaction income’, 'event category', ‘event action’, ‘event tag', 'event importance', 'list of products’, 'additional parameters’)
Esclarecimento sobre os parâmetros do exemplo acima:
transaction id - o ID único da transação total income - a receita total vinculada à transação event category, event action, event tag - parâmetros obrigatórios event importance - transferido em números inteiros e registrado na mesma moeda em que está definida nas configurações de visualização list of products - o array de produtos desta estrutura: '[["id", "name", "price", "amount"], ["id", "name", "price", "amount"]]' um dicionário com parâmetros adicionais com esta estrutura: ‘{“parameter name”: “value”, “parameter name 2”: “value 2”}’
Exemplo da chamada da função:
ga_transaction_event('1244', '121.2', 'category1', 'action', 'tag', '10', '[["11", "Product1", "1.2", "1"], ["22", "Product2", "120", "1"]]')
ga_transaction_event('1244', '1.2', 'category1', 'action', '', '', '[["11", "Product1", "1.20", "1"]]')
ga_transaction_event('1244', '121.2', 'category1', 'action', 'tag', '10', '[["11", "Product1", "1.2", "1"], ["22", "Product2", "120", "1"]]', '{"ta": "Google Store", "cs":"#{utm_source}", "cm":"#{utm_medium}", "cn":"#{utm_campaign}"}' )
O array de produtos é o seguinte: array de arrays:
'[["product_id", "product name", "product price", "amount of products"], ["product_id", "product name", "product price", "amount of products"]]'
Cada produto deve ter 4 parâmetros, o array inteiro entre aspas simples (‘), os parâmetros internos entre aspas duplas (“)
Tutorial em vídeo
Atualizado