- Almacenar características del usuario como
subscription_tieroname - Rastrear comportamientos como
purchases,clicksolevels - Segmentar usuarios para mensajes y Journeys
- Personalizar el contenido del mensaje
Reglas de formato de valores de etiquetas de datos
Todos los valores de etiquetas deben ser cadenas de texto. ¡Aún puede almacenar números, marcas de tiempo y valores booleanos, solo conviértalos en cadenas!| Tipo de valor | Ejemplo de formato | Notas |
|---|---|---|
| Etiqueta de texto | "free", "VIP" | Para tipos de usuario, privilegios, estados |
| Número | "42", "3.14" | Habilita filtros numéricos (mayor que, menor que) |
| Marca de tiempo | "1685400000" | Marca de tiempo Unix (en segundos). Use con Operadores de tiempo |
| Booleano | "true" / "false", "1" / "0" | Use "1"/"0" para reducir el tamaño de la carga útil |
Palabras clave restringidas
Las siguientes palabras clave están restringidas y no deben usarse como claves de etiquetas porque se usan internamente para la personalización de mensajes:message, notification, subscription, user, template, app, org, dynamic_content, data_feed, journey, custom_data
Consulte Personalización de mensajes para obtener más detalles.
Etiquetas vs Eventos personalizados
Tags and Custom Events are both ways to add data to your users. However, there are some key differences:| Feature | Tags | Custom Events |
|---|---|---|
| Data usage | Segmentation and personalization | Trigger Journeys without a Segment, Wait Until steps, personalization directly within Journeys |
| Data retention | Lifetime | 30+ days (lifetime storage is available) |
| Data format | Key-value strings or numbers | JSON |
| Data source | OneSignal SDK, API, or integrations (limited) | OneSignal SDK, API, or integrations |
| Data access | Segmentation and message personalization | Journeys and Journey-message-template personalization, Segmentation (Coming soon) |
- Tags for user properties that are static and don’t change often
- Custom Events for real-time scenarios, complex segmentation, and more sophisticated journey workflows
Estrategias de etiquetas recomendadas
Las etiquetas de datos deben representar información que desee usar en mensajes o segmentación de audiencia. No están destinadas a almacenar perfiles de usuario completos o registros; use su base de datos de backend para eso.Tutoriales:
Configuración de carrito abandonado
Recupere ventas perdidas con recordatorios de carrito abandonado.
Contenido dinámico de carrito abandonado
Personalice sus mensajes de carrito abandonado con contenido dinámico.
Etiquetas de comportamiento basadas en eventos
Rastree las acciones del usuario con etiquetas. Ideal para activar Journeys, seguimientos o recordatorios.| Clave | Ejemplo de valor | Descripción |
|---|---|---|
cart_update | "1685400000" | Última vez que el usuario agregó algo al carrito. Use Operadores de tiempo. |
last_order | "1684100000" | Marca de tiempo de la última compra completada |
amount_spent | "100" | Total gastado: número en cadena, sin símbolo de moneda |
social_share | "2" | Conteo de compartidos sociales o referencias |
tutorial_status | "step2" o "completed" | Progreso del tutorial: use valores de cadena legibles o numerados |
Etiquetas de actividad de juegos
Utilizadas por juegos para personalizar según el rendimiento del usuario.| Clave | Ejemplo de valor | Descripción |
|---|---|---|
points | "1250" | Puntos de experiencia o de juego |
level | "8" | Nivel de juego actual |
high_score | "3000" | Puntuación más alta alcanzada |
Etiquetas de estado de cuenta
Use estas para dirigirse a usuarios por nivel de cuenta o cambio de estado.| Clave | Ejemplo de valor | Descripción |
|---|---|---|
user_type | "free", "premium" | Nivel de suscripción o acceso |
has_downgraded | "1" o "1685400000" | Booleano o marca de tiempo de degradación |
user_privileges | "admin", "guest" | Segmentación basada en roles |
Use External ID para identificar usuarios individuales. No use etiquetas para este propósito. Consulte External ID y Aliases.
Etiquetas de personalización
Ideal para personalización de mensajes basada en nombres usando Sustitución de variables.| Clave | Ejemplo de valor | Descripción |
|---|---|---|
first_name | "Jon" | Nombre |
last_name | "Smith" | Apellido |
user_name | "PokeCatcher22" | Nombre de visualización o de pantalla |
Etiquetas de ubicación y demográficas
Segmente usuarios por región o edad.| Clave | Ejemplo de valor | Descripción |
|---|---|---|
region | "New York" | Área metropolitana, opcionalmente use ISO 3166-2 |
postcode | "94105" | Código postal |
location | "Downtown LA" | Ubicación de cadena personalizada |
birthdate | "915148800" | Marca de tiempo Unix en segundos (fecha de nacimiento) |
birth_year | "1998" | Año de nacimiento de cuatro dígitos |
age_range | "18-35" | Útil para segmentación general de audiencia |
Cómo agregar, actualizar y eliminar etiquetas
Puede administrar las etiquetas usando cualquiera de los métodos a continuación, según su caso de uso y configuración técnica.Métodos del SDK (Recomendado)
Configure etiquetas en tiempo real desde su aplicación o sitio web a medida que los usuarios realizan acciones.
API REST
Agregue, actualice o elimine etiquetas del lado del servidor usando nuestra API REST.
Journeys
Aplique etiquetas automáticamente a medida que los usuarios avanzan por los pasos de Journey.
Importación CSV
Actualice etiquetas de usuario de forma masiva cargando un CSV con
external_id o subscription_id.Solicitudes de categoría web
Solicite a los usuarios que seleccionen intereses, que se almacenan como etiquetas.
Mensajes en la aplicación
Recopile o actualice etiquetas según las acciones de clic en mensajes en la aplicación.
Entrada manual
Edite etiquetas directamente desde el panel de OneSignal.
- Vaya a Audience > Users > User Profile > Tags
Integraciones de terceros
Algunas integraciones admiten la sincronización automática de etiquetas.
- Segment, HubSpot, Mixpanel y otros
Preguntas frecuentes
¿Cuántas etiquetas puedo establecer por usuario?
Depende de su plan. Consulte los límites de su plan o contacte a ventas para aumentar su cuota.¿Qué sucede con mis etiquetas si excedo los límites del plan?
No hay límite en la cantidad de etiquetas disponibles dentro de una aplicación de OneSignal. El límite se aplica a cuántas etiquetas se pueden establecer en cada usuario individual a la vez. No puede agregar o actualizar etiquetas para usuarios que están en o por encima de su límite. Debe eliminar etiquetas primero, luego enviar una segunda solicitud para agregar nuevas. Las etiquetas ya establecidas persistirán. Ejemplo: El límite de su plan = 20 etiquetas/usuario.- El usuario tiene 19 etiquetas:
- ✅ Agregar 1 etiqueta nueva = éxito
- ❌ Agregar 2+ etiquetas nuevas = fallo
- El usuario tiene 20 etiquetas:
- ❌ Agregar cualquier etiqueta nueva = fallo
- ✅ Actualizar 1+ etiqueta existente = éxito
¿Dónde puedo verificar el uso de etiquetas?
- Panel: Audience > Users > columna Tags
- Exportar usuarios para una vista completa
¿Cómo reduzco el uso de etiquetas?
- Elimine etiquetas usando el SDK o la API
- Use Importación CSV para eliminar de forma masiva
- Use menos etiquetas más reutilizables (por ejemplo,
status:active)
Need help?Chat with our Support team or email
support@onesignal.comPlease include:- Details of the issue you’re experiencing and steps to reproduce if available
- Your OneSignal App ID
- The External ID or Subscription ID if applicable
- The URL to the message you tested in the OneSignal Dashboard if applicable
- Any relevant logs or error messages