Eventos personalizados

¿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
Medir conversiones y atribuirlas a los mensajes que las impulsaron
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:

string

requerido

El nombre del evento. Máximo 512 bytes. Los nombres se miden en bytes, por lo que un nombre compuesto por caracteres multibyte alcanza el límite antes de lo que sugiere su número de caracteres.

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.

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.

string

La hora en que ocurrió (u ocurrirá) el evento, formateada como una cadena ISO 8601. Consulte la API de crear eventos personalizados.

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

Límites de nombres de eventos

Cada aplicación puede enviar hasta 1,000 nombres únicos de eventos personalizados. Los eventos enviados con un nombre que su aplicación ya usa siempre se aceptan, por lo que alcanzar el límite nunca interrumpe los eventos que ya está enviando. Una vez que una aplicación alcanza los 1,000 nombres, los eventos enviados con un nombre nuevo se rechazan. OneSignal rechaza el evento individual, no la solicitud, por lo que los demás eventos del mismo lote se procesan normalmente. La API devuelve HTTP 202 con un arreglo errors, y cada evento rechazado lleva el código de error too many event names. Un evento rechazado no se almacena, no se factura y no puede activar un Journey, personalizar un mensaje ni usarse en un segmento. Sí aparece en Data > Events & Conversions, marcado como fallido con el motivo “This app has reached its limit of unique event names”, para que pueda ver qué nombres fueron rechazados. Para liberar espacio, elimine un nombre de evento personalizado que ya no use. Eliminar un nombre libera su espacio y elimina permanentemente los eventos almacenados bajo ese nombre.

La página Custom Events le advierte una vez que su aplicación supera los 900 nombres únicos de eventos, antes de que se rechace cualquier evento.

El límite de nombres es independiente del tiempo que OneSignal conserva cada evento. Consulte Almacenamiento y retención de eventos personalizados para información sobre la retención.

Nombre los eventos de modo que no alcance el límite

El nombre del evento indica qué ocurrió. Todo lo que varía pertenece a las propiedades. Poner un ID, un precio o cualquier otro valor variable en el nombre crea un nuevo nombre único en cada envío y agota rápidamente el límite de 1,000.

{
  "name": "purchase_completed",
  "properties": { "product_id": "SKU-4412", "price": 24.99, "currency": "USD" }
}

{
  "name": "purchase_completed_SKU-4412_24.99"
}

Las propiedades están disponibles en Journeys, conversiones y segmentos.

Eliminar un nombre de evento para liberar un espacio

Eliminar un nombre de evento personalizado libera su espacio y elimina permanentemente los eventos almacenados bajo ese nombre. Esto no se puede deshacer.

Encuentre los eventos que ya no usa

Vaya a Data > Events & Conversions y abra la pestaña Event List. Seleccione un evento para abrir su vista de detalle. El panel Usage muestra cada Journey y segmento que lo referencia, y la marca de tiempo de la última ocurrencia indica si todavía está llegando.

Quite el evento de todo lo que aún lo use

Un evento listado bajo Usage está activo. Actualice o elimine primero esos Journeys y segmentos; de lo contrario, eliminar el nombre afectará su comportamiento.

Elimine el nombre

Abra el menú de la fila junto al nombre del evento y seleccione Delete, luego confirme. Necesita permiso para eliminar eventos personalizados. Si la opción no aparece, pídaselo a alguien de su cuenta con un rol que lo otorgue.

Actualice la página

La eliminación se ejecuta en segundo plano y puede tardar unos minutos. La página no se actualiza por sí sola, así que seleccione Refresh List para confirmar que el nombre desapareció y el espacio está libre.

Enviar eventos personalizados a OneSignal

Todos los eventos se tratan de la misma manera para fines de facturación, independientemente de la fuente.

API y SDK

Create Custom Events API

Envía eventos desde tu backend.

Mobile/Web SDKs

Rastrea eventos del lado del cliente.

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"
    },
    {
      "name": "add_to_cart",
      "properties": {
        "item": "Hoodie",
        "size": "medium",
        "color": "black",
        "price": 49.99
      },
      "external_id": "user_12345",
      "timestamp": "2025-10-21T19:12:10.000Z",
      "idempotency_key": "789a0123-b45c-67d8-e901-234567890abc"
    },
    {
      "name": "signup_completed",
      "properties": {
        "plan": "pro",
        "trial": true
      },
      "external_id": "user_67890",
      "timestamp": "2025-10-21T19:15:44.000Z",
      "idempotency_key": "def01234-5678-90ab-cdef-012345678901"
    }
  ]
}

Integraciones

OneSignal se conecta a más de 25 fuentes de datos externas para importar eventos personalizados, incluyendo almacenes de datos, bases de datos y plataformas de streaming, sin necesidad de código personalizado.

Twilio Segment

Enruta eventos y audiencias entre Segment y OneSignal.

Amplitude

Sincroniza cohortes e importa eventos personalizados de Amplitude.

Snowflake

Importa eventos personalizados desde tu almacén Snowflake.

Google BigQuery

Importa eventos personalizados desde datasets de BigQuery.

Apache Kafka

Transmite eventos personalizados desde topics de Kafka.

Ver todas las fuentes de eventos personalizados

Consulta la lista completa de bases de datos, almacenes y plataformas de streaming que importan eventos personalizados a OneSignal.

¿Sin recursos de desarrollo? Importa eventos personalizados directamente desde una hoja de cálculo de Google Sheets sin necesidad de código. Añade tus datos de evento a una hoja y OneSignal los importa automáticamente. Ideal para experimentación temprana o equipos sin soporte de ingeniería.

Verificar que los eventos se reciben

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

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.

Los eventos personalizados aparecen en la página Custom Events al instante. Sin embargo, puede tomar hasta 5 minutos que los eventos aparezcan en el perfil de un usuario bajo Activity Timeline > Custom Events. Esto se debe a que la página Custom Events refleja la ingesta reciente, mientras que el perfil de usuario se alimenta del almacenamiento a largo plazo.

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.

Medir conversiones

Defina un evento personalizado como métrica de conversión para medir el impacto comercial de su mensajería. OneSignal atribuye las conversiones a los mensajes push, email, SMS, in-app y RCS que las impulsaron usando un modelo de atribución de último toque entre canales. Configure esto en Settings > Analytics > Conversion Metrics, donde elige cómo medir el evento:

Count rastrea la frecuencia con que ocurrió el evento (por ejemplo, 15 compras).
Value suma una propiedad numérica del evento (por ejemplo, $1,250 en ingresos a partir de una propiedad price).

Las conversiones aparecen en el dashboard global de conversiones y en los informes de mensajes, plantillas y Journeys.

Que un evento cuente como conversión es independiente de su configuración de retención. Un evento puede contar para una métrica de conversión incluso cuando la retención está configurada de modo que el evento no se almacene.

Métricas de conversión

Ventanas de atribución, el modelo de atribución e instrucciones de configuración.

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
Los segmentos de eventos personalizados se basan en usuarios. No se pueden combinar con segmentos basados en suscripciones para inclusión o exclusión al enviar mensajes fuera de Journeys, que también se basa en usuarios.
Los filtros basados en tiempo (“ha ocurrido en los últimos X días”) hacen referencia al momento en que OneSignal recibió el evento, no a cuándo ocurrió originalmente. Si está importando eventos históricos y necesita segmentar por la hora original del evento, use un Tag para almacenar la hora del evento como una marca de tiempo unix. El filtro de tag admite un operador “Time Elapsed” para comparaciones dinámicas basadas en tiempo. Tenga en cuenta que los tags son a nivel de usuario, por lo que solo se almacena el valor más reciente.

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 de pago. Enviar eventos es gratuito. OneSignal factura solo los eventos que usted almacena, que es lo que necesitan los segmentos y los perfiles de usuario.

Almacenamiento y retención de eventos personalizados

Active el almacenamiento, configure la retención por evento y administre sus eventos almacenados.

Preguntas frecuentes de facturación

Cómo aparece el almacenamiento de eventos en su factura.

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ística	Etiquetas	Eventos personalizados
Uso de datos	Segmentación y personalización	Activar journeys sin un segmento, pasos de esperar hasta, personalización directamente dentro de journeys
Retención de datos	De por vida	Ilimitada (mín. 30 días)
Formato de datos	Cadenas o números clave-valor	JSON
Fuente de datos	SDK de OneSignal, API o importación CSV	SDK de OneSignal, API o integraciones
Acceso a datos	Segmentación y personalización de mensajes	Journeys 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

​¿Qué son los eventos personalizados?

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

​Estructura del evento personalizado

​Límites de nombres de eventos

​Nombre los eventos de modo que no alcance el límite

​Eliminar un nombre de evento para liberar un espacio

​Enviar eventos personalizados a OneSignal

​API y SDK

Create Custom Events API

Mobile/Web SDKs

​Integraciones

Twilio Segment

Amplitude

Snowflake

Google BigQuery

Apache Kafka

Ver todas las fuentes de eventos personalizados

​Verificar que los eventos se reciben

​Pestaña Event List

​Pestaña Event Activity

​Usar eventos personalizados en OneSignal

​Activar reglas de entrada y salida de Journey

Configuración de Journey

​Controlar el flujo del Journey (Wait Until)

Paso Wait Until del Journey

​Personalizar Journeys con propiedades del evento

Personalización con eventos personalizados

​Medir conversiones

Métricas de conversión

​Segmentar usuarios con eventos personalizados

Segmentación

​Disponibilidad de plan y costos de retención

Almacenamiento y retención de eventos personalizados

Preguntas frecuentes de facturación

​Tags vs eventos personalizados

¿Qué son los eventos personalizados?

¿Cuándo debería usar eventos personalizados?

Estructura del evento personalizado

Límites de nombres de eventos

Nombre los eventos de modo que no alcance el límite

Eliminar un nombre de evento para liberar un espacio

Enviar eventos personalizados a OneSignal

API y SDK

Integraciones

Verificar que los eventos se reciben

Pestaña Event List

Pestaña Event Activity

Usar eventos personalizados en OneSignal

Activar reglas de entrada y salida de Journey

Controlar el flujo del Journey (Wait Until)

Personalizar Journeys con propiedades del evento

Medir conversiones

Segmentar usuarios con eventos personalizados

Disponibilidad de plan y costos de retención

Tags vs eventos personalizados