¿Qué versión de analytics usar?

La integración con Google Analytics solo funciona para la versión Universal Analytics.

Las nuevas propiedades se crean por defecto en la versión GA4. Nuestras solicitudes serán ignoradas.

Debes crear analytics con el interruptor activado (como se muestra en la captura de pantalla a continuación)

Cómo crear y configurar una propiedad en una mini-landing

Crea una propiedad en https://analytics.google.com/

Ve a Información de seguimiento -> Código de seguimiento

Copia el código y pégalo en el head de la mini-landing

Para facilitar el trabajo posterior, se recomienda agregar propiedades a las mini-landings usando Google Tag Manager, pero no es obligatorio.

A continuación, debes encontrar el ID de seguimiento en la configuración de la propiedad

Copia el ID de seguimiento, luego abre la configuración del proyecto en Mavibot y guarda el ID en las Constantes del Proyecto con el nombre google_tracking_id:

Cómo compartir el ID de cliente de Google (_ga) desde la mini-landing con variables

Para compartir el ID de cliente, debes marcar la opción ID de cliente de Google (_ga) en la configuración de la mini-landing. Después del lanzamiento del bot, aparecerá la variable _ga.

Cómo transferir datos de GA desde Mavibot

Durante la llamada a la función para transferir datos a Google Analytics, algunos parámetros se comparten automáticamente. La información a continuación se muestra para tener una idea general de cómo funciona la función.

Para las funciones ga_pageview y ga_transaction_pageview se transfiere el parámetro “t”: “pageview”

Para las funciones ga_event y ga_transaction_event se transfiere el parámetro “t”: “event”

Para las funciones ga_transaction_pageview y ga_transaction_event se transfiere adicionalmente el parámetro “pa” con el valor “purchase”.

Además, al llamar a todas las funciones, el parámetro cid se transfiere automáticamente: es el ID de cliente para analytics. Si el usuario ingresó al bot desde la mini-landing, como se mostró anteriormente, el ID se guarda automáticamente en las variables del proyecto, en la variable _ga

Si la tarjeta del cliente no tiene esta variable, se genera automáticamente como una línea aleatoria de números, pero en ese caso se recomienda transferir la fuente de tráfico en la configuración avanzada (se muestra a continuación: Cómo redefinir la fuente)

Cómo redefinir la fuente

Si necesitas establecer la fuente de tráfico para tu evento manualmente, puedes agregar cualquier tipo de solicitud con los siguientes parámetros. El diccionario a continuación no es independiente: se usa solo al llamar a las funciones mencionadas en el campo Parámetros avanzados.

'{ "cs":"#{utm_source}", "cm":"#{utm_medium}", "cn":"#{utm_campaign}", "ck":"#{utm_term}", "cc":"#{utm_content}"}'

Documentación sobre los parámetros:

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

Cómo usar solicitudes del tipo Events (t:events)

Se usan en Google Analytics para ciertos eventos. Puedes configurar los objetivos en GA, que se fijan cuando ocurren ciertos eventos (es decir, no todos los eventos compartidos tienen que ser un objetivo necesariamente).

Puedes encontrar los eventos en la sección Comportamiento -> Eventos -> Eventos principales

Cómo configurar objetivos de eventos

Puedes configurar objetivos para pasos importantes del flujo de trabajo y usarlos para rastrear conversiones entre pasos. Los objetivos se configuran en la sección Conversiones -> Objetivos

Cómo transferir eventos

Para transferir un evento en GA, al pasar a una etapa diferente, debes llamar a la función ga_event() con los parámetros necesarios en el campo de la calculadora.

ga_event(‘categoría’, ‘acción del evento’, ‘etiqueta’, ‘valor del evento’, ‘{“nombre del parámetro”: “valor”, “nombre del parámetro 2”: “valor 2”}’)

Aclaración sobre los parámetros del ejemplo anterior:

categoría - categoría del evento (parámetro obligatorio)
acción del evento - parámetro obligatorio
etiqueta - etiqueta del evento; el valor del evento se transfiere como enteros y se escribe como la moneda configurada en la configuración de adquisición
el diccionario con parámetros adicionales; ejemplo: '{"ti":"#{order_id}", "tr":"25", "tcc":"#{promocode}"}'

Ejemplo de llamada a la función:

ga_event('venta', 'visualización de lista')
ga_event('Mavibot', 'Entrar al bot', '#{tag}', '100', '{"ti":"#{order_id}", "tr":"#{price}", "tcc":"#{promocode}"}')
ga_event('Mavibot', 'Entrar al bot', '#{tag}', '100')
ga_event('Mavibot', 'Entrar al bot', "", '20')

Cómo usar solicitudes del tipo Page View (t:pageview)

Al transferir datos de visualización de página, imitas una visita del usuario a la página web. Para ver un informe estándar de las páginas, ve a Comportamiento -> Contenido del sitio

Si configuras un objetivo para visitar páginas, puedes obtener un flujo de trabajo virtual de seguir la rama del bot sin salir de Google Analytics.

Un ejemplo de configuración:

La ventaja de este método es la representación visual del movimiento del flujo de trabajo sin tener que salir de Analytics.

La desventaja, sin embargo, es que esencialmente solo estás transfiriendo un parámetro: la visita a un bloque. Datos adicionales como Etiqueta o Valor, como en las solicitudes de Evento, no se pueden transferir de esta manera.

Para transferir datos sobre la visualización de la página en GA al moverse a un bloque, es esencial llamar a la función ga_pageview() con los parámetros necesarios en el campo de la calculadora.

ga_pageview(‘ruta de la URL de la página’, ‘título’, ‘{“nombre del parámetro”: “valor”, “nombre del parámetro 2”: “valor 3”}’)

Aclaración sobre los parámetros del ejemplo anterior:

ruta de la URL de la página - la parte de la URL que contiene su ruta
título - el título de la página/documento
un diccionario con parámetros adicionales de esta estructura: ‘{“nombre del parámetro”: “valor”, “nombre del parámetro 2”: “valor 2”}’

Ejemplo de llamada a la función:

ga_pageview('/inicio, 'Punto de entrada')
ga_pageview('/pago', ‘Venta’, '{"cd1": "High Scores"}')

Para la transferencia de parámetros adicionales, consulta la documentación enlazada a continuación. Allí puedes encontrar todos los parámetros posibles con descripciones detalladas:

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

Cómo usar E-commerce

La configuración de E-commerce se encuentra en la pestaña Todos los datos del sitio web

Los parámetros de E-commerce deben enviarse como las solicitudes existentes (pageview, event)

Hay dos funciones para este propósito: ga_transaction_pageview y ga_transaction_event. Más información a continuación.

La función ga_transaction_pageview

Los parámetros obligatorios están en negrita:

ga_transaction_pageview('ID de transacción', 'ingreso total’, 'ruta de la URL de la página', ‘título’, 'lista de productos’, 'diccionario de parámetros adicionales’)

Aclaración sobre los parámetros del ejemplo anterior:

ID de transacción - el ID único de la transacción
ingreso total - el ingreso total asociado a la transacción
ruta de la URL de la página - la parte de la URL que contiene su ruta
título - el título de la página/documento
lista de productos - el array de productos de esta estructura: '[["id", "nombre", "precio", "cantidad"], ["id", "nombre", "precio", "cantidad"]]'
un diccionario con parámetros adicionales de esta estructura: ‘{“nombre del parámetro”: “valor”, “nombre del parámetro 2”: “valor 2”}’

Ejemplo de llamada a la función:

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

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

El array de productos es el siguiente: array de arrays:

'[["product_id", "nombre del producto", "precio del producto", "cantidad de productos"], ["product_id", "nombre del producto", "precio del producto", "cantidad de productos"]]'

Cada producto debe tener 4 parámetros, todo el array entre comillas simples (‘), los parámetros internos entre comillas dobles (“)

La función ga_transaction_event

Los parámetros obligatorios están en negrita:

ga_transaction_event('ID de transacción', 'ingreso de transacción’, 'categoría del evento', ‘acción del evento', 'etiqueta del evento', 'importancia del evento', 'lista de productos’, 'parámetros adicionales’)

Aclaración sobre los parámetros del ejemplo anterior:

ID de transacción - el ID único de la transacción
ingreso total - el ingreso total asociado a la transacción
categoría del evento, acción del evento, etiqueta del evento - parámetros obligatorios
importancia del evento - se transfiere en números enteros y se escribe en la misma moneda configurada en la configuración de visualización
lista de productos - el array de productos de esta estructura: '[["id", "nombre", "precio", "cantidad"], ["id", "nombre", "precio", "cantidad"]]'
un diccionario con parámetros adicionales de esta estructura: ‘{“nombre del parámetro”: “valor”, “nombre del parámetro 2”: “valor 2”}’

Ejemplo de llamada a la función:

ga_transaction_event('1244', '121.2', 'categoría1', 'acción', 'etiqueta', '10', '[["11", "Producto1", "1.2", "1"], ["22", "Producto2", "120", "1"]]')

ga_transaction_event('1244', '1.2', 'categoría1', 'acción', '', '', '[["11", "Producto1", "1.20", "1"]]')

ga_transaction_event('1244', '121.2', 'categoría1', 'acción', 'etiqueta', '10', '[["11", "Producto1", "1.2", "1"], ["22", "Producto2", "120", "1"]]', '{"ta": "Google Store", "cs":"#{utm_source}", "cm":"#{utm_medium}", "cn":"#{utm_campaign}"}' )

El array de productos es el siguiente: array de arrays:

'[["product_id", "nombre del producto", "precio del producto", "cantidad de productos"], ["product_id", "nombre del producto", "precio del producto", "cantidad de productos"]]'

Cada producto debe tener 4 parámetros, todo el array entre comillas simples (‘), los parámetros internos entre comillas dobles (“)

Video tutorial