AppboyKit (también conocido como SDK Objective-C) ya no recibe soporte y ha sido sustituido por Swift SDK. Ya no recibirá nuevas características, correcciones de errores, actualizaciones de seguridad ni soporte técnico; sin embargo, la mensajería y los análisis seguirán funcionando con normalidad. Para obtener más información, consulta Presentación del nuevo SDK Swift de Braze.
Establecer ID de usuario para iOS
Los ID de usuario deben establecerse para cada uno de tus usuarios. Deben ser inmutables y accesibles cuando un usuario abra la aplicación. Nombrar correctamente tus ID de usuario desde el principio es uno de los pasos más cruciales a la hora de configurar los ID de usuario. Te recomendamos encarecidamente que utilices el estándar Braze de UUIDs y GUIDs (detallado más abajo). También te recomendamos encarecidamente que proporciones este identificador, ya que te permitirá:
- Sigue a tus usuarios a través de dispositivos y plataformas, mejorando la calidad de tus datos de comportamiento y demográficos.
- Importa datos sobre tus usuarios utilizando nuestra API de datos de usuario.
- Dirígete a usuarios específicos con nuestra API de mensajería, tanto para mensajes generales como transaccionales.
Si tal identificador no está disponible, Braze asignará un identificador único a tus usuarios, pero carecerás de las capacidades indicadas para los ID de usuario. Debes evitar configurar ID de usuario para usuarios para los que carezcas de un identificador único que esté vinculado a ellos como individuos. Pasar un identificador de dispositivo no ofrece ninguna ventaja frente al seguimiento automático de usuarios anónimos que Braze ofrece por defecto.
Si quieres incluir un valor identificador como ID de usuario, para mayor seguridad, te recomendamos encarecidamente que añadas nuestra característica de autenticación SDK para evitar la suplantación de usuarios.
Convención de nomenclatura de ID de usuario sugerida
En Braze, recomendamos encarecidamente nombrar los ID de usuario, también denominados ID externos, en formato UUID y GUID. Los UUID y GUID son identificadores únicos universales que consisten en un número de 128 bits utilizado para identificar información en sistemas informáticos. Esto significa que estos UUID son largos, aleatorios y están bien distribuidos. Si eliges un método diferente para nombrar tus ID de usuario, también deben ser largos, aleatorios y estar bien distribuidos. También es importante tener en cuenta que los ID de usuario distinguen entre mayúsculas y minúsculas. Por ejemplo, “Abcdef” es un usuario distinto de “abcdef”.
Si descubres que tus ID de usuario incluyen nombres, direcciones de correo electrónico, marcas de tiempo o incrementadores, te sugerimos que utilices un nuevo método de asignación de nombres que sea más seguro para que tus ID de usuario no sean tan fáciles de adivinar o suplantar. Si decides incluir esto en tus ID de usuario, te recomendamos encarecidamente que añadas nuestra característica de autenticación SDK para evitar la suplantación de identidad de usuarios.
Facilitar esta información a terceros puede permitir que personas ajenas a tu organización obtengan información sobre cómo están estructurados tus ID de usuario, exponiendo a tu organización a actualizaciones potencialmente maliciosas o a la eliminación de información. Elegir la convención de nomenclatura correcta desde el principio es uno de los pasos más importantes en la configuración de los ID de usuario. Sin embargo, es posible realizar una migración utilizando nuestro punto final de migración de ID externo.
| Nomenclatura de ID de usuario | |
|---|---|
| Recomendado | No recomendado |
| 123e4567-e89b-12d3-a456-836199333115 | JonDoe829525552 |
| 8c0b3728-7fa7-4c68-a32e-12de1d3ed2d5 | [email protected] |
| f0a9b506-3c5b-4d86-b16a-94fc4fc3f7b0 | CompanyName-1-2-19 |
| 2d9e96a1-8f15-4eaf-bf7b-eb8c34e25962 | jon-doe-1-2-19 |
Asignar un ID de usuario
Debes realizar la siguiente llamada en cuanto se identifique el usuario (generalmente después de iniciar la sesión) para establecer el ID de usuario:
1
[[Appboy sharedInstance] changeUser:@"YOUR_USER_ID_STRING"];
1
Appboy.sharedInstance()?.changeUser("YOUR_USER_ID")
No llames a changeUser() cuando un usuario cierra la sesión. changeUser() solo se debe llamar cuando el usuario inicia sesión en la aplicación. Si configuras changeUser() a un valor predeterminado estático asociará TODA la actividad del usuario a ese “usuario” predeterminado hasta que el usuario vuelva a conectarse.
Asegúrate de llamar a este método en el hilo principal de tu aplicación. Llamar al método de forma asíncrona puede provocar un comportamiento indefinido.
Además, te recomendamos que no cambies el ID de usuario cuando un usuario cierra la sesión, ya que esto hace que no puedas dirigirte al usuario que había iniciado sesión anteriormente con campañas de reactivación de la interacción. Si prevés varios usuarios en el mismo dispositivo, pero sólo quieres dirigirte a uno de ellos cuando tu aplicación esté desconectada, te recomendamos que hagas un seguimiento por separado del ID de usuario al que quieres dirigirte mientras está desconectado y que vuelvas a cambiar a ese ID de usuario como parte del proceso de cierre de sesión de tu aplicación.
Prácticas recomendadas y notas sobre la integración del ID de usuario
Conservación automática del historial de usuarios anónimos
| Contexto de identificación | Comportamiento de conservación |
|---|---|
| El usuario no ha sido identificado previamente | El historial anónimo se fusiona con el perfil de usuario en el momento de la identificación. |
| El usuario ha sido previamente identificado en la aplicación o a través de la API | El historial anónimo no se fusiona con el perfil de usuario al identificarse. |
Consulta Perfiles de usuario identificados para obtener más información sobre lo que ocurre cuando identificas a usuarios anónimos.
Notas adicionales y buenas prácticas
Toma nota de lo siguiente:
- Si tu aplicación la utilizan varias personas, puedes asignar a cada usuario un identificador único para su seguimiento.
- Una vez configurado un ID de usuario, no puedes revertir ese usuario a un perfil anónimo.
- No cambies el ID de usuario cuando un usuario cierre la sesión, ya que esto puede separar el dispositivo del perfil de usuario.
- Como resultado, no podrás dirigirte al usuario que se desconectó previamente con mensajes de reactivación de la interacción. Si prevés varios usuarios en el mismo dispositivo, pero sólo quieres dirigirte a uno de ellos cuando tu aplicación esté desconectada, te recomendamos que hagas un seguimiento por separado del ID de usuario al que quieres dirigirte mientras está desconectado y que vuelvas a cambiar a ese ID de usuario como parte del proceso de cierre de sesión de tu aplicación. Por predeterminado, sólo el último usuario que haya iniciado sesión recibirá notificaciones push de tu aplicación.
- Pasar de un usuario identificado a otro es una operación relativamente costosa.
- Cuando solicitas el cambio de usuario, la sesión actual del usuario anterior se cierra automáticamente y se inicia una nueva sesión. Braze realizará automáticamente una solicitud de actualización de datos para los mensajes dentro de la aplicación y otros recursos de Braze para el nuevo usuario.
Si optas por utilizar un hash de un identificador único como ID de usuario, asegúrate de que normalizas la entrada a tu función hash. Por ejemplo, si vas a utilizar un hash de una dirección de correo electrónico, confirma que estás eliminando los espacios en blanco iniciales y finales de la entrada, y teniendo en cuenta la localización.
Asignación de alias de usuarios
Un alias de usuario sirve como identificador único alternativo del usuario. Puedes utilizar alias para identificar a los usuarios en dimensiones diferentes a tu ID de usuario principal:
- Establece un identificador coherente para el análisis que seguirá a un usuario determinado tanto antes como después de que haya iniciado sesión en una aplicación móvil o sitio web.
- Añade los identificadores utilizados por un proveedor externo a los usuarios de tu empresa para facilitar la conciliación de tus datos externamente.
Cada alias consta de dos partes: un nombre para el propio identificador y una etiqueta que indica el tipo de alias. Los usuarios pueden tener varios alias con etiquetas diferentes, pero sólo un nombre por etiqueta.
Para más información sobre la configuración de alias de usuario contra un perfil de usuario, consulta Alias de usuario.
1
[[Appboy sharedInstance].user addAlias:ALIAS_NAME withLabel:ALIAS_LABEL];
1
Appboy.sharedInstance()?.user.addAlias(ALIAS_NAME, ALIAS_LABEL)
Editar esta página en GitHub