Instala el SDK

Identificar usuarios

Rastrea un evento

Rastrear atributos

Agrupar usuarios

Dar Retroalimentación

SDK de JavaScript

Instala el SDK

A continuación se muestra la etiqueta de Specific. Cópiela y péguela en el código de cada página de su sitio web o aplicación web donde desee que Specific rastree a sus usuarios. Pégue la etiqueta inmediatamente después del elemento <head>. No agregue más de una etiqueta Specific a cada página.

Asegúrate de reemplazar tu WORKSPACE_ID en la última línea. Puedes encontrarlo aquí en la sección de Integraciones.

<script type="text/javascript">
  (function(l, e, a, p) {
    if (window.Specific) return
    window.Specific = function() {
      S._queue.push(arguments)
    }
    var S = window.Specific
    S.appId = a
    S._queue = []
    a = l.createElement('script')
    a.async = 1
    a.src = e + '?id=' + S.appId
    p = l.getElementsByTagName('script')[0]
    p.parentNode.insertBefore(a, p)
  })(document, 'https://cdn.specific.app/bundle.js', 'WORKSPACE_ID')
</script>

Identificar usuarios

Esto es importante si quieres saber quién dijo qué; de lo contrario, todas las respuestas permanecerán anónimas.

Cuando un usuario visita una página con nuestro SDK, recibe un ID de visitante único que permite realizar encuestas dirigidas. Sin embargo, los usuarios permanecen no autenticados hasta que sus IDs de visitante se alineen con los IDs de usuario únicos de su sistema.

Si ya estás utilizando identificadores en tu sistema, te recomendamos sincronizar los identificadores en todas las plataformas para asegurar un enfoque consistente y evitar la repetición de encuestas.

Requisitos para las identificaciones:

Único: No hay dos usuarios que compartan el mismo ID.
Mapeable: Los IDs se vinculan a su sistema interno.
Estático: Los IDs permanecen iguales con el tiempo.

Establecer ID de Usuario

Utilice setUserId para asignar el identificador de un usuario (hasta 256 caracteres) al iniciar sesión. Esta función es segura para llamar varias veces y garantiza la consistencia de la identificación del usuario a lo largo de las sesiones.

Specific('setUserId', 'ID_USUARIO');

Cerrar sesión

Cuando un usuario cierra sesión en su sitio o producto, asegúrese de cerrarlo también en nuestro sistema. Esto evita que se atribuyan por error nuevas acciones al usuario equivocado. Tenga en cuenta que si utiliza esto para un usuario no autenticado, se creará un nuevo ID que se contará por separado hacia su límite de usuarios.

Specific('cerrarSesiónUsuario');

Rastrea un evento para activar encuestas

Los eventos se utilizan para activar encuestas o dirigirlas a usuarios específicos según sus acciones dentro de tu producto. Al rastrear eventos, puedes asegurarte de que las encuestas se muestren en el momento adecuado y al público correcto.

Tipos de eventos

Nuestra plataforma admite dos tipos de eventos para activar y filtrar encuestas:

Eventos sin código: Estos eventos pueden ser configurados por miembros del equipo sin acceder a la base de código, lo que los hace ideales para actualizaciones rápidas o experimentos. Los eventos sin código se pueden configurar posteriormente usando nuestra interfaz intuitiva.
Eventos con código: Estos eventos requieren que un desarrollador implemente el seguimiento directamente en su base de código. Son altamente personalizables y pueden incluir propiedades adicionales para una orientación o comportamiento más detallado.

Configuración de Eventos Sin Código

Los Eventos Sin Código se pueden configurar directamente a través de la Interfaz de Eventos sin modificar el código de su aplicación. Esto permite que sus miembros del equipo no técnicos definan y gestionen rápidamente eventos para activar encuestas.

Implementación de Eventos de Código

Para rastrear un Evento de Código, puedes utilizar el siguiente fragmento en tu aplicación. Esto rastrea el evento en segundo plano:

Specific('evento', 'Nombre del Evento');

Si deseas que el evento active una encuesta de inmediato (por ejemplo, abriendo un modal después de que un usuario haga clic en un botón), utiliza este fragmento mejorado. Proporciona retroalimentación instantánea sin esperar una respuesta del servidor:

Specific('evento', 'Nombre del Evento', { loadingPlacement: 'centro', autoFocus: true });

Rastrear atributos para orientar a los usuarios

Los atributos te permiten lograr dos objetivos clave: obtener más contexto sobre tus usuarios y dirigir las encuestas de manera más efectiva.

Al agregar datos sobre tus usuarios, puedes ver quién proporcionó cada respuesta, haciendo que las conversaciones sean identificables en lugar de anónimas.

Cuando se trata de segmentación, los atributos te permiten enfocar más tu atención. Por ejemplo, puedes mostrar encuestas solo a segmentos de usuarios específicos, como usuarios frecuentes o usuarios de un país en particular. Además, los atributos facilitan el filtrado y análisis de las respuestas de las encuestas.

Nombre, Correo electrónico

Utiliza setName y setEmail para asignar el nombre y la dirección de correo electrónico de un usuario.

Specific('setName', 'John Doe');
Specific('setEmail', 'john@example.com');

Atributos Personalizados

Utiliza setAttributes o setAttribute para añadir cualquier atributo personalizado, como el país del usuario o si son un usuario avanzado.

// Establecer múltiples atributos
Specific('setAttributes', {
  usuario_avanzado: true,
  país: "EE.UU."
});

// Establecer un único atributo
Specific('setAttribute', 'país', 'EE.UU.');

Idioma

Si la interfaz de usuario de su producto admite varios idiomas, puede encuestar a los usuarios en su idioma nativo. Use setLanguage con un código de idioma ISO 639-1 (consulte la lista de códigos de idioma) para establecer el idioma preferido del usuario.

Specific('setLanguage', 'es');

Configuración de atributos desde el backend

Existen muchos casos de uso donde necesitas establecer atributos desde el backend. ¡También puedes hacerlo! Aquí tienes ejemplos para una cadena de texto, un número y un booleano.

Puedes generar tu PERSONAL_API_KEY en Preferencias, en la sección de API y obtener tu WORKSPACE_ID desde la interfaz de integraciones. Y no olvides eliminar los # Comentarios.

curl -X POST 'https://wapi.specific.app/api/v1/user' \
-H 'authorization: PERSONAL_API_KEY' \
-H 'x-app: WORKSPACE_ID' \
-H 'Content-Type: application/json' \
-d '{
  "id": "123456789",            # Requerido: ID único del usuario
  "name": "John Doe",           # Opcional: Nombre del usuario
  "email": "john@example.com",  # Opcional: Correo electrónico del usuario
  "group": {                    # Opcional: Detalles del grupo
    "id": "4242424242424242",   # Opcional: ID del grupo
    "name": "Acme Inc."         # Opcional: Nombre del grupo
  },
  "attrs": [                    # Opcional: Atributos del usuario
    {
      "key": "company_size",    # Clave de atributo opcional
      "value": 1000             # Valor de ejemplo
    },
    {
      "key": "active",          # Clave de atributo opcional
      "value": true             # Valor de ejemplo
    },
    {
      "key": "subscription_plan", # Clave de atributo opcional
      "value": "Free"             # Valor de ejemplo
    }
  ]
}'

Agrupar a los usuarios (en empresas, espacios de trabajo, etc.)

Utilice la función setGroup para organizar a sus usuarios en grupos significativos, como empresas o espacios de trabajo (por ejemplo, espacios de trabajo en Figma). Esta función asigna un usuario a un grupo específico, como un ID de Empresa o Espacio de Trabajo, al iniciar sesión, asegurando un seguimiento consistente de los grupos a través de las sesiones. Cada ID de grupo puede tener hasta 256 caracteres.

Recomendaciones Clave:

Colocación: Puedes incluir este fragmento de código en cualquier parte de tu aplicación, aunque normalmente se agrega cerca de la función setUserId durante el registro o inicio de sesión del usuario.
Singularidad: Asegúrate de que GROUP_ID sea un identificador único, idealmente el ID del espacio de trabajo o de la empresa de tu base de datos.
Atributos: Incluye el nombre de la empresa y cualquier atributo adicional (por ejemplo, subscription_plan, company_size) para mejorar las capacidades de filtrado e informes.
Limitaciones: Un usuario solo puede pertenecer a un grupo a la vez.

Agrupar usuarios te permite analizar conversaciones, filtrar informes y dirigir encuestas de manera más efectiva.

Specific('setGroup', 'GROUP_ID', {
    name: 'Acme Inc.',
    attributes: {
        'plan_de_suscripción': 'gratuito',
        'tamaño_de_la_empresa': 1000,
    }
});

Configuración de atributos desde el backend

Si necesitas establecer atributos desde el servidor, ¡también puedes hacerlo!

Puedes generar tu PERSONAL_API_KEY en Preferencias, en la sección de API y obtener tu WORKSPACE_ID desde la interfaz de integraciones. Y no olvides eliminar los # Comentarios.

curl -X POST 'https://wapi.specific.app/api/v1/group' \
-H 'authorization: PERSONAL_API_KEY' \
-H 'x-app: WORKSPACE_ID' \
-H 'Content-Type: application/json' \
-d '{
  "id": "4242424242424242",         # Requerido: ID único del grupo
  "name": "Acme Inc.",              # Opcional: Nombre del grupo
  "attrs": [                        # Opcional: Atributos del grupo
    {
      "key": "active",              # Clave de atributo opcional
      "value": true                 # Valor de ejemplo (el grupo está activo)
    },
    {
      "key": "company_size",        # Clave de atributo opcional
      "value": 1000                 # Valor de ejemplo (número de empleados)
    },
    {
      "key": "subscription_plan",   # Clave de atributo opcional
      "value": "Free"               # Valor de ejemplo (tipo de suscripción)
    }
  ]
}'

Puede hacer más usando nuestra API pública. Obtenga más información en nuestra documentación de la API.