Solución de problemas de Segments

Busca tu síntoma a continuación para encontrar la sección correcta. Esta página cubre errores de lanzamiento, elegibilidad de usuarios, problemas con filtros y discrepancias en los análisis. Para definiciones de filtros, consulta Filtros de segmentación. Para estimaciones de tamaño de Segments, recuentos exactos y gráficos de membresía histórica, consulta Medir el tamaño de un Segment.

Empieza aquí: identifica tu síntoma

Ruta de investigación estándar

Usa este flujo de trabajo cuando un usuario debería estar en un Segment pero no lo está, o cuando el recuento de un Segment parece incorrecto.

1. Lanzamiento bloqueado: si ves un error de complejidad de audiencia o de filtro de 10.000 bytes en una campaña o Canvas, empieza con Errores (solución alternativa con CSV, simplificación de filtros).
2. Vista previa de usuario o búsqueda de usuario: prueba un usuario específico contra los filtros de tu Segment. Cuando un usuario no coincide con parte o la totalidad de los criterios, los criterios faltantes se enumeran para la solución de problemas. Para los pasos, consulta Probar Segments en Crear un Segment.
3. Calcular estadísticas exactas: si la estimación del Segment muestra 0 usuarios o parece incorrecta, selecciona Calcular estadísticas exactas en el panel de Usuarios alcanzables. Guarda tu Segment antes de calcular. Si ya se está ejecutando un cálculo, espera a que termine; los números obsoletos pueden mostrarse hasta que se complete el nuevo cálculo. Para más detalles, consulta Calcular estadísticas exactas.
4. Verifica los valores de los filtros: busca errores tipográficos, discrepancias de tipos de datos, referencias obsoletas a pasos de Canvas y filtros negativos + lógica OR.
5. Verifica la complejidad: si el lanzamiento está bloqueado, consulta La audiencia objetivo es demasiado compleja para lanzar.
6. Ponte en contacto con Soporte: si sigues bloqueado, ponte en contacto con soporte de Braze.

El Segment muestra cero usuarios

El tamaño del Segment en el dashboard suele ser una estimación basada en una muestra de usuarios. Los Segments muy pequeños pueden mostrar un rango estimado que incluye 0, incluso cuando hay usuarios que coinciden con tus filtros.

• Selecciona Calcular estadísticas exactas en el panel de Usuarios alcanzables para obtener un recuento preciso. Guarda el Segment primero. Para más información, consulta Consideraciones para recuentos estimados.
• Si la Vista previa de usuario devuelve cero usuarios para un Segment pequeño, eso no significa necesariamente que el Segment esté vacío. Ejecuta Calcular estadísticas exactas para confirmar. Para más información, consulta Vista previa de usuario.

Membresía retroactiva de Segment

Braze no almacena la membresía histórica de Segments por usuario. No puedes consultar si un usuario específico estaba en un Segment en un momento de envío pasado.

Para capturar la membresía en un momento determinado, exporta los usuarios del Segment en el dashboard o llama al punto de conexión /users/export/segment antes de enviar una campaña o Canvas. Para más información, consulta Filtros de segmentación (filtro de membresía de Segment) y Exportar datos de Segment a CSV.

Errores

La audiencia objetivo es demasiado compleja para lanzar

Este error poco frecuente ocurre si tu audiencia objetivo contiene demasiados valores regex, valores regex excesivamente largos, filtros excesivamente detallados (como «es cualquiera de 30.000 códigos postales») o demasiados filtros. Esto incluye todos los filtros en la audiencia de una campaña o Canvas, ya sea que los filtros estén ubicados dentro de los Segments referenciados o añadidos como filtros en el paso Público objetivo.

Cuando añades filtros de Segment a una campaña o Canvas, esos filtros se traducen en consultas en Braze (el recuento de caracteres de estas consultas no es 1:1 con el número de caracteres que un usuario del dashboard ve). Cuando Braze envía una campaña o Canvas, ejecuta una consulta que combina todos los filtros en la audiencia objetivo. Aplicamos un umbral que limita el número de caracteres en la consulta resultante para una audiencia objetivo. Para una campaña o Canvas determinado, sumamos el recuento de caracteres de todos los Segments referenciados, incluyendo todos los filtros adicionales. Para un Segment determinado, sumamos el recuento de caracteres de todos los filtros y valores de filtro.

Tu dashboard mostrará un error cuando una campaña, Canvas o Segment exceda el umbral y no pueda lanzarse. Si recibes este error, simplifica tu audiencia objetivo antes de lanzar de nuevo, incluyendo:

• Si tu audiencia hace referencia a múltiples Segments, asegúrate de que los Segments no tengan redundancias, como los mismos filtros apareciendo en múltiples Segments.
• Asegúrate de que no estés haciendo referencia a datos obsoletos en los filtros de Segment. Por ejemplo, un filtro obsoleto podría buscar usuarios que no hayan recibido un determinado paso en Canvas en la última semana, aunque el Canvas haya estado detenido durante meses.
• Los Segments que son simplemente listas de ID de usuario o correos electrónicos (que a menudo usan un filtro regex) pueden convertirse a una importación CSV y simplificarse en un único filtro CSV.
• Si tienes CDI, es posible que puedas crear un Segment CDI que extraiga el grupo directamente de tu almacén de datos.

También puedes ponerte en contacto con Soporte para obtener asistencia adicional con la optimización de filtros.

Nota

Comenzamos a limitar los recuentos de caracteres en abril de 2025. Las campañas y Canvas que se lanzaron antes de abril de 2025 estaban exentos, lo que significa que pueden seguir excediendo el límite, mientras que las campañas y Canvas recién creados no pueden exceder el límite. Si editas o clonas una campaña o Canvas exento, no podrás lanzarlo hasta que la audiencia se actualice para estar por debajo del límite.

X campañas o Canvas activos o detenidos exceden el umbral de complejidad de audiencia

Este banner se muestra en la parte superior de una lista de campañas o Canvas siempre que haya campañas o Canvas activos o detenidos con audiencias que excedan el umbral de complejidad de audiencia. Selecciona el banner para filtrar la lista y mostrar solo las campañas o Canvas que exceden el umbral, luego sigue los pasos de solución de problemas en La audiencia objetivo es demasiado compleja para lanzar.

El filtro excede 10.000 bytes o es demasiado largo para guardar

Braze limita los filtros individuales de Segment a un máximo de 10.000 bytes, lo que equivale a 10.000 caracteres en inglés o 3.333 caracteres japoneses. Aparece una advertencia siempre que un filtro individual excede 10.000 bytes, ya sea que el filtro esté dentro de un Segment o añadido directamente a una campaña o Canvas.

Este error ocurre muy raramente, pero cuando ocurre, suele ser con filtros regex que apuntan a una lista de ID de usuario o direcciones de correo electrónico. En ese caso, puedes seguir estos pasos para convertir los filtros a un CSV:

1. Exporta los usuarios del Segment afectado o del filtro regex específico.
2. Limpia el CSV según sea necesario. Necesitas el ID de Braze o el ID de Appboy, pero puedes eliminar todas las demás columnas si no son necesarias. También recomendamos revisar tus datos para confirmar que son recientes (por ejemplo, elimina usuarios que ya no estés intentando segmentar).
3. Importa el archivo CSV de nuevo, lo que agrupa automáticamente a los usuarios en un único filtro basado en CSV altamente eficiente.

Comportamiento del usuario

El usuario ya no está en un Segment

Si un usuario no está disponible al crear un Segment, sus datos de usuario que determinan su elegibilidad para el Segment podrían haber cambiado como resultado de su propia actividad u otras campañas y Canvas con los que haya interactuado previamente. Si la reelegibilidad está activada, su perfil de usuario mostrará los datos más recientes de la campaña recibida.

Para probar si un usuario específico coincide con tu Segment hoy, usa la Vista previa de usuario o búsqueda de usuario.

Se muestra información de usuarios de otras aplicaciones cuando filtro por una aplicación específica

Los usuarios pueden tener múltiples aplicaciones, por lo que seleccionar una aplicación específica en la sección Aplicaciones utilizadas de la página de segmentación arrojará resultados para usuarios que al menos tengan esa aplicación. El filtro no arroja resultados para los usuarios que exclusivamente tienen esa aplicación.

Filtrado

Las opciones de filtro cambiaron

Tus opciones de filtro están relacionadas con el formato (tipo de datos) que estás pasando a Braze para tu atributo personalizado. Para revisar el tipo de datos que Braze está reconociendo para tus atributos personalizados, ve a Configuración de datos > Atributos personalizados.

Si tus opciones de filtro han cambiado, esto es una indicación de que tus datos se están pasando a Braze en un formato (tipo de datos) diferente al anterior. Para descripciones detalladas de los diferentes tipos de datos y sus opciones de filtrado, consulta tipos de datos de atributos personalizados.

Ten en cuenta que cambiar el tipo de datos de un atributo personalizado en el dashboard rechazará los datos que se envíen a Braze en un formato diferente. No puedes cambiar el tipo de datos de un atributo personalizado mientras ese atributo esté referenciado en campañas, Canvas o Segments activos; el dashboard mostrará un error y bloqueará el cambio.

La pestaña Valores de un atributo personalizado muestra resultados de una muestra de aproximadamente 250.000 usuarios. No uses la pestaña Valores para confirmar si un valor de atributo específico existe para la solución de problemas. Para más información, consulta Pestaña de valores.

El Segment es mucho más grande de lo esperado

Si tu Segment parece mucho más grande de lo que esperas a pesar de tener filtros que parecen restrictivos, verifica si estás usando filtros negativos (no es, no es igual a, no coincide con regex o no incluido) con el operador OR en el mismo atributo más de una vez. Esa combinación puede segmentar usuarios con todos los valores para el atributo.

Para orientación sobre cuándo usar AND en lugar de OR, consulta Cuándo evitar el operador OR en Crear un Segment.

Análisis e informes

Mensajes enviados o Destinatarios únicos en los análisis de Campaign no coinciden con el recuento del Segment

Si el recuento en los análisis de tu campaña para Mensajes enviados o Destinatarios únicos no coincide con el número de usuarios en el filtro de Segment Has received message from campaign X, podría haber tres posibles razones.

1. Los usuarios pueden haber sido archivados, huérfanos o eliminados desde el lanzamiento de la campaña
   
   Por ejemplo, supongamos que 1.000 usuarios reciben una campaña y haces una exportación CSV el mismo día. Verás 1.000 usuarios reportados. Durante el mes siguiente, 50 de esos 1.000 usuarios son eliminados (por ejemplo, mediante el punto de conexión users/delete). Cuando hagas otra exportación CSV, verás 950 usuarios reportados, mientras que el recuento de Destinatarios únicos en los análisis de Campaign sigue siendo 1.000.
   
   En otras palabras, la métrica de Destinatarios únicos es un recuento incremental, mientras que el segmentador y la exportación CSV proporcionan un recuento de usuarios existentes actualmente.
   
   

2. La campaña tiene la reelegibilidad configurada, por lo que los usuarios pueden volver a entrar en la campaña múltiples veces
   
   Por ejemplo, supongamos que una campaña de correo electrónico tiene la reelegibilidad configurada en cero minutos (los usuarios pueden volver a entrar en la campaña siempre que cumplan con los requisitos del Segment de audiencia), y la campaña ha estado ejecutándose durante más de un mes. El número de Mensajes enviados en los análisis de Campaign no coincidiría con el número en el Segment porque este campo incluiría mensajes enviados a usuarios duplicados.
   
   Esto se debe a que Braze cuenta los usuarios únicos como Destinatarios diarios únicos, o el número de usuarios que recibieron un mensaje particular en un día. Esto significa que los usuarios reelegibles se cuentan más de una vez como destinatario único porque la ventana de «unicidad» solo dura un día. Esto puede resultar en que el número de Destinatarios diarios únicos sea mayor que el número de perfiles de usuario en la exportación CSV. Los perfiles de usuario en el archivo CSV son verdaderamente únicos.
   
   

3. Usuarios que comparten un identificador de canal coincidieron con el filtro
   
   El filtro Has received message from campaign X (y otros filtros de «recibido») puede coincidir con usuarios que comparten un identificador de canal, como el mismo token de notificaciones push o dirección de correo electrónico, con otro perfil de usuario que recibió, abrió o hizo clic en el mensaje.

El usuario está asignado a dos aplicaciones a pesar de haber registrado una sesión en solo una aplicación

Al crear un Segment, puedes segmentar usuarios que hayan utilizado aplicaciones específicas. Un usuario necesita haber tenido una sesión en una aplicación específica para ser asignado a esa aplicación; sin embargo, hay dos escenarios en los que un usuario puede ser asignado a una aplicación específica sin haber registrado sesiones en la aplicación.

El primer escenario es si el campo app_id está poblado al usar el punto de conexión /users/track, específicamente al usar un objeto de evento o un objeto de compra, como en este ejemplo:

1
2
3
4
5
6
7
8
9
10
{
    "events": [
    {
      "external_id": "john_doe123",
      "app_id": "my_web_app_id",
      "name": "Custom Event",
      "time": "2025-08-17T19:20:30+1:00"
    }
  ]
}

El segundo escenario es si el campo app_id está poblado al usar el punto de conexión /users/track para migrar tokens push, como en este ejemplo:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
{
"app_group_id": "{YOUR_APP_GROUP_ID}",
"attributes": [
{
      "push_token_import": false,
      "external_id": "external_id1",
      "country": "US",
      "language": "en",
      "{YOUR_CUSTOM_ATTRIBUTE}": "{YOUR_VALUE}",
      "push_tokens": [
        {"app_id": "{APP_ID_OF_OS}", "token": "{PUSH_TOKEN_STRING}"}
      ]
  }
]
}