Este artículo proporciona una guía detallada sobre cómo integrar Google Analytics 4 (GA4) con Scanova. Explica los escenarios de seguimiento, los pasos de configuración, las credenciales necesarias y cómo analizar los datos de escaneo y participación de códigos QR en GA4.
Introducción
Integrar Scanova con Google Analytics 4 (GA4) permite a las organizaciones medir eficazmente el rendimiento de los códigos QR y la participación de los usuarios. Dependiendo de cómo se desplieguen los códigos QR, el seguimiento en GA4 se comporta de manera diferente.
Si los códigos QR redirigen a los usuarios a sitios web externos donde GA4 está instalado, GA4 captura automáticamente datos detallados del usuario. Sin embargo, para las páginas de destino alojadas en Scanova, los datos de participación se envían mediante API, y GA4 solo refleja los eventos específicos transmitidos.
Este artículo describe el proceso completo para configurar la integración con GA4, obtener las credenciales necesarias, habilitar el seguimiento de eventos y analizar los datos dentro de GA4.
A. Comprensión de los escenarios de seguimiento en GA4
El seguimiento del rendimiento de los códigos QR en GA4 depende de cómo se utilice el código QR. Los siguientes son los dos posibles escenarios:
A.1 Tráfico dirigido por código QR al sitio web
En este escenario, los códigos QR redirigen a los usuarios a una página web externa donde el seguimiento de GA4 ya está implementado.
- Cuando un usuario escanea el código QR, es redirigido a la página web de destino
- GA4 registra automáticamente la visita como parte de su seguimiento estándar
GA4 recopila automáticamente las siguientes perspectivas adicionales:
- Geografía del usuario (país, ciudad, región)
- Tipo de dispositivo (móvil, tableta, escritorio)
- Sistema operativo (Android, iOS, Windows, etc.)
- Navegador (Chrome, Safari, etc.)
- Información demográfica disponible
Este método proporciona análisis completos ya que GA4 rastrea directamente las sesiones de usuario en el sitio web de destino.
A.2 Clics y participación en páginas de destino de Scanova
En este escenario, los códigos QR conducen a páginas de destino alojadas en Scanova.
- Se rastrean las interacciones del usuario (como clics en botones)
- Los datos de participación se envían a GA4 mediante la API Measurement Protocol
Características clave de esta configuración:
- GA4 recibe solo los datos de eventos enviados explícitamente por Scanova
- No hay seguimiento automático de atributos del usuario como:
- Geografía
- Detalles del dispositivo
- Demografía
Como resultado:
- Los informes de GA4 incluyen principalmente eventos de participación (por ejemplo: clics en botones)
- Las perspectivas a nivel de usuario son limitadas en comparación con el seguimiento en sitios web
Notas importantes
- Si un código QR redirige a una página donde no está implementado el seguimiento de GA4, no aparecerán datos en GA4
- Universal Analytics (UA) se descontinuó el 1 de julio de 2023
- Los ID de UA fueron soportados solo hasta el 30 de junio de 2023
- Todas las integraciones deben usar Google Analytics 4 (GA4)
B. Cómo integrar GA4 con Scanova
Sigue los pasos a continuación para conectar tu cuenta de Scanova con Google Analytics 4:
- Inicia sesión en tu cuenta de Scanova
- Navega a Panel → pestaña Analytics
- Haz clic en Integraciones
- Bajo Google Analytics, haz clic en Configuración
En la pantalla de configuración:
- Haz clic en Configuración bajo Google Analytics
- Elige el tipo de datos que deseas enviar a GA4:
1. Datos de análisis de escaneo- Selecciona esta opción para rastrear el número de escaneos de códigos QR
- Adecuado para monitorear el uso general de códigos QR
-
2. Datos de seguimiento de eventos
- Selecciona esta opción para rastrear interacciones de usuarios en páginas de destino de Scanova
- Adecuado para rastrear clics en botones y elementos interactivos
- Introduce las credenciales requeridas:
- ID de medición de Google Analytics
- Secreto de API de Measurement Protocol
- Haz clic en Guardar para completar la integración
Notas adicionales
- El seguimiento de escaneos de códigos QR comienza automáticamente una vez que la integración está habilitada
- El seguimiento de eventos requiere configuración adicional durante la creación del código QR
C. Pasos para habilitar el seguimiento de eventos
Para rastrear eventos de participación en páginas de destino de Scanova, sigue estos pasos adicionales:
C.1 Habilitar el seguimiento de eventos en la configuración de Scanova
- Ve a la configuración de la cuenta de Scanova
- Asegúrate de que Seguimiento de eventos esté habilitado
Este paso es obligatorio para enviar datos de eventos a GA4.
C.2 Agregar seguimiento a los botones en las páginas de destino
Al crear un código QR para página de destino:
- Navega a Botones → Diseño de botón → Rastrear clics
- Habilita el seguimiento de clics para los botones requeridos
- Asigna un ID de seguimiento (event_tag):
- Usa un nombre único y descriptivo
- Ejemplo:
- "homepage_cta_click"
- "product_demo_button"
- "Contact_us_click"
Este ID de seguimiento ayuda a identificar eventos específicos en los informes de GA4.
D. Cómo encontrar el ID de medición de GA4
El ID de medición es necesario para conectar GA4 con Scanova.
Sigue estos pasos:
- Paso 1: Abre Google Analytics
- Paso 2: Selecciona la propiedad GA4 requerida
- Paso 3: Haz clic en Administrador (icono de engranaje en la parte inferior izquierda)
- Paso 4: Bajo Recopilación y modificación de datos, haz clic en Flujos de datos
- Paso 5: Haz clic en Flujo de datos web
- Paso 6: Selecciona el flujo de datos para integrar
- Paso 7: Ubica el ID de medición en la página de detalles del flujo
- Formato: G-XXXXXXXXXX
Nota:
- El ID de medición es específico para cada flujo de datos
- No es global para toda la cuenta GA4
E. Cómo crear un secreto de API de Measurement Protocol
El secreto de API es necesario para enviar datos de eventos desde Scanova a GA4.
Requisito previo:
- El usuario debe tener acceso de Editor o superior en GA4
Pasos:
- Ve a Administrador → Flujos de datos
- Selecciona Web → elige el flujo de datos requerido
- Navega a Secretos de API de Measurement Protocol bajo Eventos
- Haz clic en Crear
- Introduce un apodo para identificación
- Ejemplo:
- "Integración Scanova"
- "Seguimiento de eventos QR"
- Ejemplo:
- Haz clic en Crear
- Copia el valor generado del Secreto de API
Este secreto se usará en Scanova durante la integración.
F. Visualización de datos de escaneo de códigos QR en GA4
Una vez completada la integración, los datos de escaneo de códigos QR pueden consultarse en GA4.
- Navega a la sección de Informes
Para un análisis detallado:
- Ve a Objetivos comerciales → Tráfico → Páginas y pantallas
Ubicación alternativa (dependiendo de la versión de la interfaz de GA4):
-
Ciclo de vida → Participación → Páginas y pantallas
Puntos clave
- Cada código QR puede identificarse usando su slug único
- Los informes permiten analizar:
- Vistas de página
- Fuentes de tráfico
- Comportamiento del usuario
Nota:
- Los datos pueden tardar hasta 48 horas en aparecer en los informes de GA4
G. Visualización de la participación en páginas de destino de Scanova en GA4
Para los códigos QR de páginas de destino, Scanova envía datos de eventos estructurados a GA4.
Cada evento incluye los siguientes parámetros:
| Campo | Descripción |
| engagement_time_msec | Duración (en milisegundos) durante la cual el usuario estuvo activamente comprometido con la página/componente cuando ocurrió el evento. |
| event_id | Identificador único para cada evento de clic, visible en la carga útil de la API. |
| event_tag | Nombre del evento de clic rastreado asignado en Scanova (Este es el ID de seguimiento que se añadió en la página de destino de Scanova) |
| event_time | Marca de tiempo cuando el usuario hizo clic en un componente rastreable. |
| ga_session_id | Identificador de sesión GA4 para asociar múltiples eventos con una sola sesión de usuario. |
| page_location | URL o página de destino donde ocurrió el clic |
| qr_id | Identificador único del código QR |
| qr_code_name | Nombre del código QR en Scanova |
Estos parámetros permiten filtros y segmentaciones detalladas en GA4.
H. Configuración de filtros con dimensiones personalizadas en GA4
Para analizar eficazmente los parámetros de eventos, se deben crear dimensiones personalizadas.
Sigue estos pasos:
- Ve a Google Analytics y abre tu propiedad
- Haz clic en Administrador
- En la columna Propiedad, selecciona Definiciones personalizadas
- Haz clic en Crear dimensión personalizada
Llena los detalles requeridos:
-
Nombre de la dimensión
- Ejemplo:
- Nombre del producto
- ID de la organización
- Tipo de campaña
- Ejemplo:
-
Alcance
- Selecciona Evento
-
Descripción
- Opcional pero recomendado
-
Parámetro del evento
- Debe coincidir exactamente con:
- event_id
- event_tag
- qr_code_name
- Debe coincidir exactamente con:
- Haz clic en Guardar
Repite el proceso para todos los parámetros necesarios.
Ejemplo
- Dimensión personalizada creada:
- Nombre de la dimensión: Etiqueta del evento
-
Parámetro del evento: event_tag
Esto permite filtrar eventos basados en los IDs de seguimiento asignados en Scanova.
I. Seguimiento de eventos en GA4
I.1 Ver eventos en tiempo real
- Navega a En tiempo real
- Ve a Conteo de eventos por nombre de evento
- Busca el evento: click
- Haz clic en él para ver detalles
- Visualiza todos los parámetros enviados por Scanova
- Selecciona parámetros con definiciones personalizadas para analizar la participación
I.2 Ver informes detallados de participación
- Ve a Objetivos comerciales → Ver participación y retención de usuarios → Eventos
- Busca el evento: click
- Haz clic en el evento click
- Analiza la participación usando dimensiones personalizadas
Ejemplo:
- Si event_tag está configurado:
- Puedes ver valores como:
- "Código QR de producto Scanova"
- "homepage_cta_click"
- Puedes ver valores como:
Estos representan los IDs de seguimiento definidos anteriormente.
Nota importante
- GA4 normalmente tarda 24–48 horas para:
- Nuevos datos de eventos
- Dimensiones personalizadas
- Este retraso es normal y esperado
Si aún tienes preguntas o necesitas ayuda con la integración de GA4, contacta al equipo de soporte en support@scanova.io