Fusionar usuarios duplicados
Aprende a encontrar y fusionar usuarios duplicados para maximizar la efectividad de tus Campaigns y Canvas.
REST API: Identificar y fusionar usuarios
Las herramientas de esta página fusionan perfiles duplicados en el panel. También puedes combinar o reasignar perfiles mediante los endpoints de datos de usuario de Braze:
- POST: Identificar usuarios (
/users/identify): Combina un perfil que solo tiene alias, solo correo electrónico o solo número de teléfono con un perfil que tiene unexternal_id. - POST: Fusionar usuarios (
/users/merge): Fusiona un perfil de usuario con otro, incluso cuando ambos perfiles ya tienen unexternal_id. Revisa los requisitos previos y el comportamiento de fusión antes de llamar a este endpoint.
Cuando un perfil anónimo coincide con un perfil identificado existente (por ejemplo, mediante una llamada changeUser() del SDK o /users/identify), Braze deja huérfano el perfil anónimo y copia solo ciertos campos en el perfil identificado. Para más información, consulta Qué ocurre cuando identificas usuarios anónimos.
Las fusiones de usuarios son difíciles de deshacer. Si estás planificando una fusión compleja entre varios valores de external_id o migraciones de perfiles a gran escala, ponte en contacto con tu administrador de éxito de cliente de Braze para recibir orientación antes de recurrir a /users/merge.
Braze gestiona de forma diferente tres tipos de usuario al fusionar: usuarios marcados para eliminación, usuarios de prueba y usuarios del Grupo de control global. Para más detalles, consulta Comportamiento de fusión de usuarios.
Fusión individual
Si una búsqueda de usuarios devuelve perfiles duplicados, puedes fusionar cada perfil individualmente desde el perfil del usuario en el panel de Braze.
Paso 1: Buscar un perfil duplicado
En Braze, selecciona Audiencia > Búsqueda de usuarios.

Introduce un identificador único del perfil duplicado, como una dirección de correo electrónico o un número de teléfono, y luego selecciona Buscar.

Paso 2: Fusionar duplicados
Para iniciar el proceso de fusión, selecciona Fusionar duplicados.

Elige qué perfil de usuario conservar y cuál fusionar, y luego selecciona Fusionar perfiles. Repite este proceso hasta que hayas fusionado todos los perfiles duplicados.

Los perfiles de usuario duplicados no se pueden recuperar después de fusionarlos.
Fusión masiva
Cuando fusionas usuarios duplicados de forma masiva, Braze busca perfiles con identificadores coincidentes (como una dirección de correo electrónico) y conserva un solo perfil. Braze da prioridad primero a los perfiles que tienen un external_id y, después, aplica tu configuración de Resolución de empates: Resolver empates usando y Priorización. Si no hay perfiles con un external_id, Braze aplica Resolver empates usando y Priorización a los perfiles sin external_id. Braze solo fusiona usuarios cuando esta configuración identifica un único perfil para conservar. Por ejemplo, si Resolver empates usando es Fecha de actualización y ambos perfiles tienen la misma marca de tiempo de última actualización, Braze no puede resolver el empate, así que esos usuarios no se fusionan.
Paso 1: Ve a Gestionar audiencia
En el panel de Braze, selecciona Audiencia > Gestionar audiencia.

Paso 2: Previsualiza los resultados (opcional)
Para previsualizar los resultados antes de fusionar tus duplicados, selecciona Generar lista de duplicados.

Braze genera la vista previa y la envía a tu dirección de correo electrónico como archivo CSV.
El CSV incluye una columna Creado desde que muestra cómo se creó originalmente cada perfil (por ejemplo, mediante el SDK, la REST API o la importación de CSV). Esto te ayuda a entender el origen del perfil antes de fusionar duplicados.
Cuando revises las filas duplicadas, compara Creado desde con identificadores como external_id, la dirección de correo electrónico y el número de teléfono. Usa este contexto para decidir qué perfil debe conservarse como perfil principal antes de seleccionar Fusionar todos los duplicados.
El campo Creado desde es especialmente útil cuando los perfiles duplicados contienen valores similares pero proceden de distintas vías de ingesta. Le da a tu equipo más contexto para tomar decisiones de fusión y ayuda a reducir fusiones accidentales de perfiles que preferirías mantener separados hasta revisarlos con más detalle.
En el siguiente ejemplo, Braze usa el ID externo del usuario para marcar los perfiles duplicados e identificar cuál conservar. Si estos perfiles se fusionan de forma masiva, Braze usa el perfil con ID externo como nuevo perfil principal del usuario.
| Dirección de correo electrónico | ID externo | Número de teléfono | ID de Braze | Identificador de la regla | Creado desde | Perfil a conservar | Perfil a fusionar |
|---|---|---|---|---|---|---|---|
| [email protected] | 123-external-id | 555 123-4567 | example-id-12345 | sdk | TRUE | FALSE | |
| [email protected] | 555 123-4567 | example-id-12346 | rest | FALSE | TRUE | ||
| [email protected] | 555 123-4567 | example-id-12347 | csv | FALSE | TRUE |
Comportamiento de fusión
Braze completará los campos vacíos del perfil que se conserva con los valores del perfil fusionado. Para ver una lista de los campos que se completarán, consulta Comportamiento de fusión.
Paso 3: Fusiona tus duplicados
Si estás conforme con los resultados de la vista previa, selecciona Fusionar todos los duplicados.

Los perfiles de usuario duplicados no se pueden recuperar después de fusionarlos.
Fusión basada en reglas
Puedes usar reglas para controlar cómo se resuelven los perfiles duplicados al ejecutar una fusión, de modo que se conserve el perfil de usuario más relevante. Cuando estableces reglas, Braze conserva los perfiles que coinciden con tus criterios.
Paso 1: Define tus reglas
- Ve a Audiencia > Administrar audiencia > Editar reglas.
- En la sección Perfil a conservar del panel Editar reglas, selecciona el Identificador de los perfiles que se conservarán al fusionar duplicados. Puede ser la dirección de correo electrónico o el número de teléfono.
- En la sección Resolución de empates, selecciona los criterios para determinar cómo resolver los empates entre perfiles que coinciden con los criterios de Perfil a conservar. Puedes seleccionar lo siguiente:
- Resolver empates usando: Fecha de creación, Fecha de actualización, Última sesión
- Priorización: Más reciente, Más antiguo

Por ejemplo, podrías conservar el perfil que tiene un número de teléfono. Si varios usuarios tienen el mismo número de teléfono, podrías resolver los empates usando el campo Fecha de actualización y priorizar al usuario actualizado más recientemente.
Paso 2: Previsualiza los resultados (opcional)
Después de guardar tus reglas, puedes previsualizar cómo funcionarán seleccionando Generar una lista de duplicados. Braze generará tu vista previa y la enviará a tu dirección de correo electrónico como un archivo CSV que muestra qué usuarios se conservarían y se fusionarían si se aplicaran tus reglas.
Paso 3: Fusiona los duplicados
Si estás satisfecho con los resultados de tu vista previa, vuelve a la página Administrar audiencia y selecciona Fusionar todos los duplicados.

Los perfiles de usuario duplicados no se pueden recuperar después de la fusión.
Fusión programada
Al igual que la fusión basada en reglas, la fusión programada te permite automatizar la fusión diaria de perfiles de usuario mediante reglas preconfiguradas.

Una vez que activas la característica, Braze asigna automáticamente una franja horaria para realizar el proceso de fusión cada día, aproximadamente a las 12 a. m. en la zona horaria de la empresa del usuario. Puedes desactivar la fusión programada en cualquier momento. Braze avisa a los administradores de tu espacio de trabajo 24 horas antes de que se realice la fusión programada, para recordártelo y darte tiempo a revisar la configuración.

Los perfiles de usuario duplicados no se pueden recuperar después de la fusión.
¿Por qué hay varios perfiles de usuario asociados a la misma dirección de correo electrónico?
Braze almacena varios perfiles de usuario que comparten la misma dirección de correo electrónico cuando los perfiles se crean mediante distintos identificadores, importaciones o sesiones anónimas antes de la identificación. Este comportamiento es esperado cuando los usuarios no comparten un único external_id.
Antes de fusionar duplicados, usa el endpoint para exportar perfiles de usuario por identificador para confirmar qué perfiles existen para una dirección de correo electrónico y qué campos contiene cada perfil. También puedes buscar por correo electrónico en Audiencia > Búsqueda de usuarios para revisar los duplicados en el panel.