Saltar al contenido principal
Los aliases personalizados le permiten asignar identificadores clave-valor personalizados a usuarios en OneSignal, habilitando el seguimiento e identificación de usuarios multiplataforma usando sus propios ID internos.
Importante: Debe establecer un External ID antes de usar aliases personalizados.OneSignal usa un onesignal_id único para identificar usuarios. Este ID solo permanece consistente entre Suscripciones si tienen el mismo external_id.Los aliases personalizados no vinculan suscripciones entre sí: dependen del external_id para funcionar correctamente. Sin él, los aliases no se asociarán con el mismo usuario en diferentes dispositivos o plataformas.

​
¿Qué es un alias personalizado?

Un alias personalizado es un par clave : valor donde:
  • El alias_label (clave) es un identificador consistente y estático para todos los usuarios (por ejemplo, facebook_id, firebase_id, crm_user_id).
  • El alias_id (valor) es el ID específico del usuario para esa etiqueta (por ejemplo, facebook_id: 3453443, firebase_id: test3555).
Esto le permite vincular registros de usuarios de OneSignal a identificadores de sus otras plataformas o bases de datos.

​
¿Por qué usar aliases?

  1. Identificar usuarios en múltiples plataformas y bases de datos.
  2. Enviar mensajes transaccionales dirigidos usando la API REST Create Message.
  3. Obtener, actualizar o eliminar usuarios a través de las API REST de usuarios.

​
Cómo establecer aliases

Puede establecer aliases usando el SDK de OneSignal o a través de la API REST.

​
Usar el SDK

Siga estos pasos en su aplicación:
  1. Establecer el External ID Llame a OneSignal.login(externalId) para asociar el registro del usuario.
  2. Establecer aliases personalizados Use OneSignal.User.addAlias(label, id) para agregar un solo alias, o OneSignal.User.addAliases({ label1: id1, label2: id2 }) para establecer múltiples.
  3. Cerrar sesión (opcional) Use OneSignal.logout() para eliminar el external ID y cualquier alias asociado para ese dispositivo o sesión.
Ejemplo: 
OneSignal.login("user_123");

OneSignal.User.addAliases({
  facebook_id: "3453443",
  firebase_id: "test3555"
});

// Más tarde, cuando el usuario cierre sesión
OneSignal.logout();

​
Usar la API REST

Para establecer aliases personalizados a través de la API, use el endpoint Create Alias. Este método se usa típicamente en sistemas backend para la gestión de usuarios del lado del servidor. Ejemplo de solicitud: 
POST /aliases
{
  "subscription_id": "abc123",
  "aliases": {
    "facebook_id": "3453443",
    "crm_user_id": "XYZ789"
  }
}

​
Mejores prácticas

  • Siempre establezca el external_id antes de asignar cualquier alias.
  • Use etiquetas estables y descriptivas (por ejemplo, crm_user_id, legacy_user_id) para evitar confusión entre equipos.
  • Evite usar información sensible como direcciones de correo electrónico o números de teléfono como valores de alias.
  • Use logout() para limpiar aliases al cerrar sesión del dispositivo o cambiar eventos de usuario.
¡Tutorial de aliases personalizados completado! Próximos pasos:
  • Revise nuestra documentación de Usuarios y Suscripciones si aún no lo ha hecho.
  • Explore nuestra documentación de API REST para obtener más detalles sobre el uso de aliases a través de la API.
  • Configure Integraciones para sincronizar datos de usuarios entre sistemas.