Configuración de los ID de usuario
Aprende a configurar ID de usuario a través del SDK de Braze. Son identificadores únicos que te permiten hacer un 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á en su lugar un ID anónimo; sin embargo, no podrás utilizar estas características hasta que lo hagas.
Para los SDK envoltorio que no aparecen en la lista, utiliza en su lugar el método nativo de Android o Swift correspondiente.
Acerca de los usuarios anónimos
After you integrate the Braze SDK, users who launch your app for the first time will be considered “anonymous” until you call the changeUser
method and assign them an external_id
. Once assigned, you can’t make them anonymous again. However, if they uninstall and reinstall your app, they will become anonymous again until changeUser
is called.
If a previously-identified user starts a session on a new device, all of their anonymous activity will automatically sync to their existing profile after you call changeUser
on that device using their external_id
. This includes any attributes, events, or history collected during the session on the new device.
Configuración de un ID de usuario
Para configurar un ID de usuario, llama al método changeUser()
después de que el usuario se identifique inicialmente. Los ID deben ser únicos y seguir nuestras mejores prácticas de nomenclatura.
Si, en cambio, vas a aplicar hash a un identificador único, asegúrate de normalizar la entrada de tu función hash. Por ejemplo, al codificar una dirección de correo electrónico, elimina los espacios iniciales o finales y ten en cuenta la localización.
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"];
Para una implementación estándar del SDK Web, puedes utilizar el siguiente método:
1
braze.changeUser(YOUR_USER_ID_STRING);
Si quieres utilizar Google Tag Manager en su lugar, puedes utilizar el tipo de etiqueta Cambiar usuario para llamar al métodochangeUser
. Utilízalo siempre que un usuario se conecte o se identifique de otro modo con su identificador único external_id
.
Asegúrate de introducir el ID único del usuario actual en el campo ID externo del usuario, que normalmente se rellena utilizando una variable de capa de datos enviada por tu sitio web.
1
BrazePlugin.changeUser("YOUR_USER_ID");
1
m.Braze.setUserId(YOUR_USER_ID_STRING)
1
AppboyBinding.ChangeUser("YOUR_USER_ID_STRING");
1
UBraze->ChangeUser(TEXT("YOUR_USER_ID_STRING"));
No asignes un ID predeterminado estático ni llames a changeUser()
cuando un usuario cierra la sesión. Si lo haces, no podrás reactivar la interacción de ningún usuario que haya iniciado sesión previamente en dispositivos compartidos. En lugar de eso, lleva un seguimiento de todos los ID de usuario por separado y asegúrate de que el proceso de cierre de sesión de tu aplicación permite volver a un usuario que haya iniciado sesión previamente. Cuando se inicie una nueva sesión, Braze actualizará automáticamente los datos del nuevo perfil activo.
Alias de usuario
Cómo funcionan
% multi_lang_include anonymous_users/about_user_aliases.md %}
Configuración de un alias de usuario
Un alias de usuario consta de dos partes: un nombre y una etiqueta. El nombre se refiere al propio identificador, mientras que la etiqueta se refiere 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 que puedas hacer su seguimiento en todas las plataformas.
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
braze.getUser().addAlias(ALIAS_NAME, ALIAS_LABEL);
1
2
3
4
{
"alias_name" : (required, string),
"alias_label" : (required, string)
}
Mejores prácticas de denominación de ID
Te recomendamos que crees ID de usuario utilizando el estándar Identificador Único Universal (UUID ), lo que significa que son cadenas de 128 bits aleatorias y bien distribuidas.
También puedes utilizar 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 SDK, para evitar la suplantación de identidad de usuarios.
Aunque es esencial que nombres correctamente tus ID de usuario desde el principio, siempre puedes cambiarles el nombre en el futuro utilizando el punto final /users/external_ids/rename
punto final.
Recomendado | No recomendado |
---|---|
123e4567-e89b-12d3-a456-836199333115 | JonDoe829525552 |
8c0b3728-7fa7-4c68-a32e-12de1d3ed2d5 | [email protected] |
f0a9b506-3c5b-4d86-b16a-94fc4fc3f7b0 | NombreEmpresa-1-2-19 |
2d9e96a1-8f15-4eaf-bf7b-eb8c34e25962 | jon-doe-1-2-19 |
Evita compartir detalles sobre cómo creas ID de usuario, ya que esto puede exponer a tu organización a ataques maliciosos o a la eliminación de datos.