Soporte/Funciones avanzadas
Funciones avanzadas

Identificación de usuarios

Convierte a los visitantes anónimos en perfiles persistentes y consultables.

Los perfiles te permiten seguir a los usuarios con un identificador estable y ofrecen varias ventajas:

  • Continuidad entre dispositivos cuando se identifica de nuevo al mismo usuario
  • Registros de visitantes consultables en el panel
  • Mejor atribución del tráfico anónimo a cuentas conocidas

Identify es explícito — lo llamas tú

Flowsery no detecta automáticamente a los usuarios que han iniciado sesión. Instalar el script registra las visitas de página y las sesiones anónimas; no tiene forma de saber quién es el usuario actual. Vinculas al visitante con una cuenta llamando a identify explícitamente tras el registro, el inicio de sesión o cuando tu aplicación conozca al usuario — el mismo modelo que DataFast y Segment.

JavaScript
window.flowsery('identify', {
  userId: 'user_123',
  email: 'john@example.com',
  name: 'John Wayne',
  image: 'https://example.com/avatar.jpg',
  profileData: {
    role: 'admin',
    plan: 'pro',
  },
});

Llámalo desde tu aplicación cuando conozcas al usuario. En React:

JSX
'use client';
import { useEffect } from 'react';
 
export function FlowseryIdentify({ user }) {
  useEffect(() => {
    if (user?.id) {
      window.flowsery?.('identify', {
        userId: user.id,
        email: user.email,
        name: user.name,
      });
    }
  }, [user]);
 
  return null;
}

Contrato actual

  • userId es obligatorio — tu id de cuenta estable
  • email es opcional pero necesario para asociar pagos por correo electrónico (ver más abajo)
  • name es opcional
  • image es opcional
  • Los campos personalizados van dentro de profileData

Atribución de ingresos por correo electrónico

Cuando no puedes reenviar la cookie _fs_vid a la metadata de tu proveedor de pagos (consulta Stripe PaymentIntent API), identify es la alternativa: Flowsery asocia un pago entrante al visitante cuando el correo electrónico del pago coincide con el email del usuario identificado. Pasa el email del usuario a identify para que esto funcione. Así se vincula un pago al visitante persistente que ves en el panel durante semanas, incluso entre dispositivos.

Carga fiable

Si las llamadas a identify pueden ejecutarse antes de que se cargue el script principal del rastreador, coloca el shim de cola en el head de tu documento:

HTML
<script id="flowsery-queue">
  window.flowsery =
    window.flowsery ||
    function () {
      window.flowsery.q = window.flowsery.q || [];
      window.flowsery.q.push(arguments);
    };
</script>

Notas

  • Identify vincula a un usuario conocido con el perfil del visitante. No reemplaza a los objetivos personalizados.
  • Si la atribución de ingresos está activada, los flujos de proveedores de pago conectados también pueden enriquecer la identidad del cliente cuando hay datos coincidentes disponibles.