Flobu + Google Analytics 4

Google Analytics 4 para tu tienda online.

Conecta tu tienda online con GA4 y reúne navegación, carrito y resultados comerciales. Descubre qué atrae visitas, qué productos interesan y dónde se interrumpe el recorrido.

Integración mediante OAuth · Todos los planes de Flobu · Medición de la tienda online

Qué puedes conocer

Google Analytics 4 conecta el comportamiento medido con los resultados de tu tienda. La propiedad pertenece a tu comercio y puedes consultar sus datos tanto en Flobu como en Google.

Qué trae visitas

Compara canales, fuentes y medios para entender de dónde llegan las sesiones y las compras medidas.

Qué productos interesan

Relaciona exposición, selección, fichas vistas, unidades al carrito y unidades compradas por variante.

Dónde se pierde el recorrido

Observa los pasos desde el producto hasta el pago y contrástalos con errores operativos del checkout.

Qué resultado se confirmó

Distingue la intención de compra del pedido creado, el pago completado y la devolución monetaria.

Esta conexión usa el destino de tu tienda. Es independiente de la analítica operativa de Flobu y de la medición de uso de la plataforma con GA4 o Umami.

Cómo conectar tu tienda

Necesitas ser administrador de la tienda en Flobu y autorizar una cuenta Google con permisos para consultar informes y editar los recursos de Analytics elegidos.

  1. Abre Google Analytics en Integraciones

    Selecciona primero la tienda correcta en Flobu. En Integraciones → Google Analytics, presiona Conectar con Google.

  2. Autoriza la cuenta del comercio

    Revisa identidad y correo, lectura de Analytics y edición de configuración. Flobu no recibe tu contraseña ni pide acceso a Gmail o Drive.

  3. Selecciona cuenta, propiedad y flujo

    Puedes conservar una propiedad y flujo web existentes o crearlos dentro de una cuenta accesible. Si no tienes una cuenta Analytics, créala en Google y vuelve.

  4. Revisa los datos y el destino

    Comprueba la propiedad, el flujo y su ID. Marca la declaración de recopilación de Google sólo si cuentas con los avisos y derechos necesarios.

  5. Confirma cuando el dominio difiera

    El asistente compara todos tus dominios activos y verificados y sus alias autorizados. Si ninguno coincide con el declarado por Google, puedes revisar ambos lados y confirmar o cancelar.

  6. Activa y comprueba

    Presiona Activar integración y espera Conectado. Revisa propiedad, ID, zona horaria y Salud de la medición; luego abre Ver reportes.

Para crear un flujo nuevo hace falta al menos un dominio activo y verificado: Flobu elige el principal o, si no existe, otro dominio autorizado de la tienda. Un flujo compartido con otros sitios puede combinar sus datos. Confirmar un dominio diferente no permite saltarse los permisos ni usar el flujo activo de otra tienda Flobu.

Seguir el tutorial de conexión

Qué configura Flobu

Flobu obtiene automáticamente el ID del flujo elegido. Las credenciales OAuth y el secreto de medición del servidor permanecen en el backend.

Medición en el navegador

El tag oficial observa navegación y pasos de compra. Las páginas vistas se controlan para evitar duplicados por navegación interna o renderizado.

Resultados desde el servidor

Django registra operaciones confirmadas y conserva una cola de entrega. No toma un clic del navegador como prueba de una venta.

Dimensiones y evento clave

Configura sucursal (flobu_branch_id), origen técnico (flobu_event_source) y tipo de producto (flobu_product_type), y comprueba purchase como evento clave.

Destino y controles

Comprueba lectura y configuración del flujo, y ajusta medición automática de historial, búsquedas, formularios, clics salientes y descargas para evitar duplicados o datos no deseados.

Las propiedades nuevas usan pesos chilenos y America/Santiago. En una propiedad existente se conservan moneda y zona horaria. La entrada manual del ID está en retirada: conecta por OAuth y selecciona tu flujo para pasar a la medición administrada con un único tracker.

Los 18 eventos de la integración

Un evento indica una observación o un resultado concreto. Aquí puedes ver cuándo se produce, quién lo envía y qué permite analizar. Los parámetros dependen de la información disponible para ese evento.

Navegación y descubrimiento

Qué páginas y productos se observan antes de entrar al proceso de compra.

Navegador · 5 eventos · De Google Analytics

Página visitada

page_view

Al observar una navegación efectiva de la tienda, incluida la navegación sin recargar. No se dispara por cada renderizado.

Para qué sirve: Reconocer las páginas por las que pasa una visita. Las URL, referentes y títulos se sanean. Las rutas privadas de pagos, seguimiento, confirmación y previews quedan fuera.

Parámetros disponibles según el contexto
page_location · page_referrer · page_title

Producto expuesto en una lista

view_item_list

Cuando al menos la mitad de una tarjeta de producto instrumentada entra en pantalla. Una tarjeta observada no significa una ficha abierta.

Para qué sirve: Relacionar la exposición del catálogo con los productos seleccionados. Se evita repetir la misma exposición del artículo dentro de una navegación; no equivale a contar todo el catálogo cargado.

Parámetros disponibles según el contexto
items · item_list_id · item_list_name

Producto seleccionado

select_item

Al hacer clic en una tarjeta instrumentada de producto del catálogo.

Para qué sirve: Entender qué productos despiertan interés desde una lista. La selección no implica que se haya agregado una unidad al carrito.

Parámetros disponibles según el contexto
items · item_list_id · item_list_name

Ficha de producto vista

view_item

Cuando se muestra la ficha con la información disponible del producto y su variante.

Para qué sirve: Comparar interés por variante con unidades al carrito y compras. La identidad del artículo se mantiene durante el recorrido. Cambiar de variante puede generar una observación diferente.

Parámetros disponibles según el contexto
items · currency · value

Resultados de búsqueda mostrados

view_search_results

Cuando la página de búsqueda muestra su conjunto de resultados.

Para qué sirve: Conocer el uso de la búsqueda y la cantidad de resultados mostrados. Flobu no envía el término libre buscado; este evento no permite construir un informe de palabras buscadas.

Parámetros disponibles según el contexto
number_of_results

Carrito y pasos del checkout

El avance observado hacia una compra, antes de confirmar el resultado comercial.

Navegador · 4 eventos · De Google Analytics

Carrito visto

view_cart

Al mostrar el carrito con sus artículos y cantidades disponibles.

Para qué sirve: Comparar visitas al carrito con entradas al checkout. Ver el carrito no modifica sus cantidades ni confirma un pedido.

Parámetros disponibles según el contexto
items · currency · value

Checkout iniciado

begin_checkout

Al entrar efectivamente al checkout con los datos del carrito cargados.

Para qué sirve: Medir cuántas visitas avanzan desde el carrito al proceso de compra. Es una etapa observada, distinta de crear un pedido o completar su pago.

Parámetros disponibles según el contexto
items · currency · value

Entrega seleccionada

add_shipping_info

Al elegir una opción válida de entrega durante el checkout.

Para qué sirve: Analizar qué tipos de entrega se eligen antes de una compra. Incluye el tipo de entrega; no envía la dirección del comprador. La deduplicación evita repeticiones de la misma opción en esa navegación.

Parámetros disponibles según el contexto
shipping_tier · items · currency · value

Medio de pago seleccionado

add_payment_info

Al seleccionar una opción válida de pago en el checkout.

Para qué sirve: Comparar selección de medios de pago con resultados posteriores. El parámetro identifica la opción de pago. No contiene datos de tarjeta ni demuestra un cobro exitoso.

Parámetros disponibles según el contexto
payment_type · items · currency · value

Operaciones comerciales confirmadas

Flobu registra cambios y resultados efectivos con el contexto medible asociado al carrito.

Servidor · 4 eventos · De Google Analytics

Unidades agregadas

add_to_cart

Después de confirmar un aumento real de cantidad en el carrito, usando la diferencia entre el estado anterior y el nuevo.

Para qué sirve: Comparar unidades agregadas con exposición, fichas y compras. Si la cantidad pasa de una a tres, informa dos unidades agregadas. Un clic rechazado no crea este resultado.

Parámetros disponibles según el contexto
items · currency · value · flobu_branch_id

Unidades retiradas

remove_from_cart

Después de confirmar una reducción real de cantidad o la eliminación de una línea del carrito.

Para qué sirve: Detectar productos que se retiran antes de pagar. La cantidad enviada es la diferencia retirada, siempre positiva. No significa una devolución de dinero.

Parámetros disponibles según el contexto
items · currency · value · flobu_branch_id

Compra online pagada

purchase

Cuando el pago de un pedido online pasa a completado por primera vez, incluida una transferencia validada.

Para qué sirve: Relacionar compras e ingresos medidos con adquisición, productos y recorrido. Crear el pedido o volver del procesador no basta. Flobu deduplica por pedido y conserva un transaction_id estable; el pago tardío se registra con su fecha real.

Parámetros disponibles según el contexto
transaction_id · items · currency · value · tax · shipping

Devolución monetaria completada

refund

Al completar una devolución con importe positivo de una compra registrada, total o parcial.

Para qué sirve: Analizar devoluciones junto a la transacción original. items sólo se incluye cuando hay líneas de devolución asociadas. Cancelar un pedido o reponer stock no basta. No se presupone deduplicación externa de devoluciones en Google.

Parámetros disponibles según el contexto
transaction_id · currency · value · tax · shipping · items · flobu_refund_id

Resultados operativos de Flobu

Eventos propios que ayudan a estudiar dificultades; no sustituyen el detalle del pedido ni cubren todos los errores posibles.

Servidor · 5 eventos · Propios de Flobu

Pedido online creado

flobu_checkout_created

Al registrar por primera vez el pedido del checkout con contexto medible.

Para qué sirve: Distinguir pedidos creados de compras efectivamente pagadas. Todavía puede estar pendiente el pago. No se vuelve a contar por cada consulta del pedido.

Parámetros disponibles según el contexto
payment_type · flobu_branch_id

Pago fallido observado

flobu_payment_failed

Cuando el pedido online con contexto queda con estado de pago fallido.

Para qué sirve: Detectar pedidos afectados por fallos de pago y comparar opciones. Se deduplica por pedido: no representa cada intento de cobro ni incluye mensajes libres del procesador.

Parámetros disponibles según el contexto
payment_type · flobu_branch_id

Código aplicado

flobu_coupon_applied

Después de confirmar una solicitud de aplicación de código al carrito con contexto medible.

Para qué sirve: Estudiar el uso de la aplicación de códigos durante la compra. No envía el código libre del cupón, su nombre ni la identidad del comprador.

Parámetros disponibles según el contexto
flobu_branch_id

Aplicación de código rechazada

flobu_coupon_rejected

Al observar una respuesta de error a una solicitud de aplicación de código con contexto medible.

Para qué sirve: Detectar fricción en el uso de códigos del carrito. reason usa una clasificación HTTP, como http_400. No incluye el texto del error ni permite conocer el cupón ingresado.

Parámetros disponibles según el contexto
reason · flobu_branch_id

Error de checkout observado

flobu_checkout_error

Al observar una respuesta de error del endpoint de checkout con contexto medible.

Para qué sirve: Localizar dificultades para crear el pedido y orientar una revisión operativa. No representa todos los errores de interfaz o conexión. Incluye una clasificación HTTP, sin mensajes libres ni datos del cliente.

Parámetros disponibles según el contexto
reason · flobu_branch_id

Los eventos automáticos de Google se cuentan aparte

El tag puede generar eventos propios, como primera visita, inicio de sesión analítica o interacción. No son eventos explícitos adicionales de Flobu. Un inicio de sesión analítica no significa que el comprador haya iniciado sesión en una cuenta de tu tienda.

Los 18 eventos documentados corresponden a la conexión administrada mediante OAuth. Flobu no reconstruye navegación ni operaciones anteriores que nunca se midieron.

Parámetros e importes

Los parámetros describen el evento. No todos están presentes en todas las acciones, y algunos ayudan a relacionar etapas sin identificar personalmente al comprador.

items e identificadores de producto
Cada artículo puede incluir item_id, nombre, variante, marca, categorías, precio, descuento y cantidad. Flobu mantiene el identificador de variante durante el recorrido y reutiliza el identificador de Merchant Center cuando existe; no necesitas Merchant Center para usar GA4.
currency, value, tax y shipping
Los eventos comerciales se envían en CLP, expresado en pesos, no en centavos. En compras y devoluciones, el valor de artículos se informa neto de IVA y el impuesto y envío van separados. Las fotografías comerciales conservan los importes de la operación aunque después edites el catálogo.
transaction_id
Relaciona la compra con sus devoluciones mediante un identificador estable. Flobu deduplica compras por pedido y devoluciones por registro confirmado. Un UUID de auditoría no garantiza que Google deduplique cualquier evento.
Contexto de Flobu
flobu_branch_id identifica la sucursal cuando corresponde; flobu_event_source distingue browser y server; flobu_product_type describe el tipo de artículo. Los eventos de servidor incluyen flobu_event_id para trazabilidad, y refund incluye flobu_refund_id.
URL, listas y opciones
Las páginas usan URL y títulos saneados. Las listas pueden incluir item_list_id e item_list_name; el checkout incorpora shipping_tier o payment_type. reason en errores operativos es una clasificación HTTP, no el mensaje libre del error.

Ejemplo ilustrativo · Compra afecta a IVA 19%

El valor de artículos y el cobro total son cifras diferentes.

Artículos netos
$10.000
value
IVA
$1.900
tax
Despacho
$3.000
shipping
Cobro total
$14.900
Pedido en Flobu

No compares automáticamente un ingreso de GA4 con el total cobrado sin revisar impuestos, envío, descuentos y moneda. Los informes se consultan en la moneda de la propiedad; Google puede convertir importes si es distinta de CLP.

Cómo analizar los resultados

Abre Estadísticas → Google Analytics y selecciona el período. Los reportes se filtran por el flujo conectado y corresponden a la tienda online completa, aunque tengas otra sucursal activa en el dashboard.

Resumen

¿Cómo evoluciona la actividad de mi tienda?

Usuarios activos, sesiones, compras pagadas e ingresos por compras, junto a la evolución diaria de sesiones.

Compara períodos y observa si los cambios de tráfico vienen acompañados de compras medidas.

Una persona puede generar varias sesiones. Los usuarios del período no se obtienen sumando usuarios diarios.

Adquisición

¿Desde dónde llegan las visitas que compran?

Canal, fuente y medio, con sesiones, sesiones con interacción, compras e ingresos.

Compara tráfico desde redes, búsquedas o campañas etiquetadas con UTM y revisa cuáles aportan resultados.

No incluye costes de anuncios ni calcula rentabilidad publicitaria. Una asociación observada no demuestra causalidad.

Productos

¿Qué variantes convierten el interés en ventas?

Vistas, unidades agregadas al carrito, unidades compradas e ingresos por identificador de variante.

Revisa fichas con muchas vistas y pocas compras antes de ajustar contenido, precio o disponibilidad.

Unidades, usuarios y pedidos son medidas diferentes. El listado tiene paginación de 50 filas.

Embudo

¿En qué paso se interrumpe el recorrido?

Producto visto → Agregado al carrito → Checkout iniciado → Compra pagada, contando usuarios en ese orden.

Localiza la caída entre pasos y contrástala con opciones de entrega, pagos y diagnóstico operativo.

Es cerrado y secuencial: una compra sin los pasos anteriores medidos puede aparecer en Resumen y no completarlo. Su API alfa de Google puede fallar por separado.

La caché de reportes dura 15 minutos. Actualizar vuelve a consultar Flobu, sin forzar el procesamiento de Google ni saltarse una caché vigente. Cada informe muestra moneda, zona horaria, fecha de cobertura y última consulta válida. Si falla Google, puede mostrarse el último resultado con su fecha; No disponible significa falta de una medición válida, no cero actividad.

Para profundizar en Google Analytics

En Google puedes trabajar exploraciones con los eventos y dimensiones disponibles, por ejemplo sucursal u origen técnico. No todos esos filtros existen dentro de Flobu. Para campañas usa valores UTM consistentes, como utm_source, utm_medium y utm_campaign, sin datos personales. Conectar GA4 no crea campañas de Google Ads ni vincula automáticamente otros productos de Google.

Enviar un parámetro no lo convierte automáticamente en un campo de informe. Flobu configura las tres dimensiones descritas arriba; para analizar otros parámetros personalizados, como reason o number_of_results, debes registrar la dimensión o métrica correspondiente en Google y esperar su procesamiento. Los identificadores de evento sirven para trazabilidad y no se ofrecen como filtros del panel. Consulta la guía de parámetros y definiciones personalizadas de Google.

Google puede aplicar umbrales, muestreo, restricciones o cuotas. Flobu muestra los avisos comunicados por la API. Para conciliación y operación diaria, consulta también la vista Sucursal: pedidos reales y analítica de comportamiento tienen fuentes y alcances distintos.

Abrir los reportes de Google Analytics

Identidad, privacidad y atribución

La compra invitada sigue disponible. La integración utiliza identificadores técnicos de cliente y sesión del tag de Google para relacionar navegación y resultados medibles.

  • Las cookies se aíslan por tienda y dominio. No hay un User-ID de comprador ni una promesa de reconocer a una persona entre dispositivos o dominios. La configuración automática de medición multidominio queda fuera de esta conexión.
  • Si el tag está bloqueado o no se obtuvo contexto del carrito, Flobu no inventa una identidad para enviar la operación desde el servidor. Por eso GA4 puede medir menos compras que los registros operativos.
  • Un pago tardío mantiene su fecha real y el cliente técnico original. Sólo se asocia a una sesión cuando el contexto y las ventanas admitidas lo permiten; puede quedar sin atribución a la sesión de inicio.
  • Esta integración mide la tienda online. No atribuye a sus visitantes ventas de POS, pedidos manuales, importaciones ni marketplaces.
  • Los parámetros de medición no incorporan campos de nombre, correo, RUT, teléfono, dirección, contraseña ni tokens del comprador. Las búsquedas no incluyen su término libre; las URL conservan sólo parámetros de campaña permitidos.
  • Flobu mantiene deshabilitados Google Signals, personalización publicitaria y envío de datos proporcionados por usuarios en esta medición. La autorización OAuth de un administrador no constituye el consentimiento de los compradores; cada comercio debe informar y obtener las autorizaciones aplicables.
Consultar datos y permisos de la integración

Cómo comprobar la medición

Usa una tienda y propiedad de prueba para ensayos de pago o devolución. En producción, revisa operaciones reales autorizadas; no generes cobros ficticios para comprobar un gráfico.

  1. En Integraciones → Google Analytics, verifica propiedad e ID y pulsa Comprobar dentro de Salud de la medición.
  2. Abre el sitio publicado mediante HTTPS, permite el tag y navega por catálogo, producto y carrito. En Google consulta En tiempo real en el mismo flujo.
  3. Modifica cantidades reales, entra al checkout y selecciona entrega y pago. Revisa una compra sólo cuando el pedido quede pagado y una devolución sólo cuando su registro monetario esté completado.
  4. Compara Pendientes, Aceptados por HTTP y Requieren atención. Una respuesta HTTP aceptada no prueba que Google haya procesado el evento.
  5. Espera el procesamiento y consulta el período adecuado. Muchos informes pueden demorar entre 24 y 48 horas. DebugView requiere modo de depuración; Flobu no lo activa automáticamente en producción.

Si la conexión necesita atención

Revisa el mensaje, corrige permisos o usa Reconectar cuenta. Una configuración interrumpida conserva progreso para Reintentar configuración. Evita crear repetidamente propiedades o reenviar compras manualmente.

Si un envío queda pendiente o incierto

Flobu conserva una cola y recupera entregas dentro de su ventana admitida, con vencimiento a las 72 horas. Una respuesta perdida puede ser incierta. El diagnóstico conserva detalle de 90 días; no define la retención de la propiedad de Google.

Preguntas frecuentes

Documentación contrastada con la integración administrada de Flobu. Las condiciones de procesamiento y los permisos de Google siguen aplicando.

Comercio electrónico en GA4Measurement ProtocolComprobar recepción en Google

Conecta Google Analytics con tu tienda

Elige tu propiedad y empieza a medir el uso de tu tienda online con Google Analytics 4.

Conectar Google Analytics