Custom Script
Un solo script. Todas las funciones. Añade un snippet ligero al código fuente de tu sitio y desbloquea toda la potencia de Positive User: tracking de visitantes, chat en directo, identificación de contactos y automatización basada en eventos. Sin plugin, sin dependencia de un CMS, sin necesidad de un desarrollador más allá del acceso al HTML.
Un solo snippet para alimentar toda tu plataforma
Funciona en cualquier sitio web
¿No tienes plugin para tu CMS? No hay problema. El script de Positive User se integra con cualquier sitio: HTML estático, aplicaciones a medida, arquitecturas headless o plataformas sin plugin dedicado. Pega el snippet justo antes de la etiqueta de cierre </body> y el tracking arranca al instante.
Del visitante anónimo al contacto identificado
En cuanto se carga el script, Positive User asigna una clave única a cada visitante y empieza a rastrear las páginas vistas, el dispositivo, el navegador y la ubicación, todo de forma anónima. Cuando estés listo para identificar a los usuarios, pasa atributos como el email, el nombre o el número de teléfono a través del script. Toda la actividad previa a la identificación se vincula entonces con el perfil de contacto identificado.
Transmite cualquier dato que necesites
El objeto window.civchat acepta atributos estándar (nombre, email, número de teléfono, estado, score) y datos de empresa (nombre de la empresa, ID, facturación), todo en un solo bloque de código. Utiliza valores estáticos, variables de GTM o JavaScript dinámico para alimentar el objeto. Lo que envíes aterriza al instante en el perfil de contacto.
Three simple steps to get started
Copia tu script
En tu app de Positive User, ve a Settings > Setup & Integrations > Basic Integration. Copia el script. Ya contiene tu clave API y el dominio de tu app.
Añádelo a tu sitio
Pega el script justo antes de la etiqueta </body> en el código fuente de tu sitio. Como alternativa, despliégalo a través de Google Tag Manager con un disparador configurado para activarse en todas las páginas.
Verifica el tracking
Abre tu sitio web y comprueba la sección Contactos en Positive User. En cuestión de segundos deberían aparecer nuevos registros de visitantes anónimos. Para una verificación técnica, abre la consola del navegador, escribe civchat y confirma que el objeto está definido. El tracking está activo.
Popular implementation guides
- Integración mediante implementación del script: Guía paso a paso de la configuración básica y avanzada del script, incluido el envío de atributos de usuario y datos de empresa. Leer la guía →
- Implementar Positive User con Google Tag Manager: Despliega el script de Positive User a través de GTM en lugar de editar directamente tu código fuente. Ideal para equipos que gestionan los tags de forma centralizada. Leer la guía →
- Ajustes del widget de chat: Configura la visibilidad, la apariencia y el comportamiento del widget. Útil si despliegas el script solo para tracking y quieres ocultar o personalizar el widget de chat. Ver el tutorial →
- Definir IDs personalizados para usuarios, empresas y oportunidades: Descubre cómo funcionan user_id y company_id para emparejar a los visitantes del sitio con los registros existentes en tu base de datos y evitar duplicados. Ver el tutorial →
Frequently Asked Questions
¿Necesito saber programar para integrar el script?
Muy poco. Necesitas acceso al código fuente HTML de tu sitio (o a Google Tag Manager) y pegas un snippet ya listo. El script se copia directamente desde tus ajustes de Positive User, sin necesidad de editarlo. Si sabes abrir un archivo del sitio o pegar un tag en GTM, ya está.
¿Cuál es la diferencia entre el script básico y el script avanzado?
El script básico contiene únicamente tu clave API. Activa el tracking anónimo de visitantes, el registro de páginas vistas y el widget de chat. El script avanzado añade un objeto window.civchat en el que pasas atributos de usuario (email, nombre, teléfono) y datos de empresa, de modo que los visitantes aterrizan directamente como contactos identificados en Positive User.
¿El script ralentizará mi sitio?
No. El script se carga de forma asíncrona y es ligero. No bloquea el renderizado de la página ni afecta al rendimiento de tu sitio.
¿Puedo usar esta integración con Google Tag Manager en lugar de editar mi código fuente?
Sí. Puedes desplegar el script de Positive User como una etiqueta HTML personalizada en GTM. Configura el disparador para que se active en todas las páginas. Este es el enfoque recomendado si tu equipo ya gestiona otras etiquetas a través de GTM o si no tienes acceso directo al código fuente del sitio.
¿Cómo funciona el tracking de visitantes anónimos?
Cuando se carga el script, se genera una user_key única y se almacena una cookie en el navegador del visitante. Cada vista de página queda registrada y asociada a esa clave. El visitante aparece como un registro anónimo en Positive User hasta que se identifica (interacción con el chat, envío de formulario o atributos pasados a través del script avanzado).
¿Qué formatos de datos se requieren para los atributos?
Las fechas deben seguir el formato ISO 8601 (por ejemplo, 2017-07-25T14:14:08.612Z). Los números de teléfono deben usar el formato E.164 (por ejemplo, +44754123434). Los demás atributos aceptan cadenas, números o valores booleanos según el tipo de campo definido en tu app de Positive User.
¿Puedo enviar datos de empresa junto con los datos de usuario?
Sí. El objeto window.civchat acepta un objeto company anidado con atributos como name, company_id y revenue. En una sola llamada se crea o actualiza tanto el perfil de contacto como el registro de empresa asociado en Positive User, manteniendo el vínculo entre ambos automáticamente.
¿Qué pasa si no quiero que aparezca el widget de chat?
Puedes seguir usando el script solo para tracking y recogida de datos. Ve a Settings > Chat Widget Settings > Widget Visibility y establece el estado del widget en «Hidden». El script sigue funcionando en silencio en segundo plano.
¿Cómo verifico que el script funciona?
Dos métodos. Primero, comprueba la sección Contactos en tu app de Positive User: tras visitar tu sitio deberían aparecer nuevos registros anónimos. Segundo, abre la consola de desarrollador de tu navegador en tu sitio y escribe civchat. Si el objeto está definido, el script está cargado y el tracking activo.
¿Puedo rastrear eventos personalizados con este script?
El script en sí se encarga de la identificación de visitantes y del envío de atributos. Para enviar eventos personalizados (compras, envíos de formularios, clics en botones), tendrás que añadir llamadas de tracking de eventos por separado, ya sea a través de la API de JavaScript de Positive User o mediante disparadores de Google Tag Manager. Nuestro equipo puede ayudarte a definir el enfoque adecuado para tu caso de uso.