Web SDK - Introducción

Documento

Visión general

El SDK de Singular Web le permite realizar un seguimiento de las visitas de los usuarios, las conversiones y los eventos en su sitio web. Cuando se implementa correctamente, Singular atribuye las conversiones del sitio web a las campañas de marketing que impulsaron esas visitas, lo que le proporciona una visibilidad completa del rendimiento de su marketing web.

INFORMACIÓN: Web Attribution es una función para empresas. Póngase en contacto con su Customer Success Manager para activar esta función en su cuenta.

Cómo funciona la atribución web

Singular Web SDK utiliza JavaScript para identificar a los usuarios por su navegador y seguir su recorrido por su sitio web. Cuando un usuario visita su sitio web, el SDK determina si se trata de una primera visita o de una sesión recurrente tras una campaña web.

Entre sus principales funciones se incluyen

  • Seguimiento de visitas a páginas y sesiones de usuario
  • Registro de eventos de conversión (compras, registros, suscripciones)
  • Medición de eventos personalizados específicos de su empresa
  • Atribución de conversiones a campañas de marketing
  • Atribución entre dispositivos cuando se combina con SDK para móviles (requiere suscripción a la función Cross-Device)

Antes de empezar

Antes de implementar el SDK Web, asegúrese de que dispone de lo siguiente:

Requisito Descripción
Clave SDK Su clave SDK de Singular. Encuéntrela en su cuenta de Singular en Herramientas de desarrollador > Integración SDK > Claves SDK.
Acceso al sitio web Permiso para añadir código JavaScript al HTML de su sitio web, ya sea directamente o a través de un sistema de gestión de etiquetas.
Planificación de eventos Una lista documentada de eventos de los que desea realizar un seguimiento (por ejemplo, Compra, Añadir al carrito, Registro).
Política de privacidad Política de privacidad actualizada si activa el seguimiento entre subdominios (que utiliza cookies).

Elección del método de integración

Singular ofrece dos opciones de integración. Elija el método que mejor se adapte a su configuración técnica:


Implementación nativa de JavaScript

Ideal para: Equipos con acceso directo al código del sitio web, desarrolladores cómodos con JavaScript o situaciones en las que desee el máximo control y las mínimas dependencias de terceros.

Ventajas:

  • No bloqueado por los bloqueadores de anuncios habituales
  • Rendimiento de carga de páginas más rápido
  • Seguimiento más fiable
  • Control directo sobre la implementación
  • Soporte de banners

Desventajas:

  • Requiere cambios de código en su sitio web
  • Las actualizaciones requieren la participación de los desarrolladores

CONSEJO Singular recomienda la implementación de JavaScript nativo para la mayoría de los casos de uso, ya que proporciona una mayor fiabilidad y es menos probable que sea bloqueado por los bloqueadores de anuncios.

Ver la guía de JavaScript nativo


Implementación de Google Tag Manager

Ideal para: Equipos que ya utilizan Google Tag Manager, equipos de marketing que necesitan realizar cambios sin ayuda de desarrolladores.

Ventajas:

  • No es necesario realizar cambios directos en el código
  • Gestión más sencilla para equipos no técnicos
  • Los cambios se pueden implementar a través de la interfaz de GTM

Desventajas:

  • A menudo bloqueado por bloqueadores de anuncios
  • Depende de que GTM se cargue correctamente
  • Complejidad adicional en la depuración
  • No es compatible con banners

Ver la guía de Google Tag Manager

IMPORTANTE Sólo implemente UN método. El uso simultáneo de Native JavaScript y Google Tag Manager provocará un seguimiento duplicado y métricas infladas. Singular no deduplica eventos automáticamente.

Conceptos clave


ID de producto (ID de paquete de aplicaciones)

El ID de producto identifica su sitio web a Singular. Debe estar en notación DNS inversa, similar a los identificadores de paquetes de aplicaciones móviles.

Formato: com.website-name

Ejemplos:

  • Correcto: com.acme
  • Incorrecto: acme-store
  • Incorrecto: www.acme.com

CONSEJO Utilice el mismo ID de producto en todas las páginas de su sitio web. Si tiene varios subdominios asociados al mismo sitio web: (www.acme.com,shop.acme.com,store.acme.com) debe utilizar el mismo ID de producto com.acme para todos ellos. Sitios web o propiedades web con diferentes dominios: (www.site1.com,www.site2.com,www.site3.com), deben ser creados usando un ID de Producto separado para cada uno en su cuenta Singular y tratarlos como Apps separadas.


Sesiones y Re-engagement

¿Qué es una sesión?

Una sesión en el seguimiento de Singular representa un período distinto de compromiso del usuario con su sitio web. A diferencia de las sesiones HTTP (que mantienen el estado técnico como el estado de inicio de sesión a través de solicitudes de página), las sesiones de Singular se centran en la analítica y miden los patrones de actividad del usuario para la atribución y las métricas de compromiso.

Cuándo se crean las sesiones

Singular crea automáticamente una nueva sesión cuando

  • Un usuario ha estado inactivo durante 30 minutos o más (tiempo de espera de sesión por defecto)
  • Un usuario visita con nuevos parámetros de campaña (fuente de anuncios diferente)
  • Un usuario llega desde un sitio web de referencia diferente

Tiempo de espera de sesión vs. Ventana de inactividad de reconexión

Es importante comprender dos configuraciones distintas basadas en el tiempo:

Tiempo de espera de la sesión (nivel SDK)

  • Controla cuando comienza una nueva sesión
  • Predeterminado: 30 minutos para WebSDK, 60 segundos para SDKs móviles
  • Configurable mediante la inicialización del SDK
  • Se reinicia cada vez que se detecta actividad del usuario
  • Se utiliza para métricas basadas en la sesión (recuento de sesiones, duración de la sesión, etc.)

Ventana de inactividad de reconexión (nivel de plataforma)

  • Controla cuándo se puede volver a atribuir el compromiso.
  • Predeterminado: 7 días
  • Se configura por aplicación en Ajustes > Aplicaciones
  • Determina el tiempo mínimo que un usuario debe estar inactivo antes de que un clic en una campaña de retargeting cuente como un evento de reenganche.
  • No afecta a la creación de sesiones normales

Ejemplo

Considere un usuario que:

  1. Visita su sitio web y lo abandona al cabo de 5 minutos
  2. Vuelve 45 minutos más tarde a través de un anuncio de retargeting

¿Qué ocurre?

  • Se crea una nueva sesión (se supera el tiempo de espera de sesión de 30 minutos).
  • No se produceatribución de reconexión (el usuario no ha estado inactivo durante 7 días)
  • La visita se rastrea como una sesión normal vinculada a la fuente de atribución anterior.

Si el mismo usuario vuelve después de 10 días de inactividad a través de un anuncio de retargeting:

  • Se crea una nueva sesión
  • Se activa laatribución de reconexión (superado el periodo de inactividad de 7 días)
  • El evento se registra como un reenganche con la atribución adecuada a la campaña de retargeting.

Opciones de configuración

Personalización del tiempo de espera de la sesión:
El tiempo de espera de la sesión puede ajustarse durante la inicialización del SDK. Revise las opciones de Inicialización WebSDK en nuestra documentación relevante para su método de implementación: JavaScript nativo o Google Tag Manager

Personalización de la ventana de inactividad de reconexión:
La ventana de inactividad de reenganche para la atribución de reenganche puede personalizarse por aplicación accediendo a Configuración > Aplicaciones y ampliando las opciones de "Mostrar configuración avanzada" en la plataforma Singular. Ajústela en función de sus patrones de interacción con el usuario y las estrategias de campaña de retargeting.

INFO: El periodo de inactividad puede personalizarse si es necesario. Lea más sobre esto en las Preguntas Frecuentes de Re-engagement.


Eventos: Conversión vs. Estándar

Singular distingue entre dos tipos de eventos:

Eventos de Conversión: Acciones críticas para el negocio que indican éxito (compras, suscripciones, registros, descargas). Aparecen en los informes de atribución y en los cálculos de ROI.

Eventos estándar: Acciones de apoyo que ayudan a comprender el comportamiento del usuario (páginas vistas, añadir al carrito, reproducciones de vídeo). Aparecen en los informes de datos brutos y ayudan a analizar el recorrido del usuario.

CONSEJO Configure qué eventos se clasifican como "eventos de conversión" en los ajustes de su cuenta de Singular. Esto garantiza que aparezcan en los informes correctos.

Privacidad y uso de cookies

Por defecto, Singular no utiliza cookies. Sin embargo, si habilita la persistencia de identificadores entre subdominios, Singular establece una cookie de origen para mantener la identidad del usuario entre subdominios.

Detalles de la cookie (si está activada):

Propiedad Valor
Nombre de la cookie singular_device_id
Propósito Asigna un ID único a los usuarios para realizar un seguimiento de sus actividades e interacciones a lo largo de las sesiones sin recopilar información personal
Duración 1 año
Tipo Cookie de origen (instalada en su dominio)
Política de privacidad https://www.singular.net/privacy-policy/

IMPORTANTE Si habilita el seguimiento entre subdominios, actualice la política de privacidad de su sitio web para revelar el uso de la cookie singular_device_id.

Pasos siguientes

  1. Elija su método de integración (JavaScript nativo o Google Tag Manager)
  2. Siga paso a paso la guía de implementación del método que haya elegido.
  3. Pruebe la implementación mediante los pasos de validación proporcionados.
  4. Revise la guía de solución de problemas para conocer las mejores prácticas.

Artículos relacionados