Crear nuevo alias de usuario

Utiliza este endpoint para añadir nuevos alias de usuario a usuarios identificados existentes o para crear nuevos usuarios no identificados.

Se pueden especificar hasta 50 alias de usuario por solicitud.

Para añadir un alias de usuario a un usuario existente, debes incluir un external_id en el nuevo objeto de alias de usuario. Si el external_id está presente en el objeto, pero no hay ningún usuario con ese external_id, el alias no se añadirá a ningún usuario. Si no hay un external_id, se creará igualmente un usuario, pero tendrás que identificarlo más adelante. Puedes hacerlo con “Identificación de usuarios” y el endpoint users/identify.

Para crear un nuevo usuario solo con alias, debes omitir el external_id del nuevo objeto de alias de usuario. Una vez creado el usuario, utiliza el endpoint /users/track para asociar al usuario solo con alias con atributos, eventos y compras, y el endpoint /users/identify para identificar al usuario con un external_id.

Puedes enviar campañas desencadenadas por API a usuarios mediante user_alias con el endpoint /campaigns/trigger/send.

Cuando alias_label y alias_name ya existen

La combinación de alias_label y alias_name debe ser única en toda tu base de usuarios. Para más información, consulta Alias de usuario.

Si envías una solicitud en la que el par alias_label y alias_name ya existe para cualquier usuario (ya sea el mismo usuario u otro), el endpoint sigue devolviendo una respuesta correcta (por ejemplo, "aliases_processed": 1, "message": "success"). En ese caso, no se añade ningún alias nuevo al usuario de la solicitud. Como el par alias_label y alias_name ya está en uso, la solicitud no realiza ningún cambio y puede parecer que el alias nunca se añadió al usuario en cuestión.

Solución de problemas

¿Por qué no se actualizan mis atributos después de crear un alias de usuario con este endpoint?

Esto suele ocurrir cuando a /users/alias/new le sigue una solicitud /users/track independiente que intenta actualizar atributos mediante el alias. La solicitud de seguimiento puede procesarse antes de que Braze pueda resolver de forma coherente el nuevo par alias_label y alias_name a un perfil, por lo que los atributos no llegan al usuario que esperas.

Enfoque recomendado: Utiliza una única llamada a /users/track solo cuando quieras crear un perfil solo con alias o actualizar un perfil mediante un alias que ya existe. En la matriz attributes, incluye user_alias y los campos de tu perfil en el mismo objeto de atributos de usuario para que Braze resuelva el usuario y aplique la actualización en un solo paso.

Establece _update_existing_only en false cuando puedas necesitar crear un perfil solo con alias a partir de ese objeto. Si lo omites al utilizar user_alias, Braze aplica de forma predeterminada el comportamiento de solo actualización y no crea el perfil solo con alias. Si el alias ya existe en un usuario de tu espacio de trabajo, la misma solicitud actualiza ese perfil con tus nuevos atributos.

No puedes utilizar /users/track para añadir un nuevo alias a un usuario existente identificado por external_id. En un objeto de atributos de usuario, external_id y user_alias se excluyen mutuamente. Para añadir un alias a un usuario identificado, primero llama a /users/alias/new. Una vez adjuntado el alias, puedes actualizar ese perfil con /users/track mediante external_id o mediante el alias existente.

Por ejemplo, el siguiente cuerpo de /users/track crea un perfil solo con alias si el alias aún no existe, o actualiza el perfil existente que ya tiene ese alias:

1
2
3
4
5
6
7
8
9
10
11
12

{
  "attributes": [
    {
      "user_alias": {
        "alias_name": "[email protected]",
        "alias_label": "email"
      },
      "_update_existing_only": false,
      "string_attribute": "test_alias_only_update"
    }
  ]
}

Puedes descargar el documento OpenAPI y utilizarlo para validar esquemas. Para saber cómo hacerlo, consulta Utilizar esquemas OpenAPI para validar solicitudes.