Saltar al contenido principal

​
Descripción general

Los eventos personalizados le permiten rastrear acciones significativas del usuario desde su aplicación, sitio web o sistemas externos, y actuar sobre ellas en tiempo real. Envíe eventos de usuario para comportamientos que ocurren fuera de OneSignal y úselos para entregar mensajería más dirigida, relevante y oportuna. Puede:
  • Enviar eventos directamente desde su aplicación o sitio web usando los SDKs de OneSignal
  • Importar eventos desde sus integraciones, CDP o almacén de datos
  • Usarlos para activar Journeys, activar pasos Wait Until y segmentar usuarios según el comportamiento en tiempo real (opción de segmentación próximamente)
Casos de uso de ejemplo:
  • Usuario se registra → Iniciar Journey de incorporación
  • Usuario abandona checkout → Enviar recordatorio u oferta
  • Jugador alcanza nuevo nivel → Enviar recompensa in-app
  • Usuario intenta cancelar cuenta → Activar campaña de recuperación

​
¿Qué es un evento personalizado?

Un evento personalizado es cualquier acción del usuario rastreada — o inacción — que importa a su negocio. Los ejemplos comunes incluyen:
  • Realizar una compra
  • Completar un nivel de juego
  • Iniciar un entrenamiento
  • Cancelar una suscripción
Cada evento puede incluir propiedades para proporcionar contexto adicional. Estructura del evento personalizado:
  • name (string, requerido) — Nombre del evento, máximo 128 caracteres
  • properties (objeto, opcional) — Datos de contexto en JSON
  • Identificador de usuario (requerido) — Ya sea external_id o onesignal_id
Ejemplo: 
{
  "events": [
    {
      "external_id": "user_12345",
      "timestamp": "2025-10-21T19:09:32.263Z",
      "name": "purchase",
      "properties": {
        "item": "T-shirt",
        "size": "small",
        "color": "blue",
        "price": 24.99
      }
    }
  ]
}
Los eventos personalizados pueden ser:
  • Producidos en tiempo real desde su aplicación o sitio (SDKs móviles/web de OneSignal)
  • Ingestados desde integraciones como Segment, Amplitude o Databricks (próximamente)
  • Importados desde su almacén de datos o CDP (próximamente)

​
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

​
Introducir eventos personalizados en OneSignal

Puede generar eventos directamente con nuestras APIs o ingestarlos desde otros sistemas.
Todos los eventos — ya sean generados desde un SDK o ingestados desde un almacén de datos — se tratan de la misma manera para fines de facturación.

​
API y SDKs de OneSignal

Envíe eventos a través de: Ejemplo: Enviar a través de la API
curl
curl --request POST \
  --url https://api.onesignal.com/apps/{app_id}/custom_events \
  --header 'Content-Type: application/json' \
  --data '{
  "events": [
    {
      "name": "completed_onboarding",
      "external_id": "user_12345",
      "properties": {
        "plan": "Pro",
        "time_to_complete": 600
      }
    }
  ]
}'
​
name
string
required
El identificador o nombre del evento. Máximo 128 caracteres.
​
external_id
string
El ID externo del usuario objetivo del evento. Se requiere el ID externo del usuario o el ID de OneSignal.
​
properties
object
Parámetros opcionales sobre el evento (por ejemplo, nombre del plan, ID del producto, precio).
Este evento agregará inmediatamente al usuario con external_id user_12345 a un Journey con completed_onboarding como activador de regla de entrada de evento personalizado o acción wait until.

​
Integraciones

Si los eventos ya se rastrean en otro lugar, impórtelos a través de las integraciones admitidas.

​
Ver y verificar eventos

Después de que los eventos comiencen a fluir, puede verlos y solucionarlos a través de varias herramientas en OneSignal.

​
Pestaña Event List

Navegue a su organización

La pestaña Event List proporciona un panel de alto nivel de sus eventos, organizados por tipo de evento. Para cada tipo de evento, puede ver el número total de eventos ingestados, el evento ingestado más recientemente (mostrado en formato JSON con sus propiedades), la fuente del evento (SDK, API o integración), y la última vez que ocurrió el tipo de evento. Dentro de la vista de detalles de cada evento, también tiene la opción de actualizar su período de retención. La vista de sub-detalles ofrece información adicional en tres áreas clave:
  • Desglose de fuente – Muestra el número de eventos ingestados por fuente, con la opción de expandir y ver el esquema más reciente de los eventos junto con la marca de tiempo del último evento visto.
  • Actividades – Lista los 10 eventos más recientes ingestados, mostrando su fuente y marca de tiempo. Cada entrada se puede expandir para revelar la carga útil JSON completa del evento.
  • Uso – Muestra dónde se está utilizando un evento particular dentro de OneSignal, como en segmentos o journeys. Desde aquí, puede hacer clic directamente en el segmento o journey relevante para acceder a su configuración.

​
Pestaña Event Activity

Navegue a su organización

La pestaña Event Activity proporciona un feed en vivo de los eventos más recientes ingestados en su aplicación de OneSignal. Puede expandir el feed para revisar eventos de hasta 90 días atrás y aplicar filtros por fuente, propiedades de evento o ID externo. Esta pestaña es especialmente útil para depurar problemas al configurar fuentes de eventos, ya que le permite validar si los eventos están llegando a su aplicación como se espera. Tenga en cuenta que el feed no se actualiza automáticamente, por lo que deberá actualizarlo manualmente después de enviar nuevos eventos para ver la actividad más reciente.

​
Pestaña Event Storage (Próximamente)

Una vista dedicada para administrar el almacenamiento de los eventos para su aplicación de OneSignal.

​
Usar eventos personalizados en OneSignal

​
Activar Journeys con eventos

Los Journeys activados por eventos le permiten enviar mensajes a los usuarios inmediatamente en función de la actividad en tiempo real, sin necesidad de esperar actualizaciones de segmentos. Puede iniciar un Journey en el momento en que un usuario realiza una acción clave.

​
Evento Wait Until

Use el paso Wait Until para pausar a los usuarios en un Journey hasta que ocurra un evento personalizado específico u otra acción.
También puede definir una ventana de expiración. Si el usuario no cumple la condición a tiempo, puede continuar por una ruta alternativa, enviar un mensaje alternativo o salir del Journey.

​
Segmentación por eventos personalizados

La segmentación con eventos personalizados está actualmente en acceso anticipado. Para solicitar acceso, contacte a support@onesignal.com con:
Puede crear un segmento basado en la ocurrencia de un evento personalizado. Esto le permitirá segmentar usuarios según el comportamiento en su aplicación usando el SDK de OneSignal o desde eventos capturados fuera de OneSignal. Hay más detalles sobre segmentación de eventos personalizados disponibles en la página de segmentación. Limitaciones en esta función mientras está en acceso anticipado:
  • No se puede usar con Email Warm Up y pruebas A/B.
  • Los segmentos de eventos personalizados no se pueden usar para impulsar Journeys.
  • Aún no puede combinar filtros de eventos personalizados con otros filtros de segmentación (como propiedades de usuario o eventos de mensajes).

​
Disponibilidad de plan y costos de retención

Los eventos personalizados están disponibles en todos los planes pagos. Consulte las preguntas frecuentes de facturación para más detalles.