Establecer ID de usuario

Aprende a configurar los ID de usuario a través del SDK de Braze. Son identificadores únicos que te permiten realizar el seguimiento de los usuarios en distintos dispositivos y plataformas, importar sus datos a través de la API de datos de usuario y enviar mensajes dirigidos a través de la API de mensajería. Si no asignas un ID único a un usuario, Braze le asignará un ID anónimo; sin embargo, no podrás utilizar estas características hasta que lo hagas.

Acerca de los usuarios anónimos

Después de integrar el SDK de Braze, los usuarios que inicien tu aplicación por primera vez se considerarán “anónimos” hasta que llames al método changeUser y les asignes un external_id. Una vez asignados, no puedes volver a hacerlos anónimos. Sin embargo, si desinstalan y vuelven a instalar tu aplicación, volverán a ser anónimos hasta que se llame a changeUser.

Si un usuario previamente identificado inicia una sesión en un nuevo dispositivo, toda su actividad anónima se sincronizará automáticamente con su perfil existente después de que llames a changeUser en ese dispositivo utilizando su external_id. Esto incluye cualquier atributo, evento o historial recopilado durante la sesión en el nuevo dispositivo.

Prevenir el seguimiento de usuarios anónimos

Si tu caso de uso requiere que no se recopilen datos antes de que un usuario sea identificado, puedes retrasar la inicialización del SDK de Braze hasta que el usuario inicie sesión y un external_id esté disponible. Establece un indicador en tu código que cambie a true cuando el usuario inicie sesión, y solo inicializa el SDK cuando ese indicador esté establecido.

Configuración de un ID de usuario

Para establecer un ID de usuario, llama al método changeUser() después de que el usuario inicie sesión por primera vez. Los ID deben ser únicos y seguir nuestras prácticas recomendadas de nomenclatura.

Si, por el contrario, estás realizando un hash de un identificador único, asegúrate de normalizar la entrada de tu función hash. Por ejemplo, al realizar el hash de una dirección de correo electrónico, elimina los espacios iniciales o finales y ten en cuenta la localización.

• web
• android
• swift
• cordova
• roku
• unity
• react native

1
braze.changeUser(YOUR_USER_ID_STRING);

1
Braze.getInstance(context).changeUser(YOUR_USER_ID_STRING);

1
Braze.getInstance(context).changeUser(YOUR_USER_ID_STRING)

1
AppDelegate.braze?.changeUser(userId: "YOUR_USER_ID")

1
[AppDelegate.braze changeUser:@"YOUR_USER_ID_STRING"];

1
BrazePlugin.changeUser("YOUR_USER_ID");

1
m.Braze.setUserId(YOUR_USER_ID_STRING)

1
AppboyBinding.ChangeUser("YOUR_USER_ID_STRING");

1
Braze.changeUser("YOUR_USER_ID_STRING");

Cómo funciona changeUser()

Cuando llamas a changeUser(), se aplican los siguientes comportamientos:

• Llamar a changeUser() con el mismo ID de usuario que ya está establecido no tiene efecto en el recuento de sesiones.
• Llamar a changeUser() con un ID de usuario diferente finaliza automáticamente la sesión actual e inicia una nueva.
• Cuando un usuario anónimo llama a changeUser() con un ID de usuario nuevo (que aún no existe en Braze), los datos del perfil anónimo se fusionan con el nuevo perfil identificado.
• Cuando un usuario anónimo llama a changeUser() con un ID de usuario existente, los datos del perfil anónimo no se fusionan con el perfil identificado.

Alias de usuario

Cómo funcionan

Aunque los usuarios anónimos no tienen external_ids, puedes asignarles un alias de usuario. Debes asignar un alias de usuario cuando quieras añadir otros identificadores al usuario pero no sepas cuál es su external_id (por ejemplo, no ha iniciado sesión). Con los alias de usuario, también puedes:

• Utiliza la API Braze para registrar eventos y atributos asociados a usuarios anónimos
• Utiliza el filtro de segmentación ID externo del usuario está en blanco para dirigirte a usuarios anónimos en tu mensajería

Configuración de un alias de usuario

Un alias de usuario consta de dos partes: un nombre y una etiqueta. El nombre hace referencia al identificador en sí, mientras que la etiqueta hace referencia al tipo de identificador al que pertenece. Por ejemplo, si tienes un usuario en una plataforma de atención al cliente de terceros con el ID externo 987654, puedes asignarle un alias en Braze con el nombre 987654 y la etiqueta support_id, para poder realizar el seguimiento en todas las plataformas.

• web
• android
• swift
• rest api
• react native

1
braze.getUser().addAlias(ALIAS_NAME, ALIAS_LABEL);

1
Braze.getInstance(context).getCurrentUser().addAlias(ALIAS_NAME, ALIAS_LABEL);

1
Braze.getInstance(context).currentUser?.addAlias(ALIAS_NAME, ALIAS_LABEL)

1
Appboy.sharedInstance()?.user.addAlias(ALIAS_NAME, ALIAS_LABEL)

1
 [[Appboy sharedInstance].user addAlias:ALIAS_NAME withLabel:ALIAS_LABEL];

1
2
3
4
{
  "alias_name" : (required, string),
  "alias_label" : (required, string)
}

1
Braze.addAlias("ALIAS_NAME", "ALIAS_LABEL");

Prácticas recomendadas de nomenclatura de ID

Te recomendamos que crees ID de usuario utilizando el estándar UUID (Universally Unique Identifier), es decir, cadenas de 128 bits aleatorias y bien distribuidas.

Como alternativa, puedes realizar un hash de un identificador único existente (como un nombre o una dirección de correo electrónico) para generar tus ID de usuario. Si lo haces, asegúrate de implementar la autenticación del SDK para evitar la suplantación de identidad de los usuarios.

Aunque es fundamental que nombres correctamente tus ID de usuario desde el principio, siempre puedes renombrarlos en el futuro utilizando el punto de conexión /users/external_ids/rename.