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 na versão GA4 por padrão. Nossas requisições serão ignoradas.

Você precisa criar um analytics com a opção ativada (conforme mostrado na captura de tela abaixo)

Como criar e configurar uma propriedade em uma mini-landing

Crie uma propriedade em https://analytics.google.com/

Vá para Informações de rastreamento -> Código de rastreamento

Copie o código e cole-o no cabeçalho da mini-landing

Para facilitar o trabalho futuro, é recomendado adicionar propriedades às mini-landings usando o Google Tag Manager, mas não é obrigatório.

Em seguida, você precisa encontrar o ID de rastreamento nas configurações da propriedade

Copie o ID de rastreamento, depois abra as configurações do projeto no Salebot e salve o ID nas 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 ID do cliente, você precisa marcar a opção Google Client ID(_ga) nas configurações da mini-landing. Após a inicialização 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 automaticamente. As informações abaixo são fornecidas 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” é transferido adicionalmente.

Além disso, ao chamar todas as funções, o parâmetro cid é transferido automaticamente - é o ID do cliente para o analytics. Se o usuário entrou no bot a partir da mini-landing, conforme mostrado acima, 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 linha aleatória de números, mas nesse caso é recomendado transferir a fonte de tráfego nas configurações avançadas (mostrado abaixo - Como redefinir a fonte)

Como redefinir a fonte

Se você precisar definir a fonte de tráfego para seu evento manualmente, você pode adicionar qualquer tipo de requisição com os seguintes parâmetros. O dicionário abaixo não é independente - é 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:

https://developers.google.com/analytics/devguides/collection/protocol/v1/parameters?hl=en#trafficsources

Como usar requisições do tipo Events (t:events)

Elas são usadas no Google Analytics para eventos específicos. Você pode configurar as metas no GA, que são fixadas quando certos eventos ocorrem (ou seja, nem todos os eventos compartilhados precisam ser necessariamente uma meta).

Você pode encontrar os eventos na seção Comportamento -> Eventos -> Principais Eventos

Como configurar metas de evento

Você pode configurar metas para etapas importantes do fluxo de trabalho e usá-las para rastrear conversões entre etapas. As metas são configuradas na seção Conversões -> Metas

Como transferir eventos

Para transferir um evento no GA, você precisa, ao mover para um estágio diferente, chamar a função ga_event() com os parâmetros necessários no campo calculadora.

ga_event(‘categoria’, ‘ação do evento’, ‘rótulo’, ‘valor do evento’, ‘{“nome do parâmetro”: “valor”, “nome do parâmetro 2”: “valor 2”}’)

Esclarecimento sobre os parâmetros do exemplo acima:

categoria - categoria do evento (parâmetro obrigatório)
ação do evento - parâmetro obrigatório
rótulo - rótulo do evento. 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 de chamada da função:

ga_event('venda', 'visualização de lista')
ga_event('Salebot', 'Entrar no bot', '#{tag}', '100', '{"ti":"#{order_id}", "tr":"#{price}", "tcc":"#{promocode}"}')
ga_event('Salebot', 'Entrar no bot', '#{tag}', '100')
ga_event('Salebot', 'Entrar no bot', "", '20')

Como usar requisições do tipo Page View (t:pageview)

Ao transferir dados de visualização de página, você imita uma visita do usuário da página web. Para ver um relatório padrão das páginas, vá para Comportamento -> Conteúdo do Site

Se você configurar uma meta para visitar páginas, pode obter um fluxo de trabalho virtual de seguir o ramo do bot sem sair do Google Analytics.

Um exemplo de configuração:

A vantagem deste método é a representação visual do movimento do fluxo de trabalho sem precisar sair do Analytics.

A desvantagem, no entanto, é o fato de que você está essencialmente transferindo apenas um parâmetro - a visita a um bloco. Dados adicionais como Rótulo ou Valor, como nas requisições de Evento, não podem ser transferidos dessa forma.

Para transferir dados de visualização de página no GA ao mover para um bloco, é essencial chamar a função ga_pageview() com os parâmetros necessários no campo calculadora.

ga_pageview(‘caminho da URL da página’, ‘título’, ‘{“nome do parâmetro”: “valor”, “nome do parâmetro 2”: “valor 3”}’)

Esclarecimento sobre os parâmetros do exemplo acima:

caminho da URL da página - a parte da URL que contém seu caminho
título - o título da página/documento
um dicionário com parâmetros adicionais desta estrutura: ‘{“nome do parâmetro”: “valor”, “nome do parâmetro 2”: “valor 2”}’

Exemplo de chamada da função:

ga_pageview('/start, 'Ponto de entrada')
ga_pageview('/pay', ‘Venda’, '{"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:

https://developers.google.com/analytics/devguides/collection/protocol/v1/parameters?hl=en#content

Como usar E-commerce

A configuração do E-commerce está na aba Todos os Dados do Site

Os parâmetros do E-commerce precisam ser enviados como requisições existentes (pageview, event)

Existem duas funções para este propósito: 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('ID da transação', 'receita total’, 'caminho da URL da página', ‘título’, 'lista de produtos’, 'dicionário de parâmetros adicionais’)

Esclarecimento sobre os parâmetros do exemplo acima:

ID da transação - o ID único da transação
receita total - a receita total vinculada à transação
caminho da URL da página - a parte da URL que contém seu caminho
título - o título da página/documento
lista de produtos - o array de produtos desta estrutura: '[["id", "nome", "preço", "quantidade"], ["id", "nome", "preço", "quantidade"]]'
um dicionário com parâmetros adicionais desta estrutura: ‘{“nome do parâmetro”: “valor”, “nome do parâmetro 2”: “valor 2”}’

Exemplo de chamada da função:

ga_transaction_pageview('#{order_id}', '2200', '/send', ‘Recebido’, '[["222", "Tarifa1", "1200", "1"], ["223", "TarifaAdicional", "1000", "1"]]')

ga_transaction_pageview('123', '100', '/pay', 'Pago', '', '{"cd": "High Scores", "cs":"#{utm_source}", "cm":"#{utm_medium}", "cn":"#{utm_campaign}"}' )

O array de produtos é o seguinte: array de arrays:

'[["product_id", "nome do produto", "preço do produto", "quantidade de produtos"], ["product_id", "nome do produto", "preço do produto", "quantidade de produtos"]]'

Cada produto deve ter 4 parâmetros, todo o array 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('ID da transação', 'receita da transação’, 'categoria do evento', ‘ação do evento’, 'tag do evento', 'importância do evento', 'lista de produtos’, 'parâmetros adicionais’)

Esclarecimento sobre os parâmetros do exemplo acima:

ID da transação - o ID único da transação
receita total - a receita total vinculada à transação
categoria do evento, ação do evento, tag do evento - parâmetros obrigatórios
importância do evento - transferida em números inteiros e registrada na mesma moeda definida nas configurações de visualização
lista de produtos - o array de produtos desta estrutura: '[["id", "nome", "preço", "quantidade"], ["id", "nome", "preço", "quantidade"]]'
um dicionário com parâmetros adicionais desta estrutura: ‘{“nome do parâmetro”: “valor”, “nome do parâmetro 2”: “valor 2”}’

Exemplo de chamada da função:

ga_transaction_event('1244', '121.2', 'categoria1', 'ação', 'tag', '10', '[["11", "Produto1", "1.2", "1"], ["22", "Produto2", "120", "1"]]')

ga_transaction_event('1244', '1.2', 'categoria1', 'ação', '', '', '[["11", "Produto1", "1.20", "1"]]')

ga_transaction_event('1244', '121.2', 'categoria1', 'ação', 'tag', '10', '[["11", "Produto1", "1.2", "1"], ["22", "Produto2", "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", "nome do produto", "preço do produto", "quantidade de produtos"], ["product_id", "nome do produto", "preço do produto", "quantidade de produtos"]]'

Cada produto deve ter 4 parâmetros, todo o array entre aspas simples (‘), os parâmetros internos - entre aspas duplas (“)

Tutorial em vídeo