Usuarios (ID de Usuario)

Un ID de Usuario es un identificador único que se asigna a cada usuario para mantener la coherencia de los datos del usuario en todos sus dispositivos. Esto le permite ofrecer a su audiencia una experiencia de usuario fluida en todos sus dispositivos.

¿Cómo se relacionan los usuarios y los dispositivos?

A cada usuario se le asigna un identificador único llamado ID de Usuario. Los ID de Usuario pueden vincularse a múltiples dispositivos, lo que permite a las empresas mantenerse conectadas con los usuarios incluso cuando cambian de dispositivo. Esto garantiza que los mensajes dirigidos lleguen al usuario previsto en cualquier dispositivo que esté utilizando.

Un usuario (ID de Usuario) no es una entidad independiente; depende de la presencia de dispositivos asociados. Si se elimina el último dispositivo asociado o se vincula a otro usuario, el usuario se eliminará automáticamente del sistema.

Un usuario (ID de Usuario) también funciona como una entidad bajo la cual se pueden agrupar varios dispositivos, cada uno con su propio ID de hardware (HWID) único.

Tipos de usuarios

Hay dos tipos de usuarios: anónimos y conocidos. Un usuario anónimo tiene su ID de Usuario igual al HWID del dispositivo, que puede ser reemplazado por el ID de Usuario real más adelante.

Un usuario conocido tiene un ID de Usuario distinto. Puede especificar un ID de Usuario al registrar un nuevo dispositivo a través de la llamada a la API /registerDevice.

Obtención y gestión de los ID de Usuario

Pushwoosh proporciona varias formas de acceder y gestionar los Usuarios:

Creación de usuarios

Por defecto, cuando una aplicación con el SDK de Pushwoosh integrado se inicia por primera vez, establece el HWID de un dispositivo como ID de Usuario. Puede llamar al método setUserID del SDK de Pushwoosh al iniciar sesión para establecer cualquier valor requerido para asociar un dispositivo con un usuario en particular. Cuando un usuario cierra la sesión, puede restablecer este valor a uno predeterminado con otra llamada a setUserID, por ejemplo, a un valor de HWID inicial.

Importación de usuarios

Puede importar fácilmente los ID de Usuario desde un archivo CSV para un segmento de usuarios específico. Encuentre nuestras instrucciones detalladas en la guía de Segmentos.

Exportación de usuarios

Para exportar los ID de Usuario, puede utilizar la solicitud de la API /exportSegment, que ofrece la opción de exportar datos en formato CSV o JSON.

Acceso a los ID de Usuario desde los registros del dispositivo

También se puede acceder directamente a los ID de Usuario desde los registros del dispositivo. Para obtener instrucciones paso a paso, consulte el artículo Cómo obtener los registros de la consola y los tokens de dispositivo.

Etiquetas de usuario y de dispositivo

Al igual que los dispositivos, los usuarios (ID de Usuario) pueden tener sus propios conjuntos de etiquetas que servirán como identificadores para categorizar e identificar a los usuarios o dispositivos en función de sus características.

Cómo crear etiquetas específicas del usuario

Cuando establece una etiqueta específica del usuario, se aplica automáticamente tanto a los usuarios como a todos sus dispositivos asociados. Esto significa que la etiqueta se vinculará al perfil del usuario y se reflejará en todos sus dispositivos.

Para crear una etiqueta específica del usuario desde el Panel de Control de Pushwoosh, marque la casilla Específica del usuario al añadir una nueva etiqueta. Si no marca la etiqueta como específica del usuario, se asociará únicamente con el dispositivo.

Gestión de las transiciones de usuario

Dentro de Pushwoosh, la gestión de las transiciones de usuario implica dos escenarios principales:

Transición de usuario Anónimo a Conocido

Cuando un usuario anónimo se convierte en un usuario conocido, el dispositivo que está utilizando se asocia con su nuevo perfil de usuario. Durante esta transición, todos los atributos del dispositivo permanecen intactos. Sin embargo, es importante tener en cuenta que todos los atributos específicos del usuario se restablecen a los valores del usuario conocido o a los valores predeterminados si no existen.

Por ejemplo, consideremos un escenario en el que un usuario invitado ha estado utilizando una aplicación de seguimiento de actividad física con la configuración predeterminada. Cuando crea una cuenta, los datos de su dispositivo permanecen sin cambios. Sin embargo, cualquier detalle específico del usuario, como su nombre, correo electrónico y objetivos personalizados, se restablecerá a los valores del usuario conocido.

Transición de un usuario Conocido a otro

Si el Usuario asociado con un dispositivo se cambia usando setUserID del SDK de Pushwoosh, el dispositivo se asocia con el nuevo perfil de usuario.

Obtenga más información sobre cómo establecer los ID de Usuario para Android y iOS.

También puede utilizar la llamada a la API /registerUser.

Al igual que en el escenario anterior, los atributos del dispositivo permanecen iguales, lo que garantiza una transición fluida. Sin embargo, las etiquetas específicas del usuario se asignarán ahora a los valores del nuevo usuario. Esto es para garantizar que las etiquetas del usuario reflejen con precisión el perfil del nuevo usuario.

Como ejemplo, considere un escenario en un servicio de streaming de video. Si un usuario registrado cierra la sesión y otro usuario registrado inicia sesión en el mismo dispositivo, la configuración del dispositivo, como el idioma preferido y la configuración de calidad de video, se conservan. Sin embargo, cualquier información específica del usuario, como el historial de visualización y las recomendaciones, se cambiará para el nuevo usuario.

Métodos de la API para gestionar usuarios

Pushwoosh proporciona varios métodos de la API para gestionar usuarios dentro de su aplicación. Comprender estos métodos es crucial para una gestión y segmentación eficaces de los datos de los usuarios. A continuación, se presentan los cuatro métodos clave que cambian el estado o los atributos del usuario:

1. /applicationOpen

• Crea un dispositivo sin un token push y un usuario anónimo si no existen.
• Establece etiquetas específicas del dispositivo en el dispositivo.
• No gestiona los cambios relacionados con el usuario.

2. /registerDevice

• Crea un dispositivo con un token push y un usuario si no existen.
• Asocia un dispositivo con el usuario de la solicitud de la API (usuario anónimo en caso contrario).
• Asigna todas las etiquetas especificadas tanto al dispositivo como a su usuario asociado.

Precaución

Para protegerse contra posibles condiciones de carrera (donde múltiples operaciones intentan modificar datos compartidos simultáneamente), absténgase de usar /registerDevice simultáneamente con /registerUser.

3. /registerUser

• Crea un dispositivo sin un token push y un usuario si no existe.
• Transfiere un dispositivo entre usuarios conservando las etiquetas del dispositivo.

4. /setTags

• Crea un dispositivo sin un token push y un usuario anónimo si no existe.
• Asigna etiquetas de dispositivo al dispositivo.
• Asigna etiquetas de usuario al usuario proporcionado en la solicitud (si dicho usuario existe).
• Este método no transfiere el dispositivo y, como resultado, no puede crear un nuevo usuario conocido (puede usar el método /registerUser para crear un nuevo usuario conocido).

Si un usuario está asociado con múltiples dispositivos, ¿cuál de ellos recibirá el mensaje durante un Customer Journey?

Cuando un usuario tiene múltiples dispositivos asociados a su cuenta, la forma en que se entregan los mensajes entre ellos depende del tipo de journey:

Journeys de entrada basados en la audiencia y en webhooks

Por defecto, en estos journeys, los mensajes se envían al dispositivo más recientemente activo asociado con el usuario. Esto asegura que el mensaje llegue al usuario que tiene más probabilidades de interactuar con él.

Journeys de entrada basados en activadores

Por defecto, el mensaje se envía al dispositivo donde se activó por última vez la acción desencadenante. Esto mantiene el contexto y la relevancia al entregar el mensaje en el dispositivo donde ocurrió la actividad relevante del usuario.

Entrega a todos los dispositivos

Sin embargo, puede optar por anular esta configuración predeterminada y enviar el mensaje a todos los dispositivos asociados con el ID de Usuario simultáneamente. Para ello, en la configuración del mensaje, desplácese hacia abajo hasta Opciones y active la opción Enviar a todos los dispositivos del usuario.

Esta opción puede ser útil para difusiones o notificaciones urgentes que necesitan llegar al usuario independientemente del dispositivo que esté utilizando en ese momento.