# Google Analytics
* [Qual versão do Analytics usar](#which-version-of-the-analytics-to-use)
* [Como criar e definir uma propriedade em uma mini-landing ](#how-to-create-and-set-a-property-on-a-mini-landing)
* [Como compartilhar o Google Client ID(\_ga) da mini-landing com variáveis](#how-to-share-google-client-id-_ga-from-the-mini-landing-with-variables)
* [Como transferir dados do GA do Salebot](#how-to-transfer-ga-data-from-salebot)
* [Como configurar metas de eventos ](#how-to-configure-event-goals)
* [Como transferir eventos ](#how-to-transfer-events)
* [Como usar solicitações do tipo Page View (t:pageview)](#how-to-use-requests-of-the-page-view-type-t-pageview)
* [Como usar E-commerce](#how-to-use-e-commerce)
* [Tutorial em vídeo](#video-tutorial)
## Qual versão do Analytics usar
{% hint style="warning" %}
A integração com o Google Analytics funciona apenas para a versão Universal Analytics.
{% endhint %}
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
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:
{% embed url="" %}
## 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:
{% embed url="" %}
## Como usar E-commerce
A configuração de E-commerce na aba All Web Site Data
{% hint style="warning" %}
Os parâmetros de E-commerce precisam ser enviados como as solicitações existentes (pageview, event)
{% endhint %}
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
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://docs.mavibot.ai/doc/pt/integrations/other/analytics/google.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.