Saltar al contenido principal

​
¿Qué son los eventos personalizados?

Un evento personalizado es una acción (o inacción) del usuario con un nombre que usted envía a OneSignal. Usted envía eventos desde su aplicación, sitio web o sistemas externos para poder activar automatizaciones, controlar el flujo de Journeys y personalizar las experiencias del usuario en tiempo real. Ejemplos incluyen:
  • Incorporación completada
  • Realizó una compra
  • Abandonó un carrito
  • Canceló una suscripción
  • Alcanzó un nuevo nivel de juego
Cuando OneSignal recibe un evento personalizado, usted puede:
  • Iniciar un Journey
  • Continuar un Journey con un paso Wait Until
  • Hacer que los usuarios salgan de un Journey
  • Personalizar mensajes usando propiedades del evento
  • Segmentar usuarios por comportamiento (Acceso Anticipado)

​
¿Cuándo debería usar eventos personalizados?

Use eventos personalizados cuando:
  • La mensajería debe responder al comportamiento del usuario en tiempo real
  • Los datos representan algo que ocurrió (no un estado permanente)
  • Necesita propiedades del evento para personalización o lógica de Journey
No use eventos personalizados cuando:
  • Desea almacenar atributos de usuario a largo plazo (use Tags en su lugar)
Los eventos personalizados representan algo que ocurrió en un momento específico en el tiempo. A diferencia de los Tags, no actualizan permanentemente el perfil del usuario — registran comportamiento.Consulte Tags vs eventos personalizados a continuación para una comparación detallada.

​
Estructura del evento personalizado

Los eventos personalizados incluyen los siguientes campos:
​
name
string
requerido
El nombre del evento. Máximo 128 caracteres.
​
properties
object
Parámetros opcionales que describen el evento (por ejemplo: nombre del plan, ID del producto o precio). Estos se pueden usar para personalización y control de flujo de Journey.
​
external_id
string
El ID externo del usuario. Se requiere un identificador de usuario cuando se utiliza la API de crear eventos personalizados. Se debe proporcionar external_id o onesignal_id.
​
timestamp
string
La hora en que ocurrió (u ocurrirá) el evento, formateada como una cadena ISO 8601. Consulte la API de crear eventos personalizados.
​
idempotency_key
string
Un UUID único utilizado para evitar el procesamiento duplicado de eventos. Consulte la API de crear eventos personalizados.
Límites de tamaño de eventos:
  • Carga útil máxima del evento: 2024 bytes
  • Tamaño máximo de solicitud (múltiples eventos): 1 MB

​
Enviar eventos personalizados a OneSignal

Envíe eventos personalizados usando los siguientes métodos:
Todos los eventos se tratan de la misma manera para fines de facturación, independientemente de la fuente.
Ejemplo de carga útil de evento personalizado:
JSON
{
  "events": [
    {
      "name": "purchase",
      "properties": {
        "item": "T-shirt",
        "size": "small",
        "color": "blue",
        "price": 24.99
      },
      "external_id": "user_12345",
      "timestamp": "2025-10-21T19:09:32.263Z",
      "idempotency_key": "123e4567-e89b-12d3-a456-426614174000"
    }
  ]
}

​
Verificar que los eventos se reciben

Después de enviar eventos, confirme que están llegando a OneSignal en Data > Custom Events.

​
Pestaña Event List

La pestaña Event List proporciona una vista general de todos los eventos personalizados en su aplicación, organizados por nombre de evento. Para cada tipo de evento, puede ver:
  • Total de eventos ingestados
  • Evento más reciente (con la carga útil JSON completa y sus propiedades)
  • Fuente del evento (SDK, API o integración)
  • Marca de tiempo de la última ocurrencia
Seleccione un evento para abrir su vista de detalle, donde también puede actualizar su período de retención. La vista de detalle incluye:
  • Desglose por fuente: Número de eventos ingestados por fuente. Expanda para ver el esquema más reciente del evento y la marca de tiempo del evento más reciente.
  • Actividades: Los 10 eventos más recientes, incluyendo fuente y marca de tiempo. Expanda cualquier entrada para inspeccionar la carga útil JSON completa.
  • Uso: Dónde se está utilizando actualmente el evento (Journeys o segmentos). Haga clic directamente en el Journey o segmento asociado para modificar su configuración.

​
Pestaña Event Activity

La pestaña Event Activity proporciona un feed en vivo de los eventos más recientes ingestados en su aplicación de OneSignal. Úsela para:
  • Filtrar por nombre de evento, fuente o ID externo
  • Inspeccionar cargas útiles JSON completas
  • Depurar problemas de integración
El feed no se actualiza automáticamente. Actualice manualmente después de enviar nuevos eventos.

​
Usar eventos personalizados en OneSignal

Después de que los eventos estén fluyendo hacia OneSignal, puede usarlos de las siguientes maneras:

​
Activar reglas de entrada y salida de Journey

Establezca un evento personalizado como regla de entrada o salida de un Journey para agregar o eliminar usuarios inmediatamente cuando ocurra el evento. Ejemplo:
  • signup_completed → Iniciar incorporación o eliminar de un Journey de incentivo de prueba
  • purchase → Enviar confirmación y venta cruzada o eliminar del Journey de carrito abandonado

Configuración de Journey

Ingrese usuarios a Journeys con eventos personalizados.

​
Controlar el flujo del Journey (Wait Until)

Use un paso Wait Until para retener a los usuarios hasta que ocurra un evento personalizado. Ejemplo:
  • Esperar hasta purchase después de added_to_cart
Puede definir una ventana de expiración. Si el usuario no activa el evento a tiempo, puede enviar un mensaje alternativo o salir del Journey.

Paso Wait Until del Journey

Retenga a los usuarios hasta que ocurra un evento personalizado.

​
Personalizar Journeys con propiedades del evento

Haga referencia a las propiedades del evento usando Liquid en las plantillas de su Journey. Ejemplo:
Liquid
Thanks for purchasing {{ journey.first_event.properties.item }}!

Personalización con eventos personalizados

Guía completa para usar propiedades de eventos y personalizar Journeys.

​
Segmentar usuarios con eventos personalizados

Cree un segmento basado en la ocurrencia de un evento personalizado.
La segmentación con eventos personalizados está en Acceso Anticipado.Para solicitar acceso, envíe un correo electrónico a support@onesignal.com con:
  • El nombre de su empresa
  • Su(s) ID(s) de aplicación de OneSignal
Limitaciones actuales:
  • No es compatible con Email Warm Up ni pruebas A/B
  • No puede impulsar Journeys
  • No se puede combinar con otros filtros de segmento

Segmentación

Guía completa de segmentación.

​
Disponibilidad de plan y costos de retención

Los eventos personalizados están disponibles en todos los planes pagos.

Preguntas frecuentes de facturación

Conozca sobre retención y precios de eventos.

​
Tags vs eventos personalizados

Las etiquetas y los eventos personalizados son ambas formas de agregar datos a sus usuarios. Sin embargo, existen algunas diferencias clave:
CaracterísticaEtiquetasEventos personalizados
Uso de datosSegmentación y personalizaciónActivar journeys sin un segmento, pasos de esperar hasta, personalización directamente dentro de journeys
Retención de datosDe por vida30+ días (el almacenamiento de por vida está disponible)
Formato de datosCadenas o números clave-valorJSON
Fuente de datosSDK de OneSignal, API o integraciones (limitado)SDK de OneSignal, API o integraciones
Acceso a datosSegmentación y personalización de mensajesJourneys y personalización de plantillas de mensajes de journey, segmentación (Próximamente)
La distinción clave entre etiquetas y eventos personalizados está en su profundidad y casos de uso. Las etiquetas son propiedades de un usuario, como nombre, estado de cuenta o ubicación. Los eventos son cosas que el usuario ha hecho, como comprar un artículo, completar un nivel o invitar a un amigo. Tanto las etiquetas como los eventos pueden usarse para segmentación y personalización. En la práctica, probablemente usará ambos:
  • Etiquetas para propiedades de usuario que son estáticas y no cambian con frecuencia
  • Eventos personalizados para escenarios en tiempo real, segmentación compleja y flujos de trabajo de journey más sofisticados