- Enviar mensajes de bienvenida a los usuarios que inician una prueba gratuita o se suscriben.
- Volver a atraer a usuarios que abandonaron con encuestas o descuentos.
- Enviar mensajes transaccionales sobre compras, renovaciones y problemas de facturación.
- Iniciar un Journey en el momento en que un usuario inicia una prueba, cancela o tiene un problema de facturación.
Requisitos \
- Una cuenta de RevenueCat con el Purchases SDK en tu aplicación.
- Una aplicación de OneSignal con el SDK de OneSignal instalado.
- Para recibir Custom Events, un plan de pago de OneSignal. Los Custom Events no están disponibles en el plan gratuito. Las etiquetas funcionan en todos los planes.
Configuración \
Pasar el OneSignal ID a RevenueCat \
RevenueCat usa el OneSignal ID para encontrar al usuario en OneSignal. RevenueCat solo actualiza a los usuarios que tienen un OneSignal ID guardado en RevenueCat.Establecer el External ID en OneSignal
login del SDK.Obtener el OneSignal ID
- Observadores de estado del usuario:
- Métodos getter:
Pasar el OneSignal ID a RevenueCat
$onesignalUserId. Usa el método auxiliar de RevenueCat setOnesignalUserID() o establece el atributo directamente.Si tu aplicación ya usa OneSignal, envía también el OneSignal ID de los usuarios existentes cuando actualicen a la nueva versión de la aplicación. Consulta los ejemplos de código de RevenueCat.$onesignalId (el Player ID) y el método auxiliar setOnesignalID().Conectar OneSignal a RevenueCat \
Abrir la integración de OneSignal
Agregar tus aplicaciones de OneSignal
- Production: las compras de producción van a esta aplicación.
- Sandbox: las compras sandbox van a esta aplicación. Puede ser la misma aplicación que Production o una aplicación separada, como la que usan tus compilaciones de desarrollo.
Elegir si enviar Custom Events
Establecer los nombres de las etiquetas
Probar la integración \
Realizar una compra sandbox
Comprobar el OneSignal ID en RevenueCat
$onesignalUserId aparece en los atributos del usuario.Comprobar que el evento se entregó
Comprobar el usuario en OneSignal
INITIAL_PURCHASE.Eventos que envía RevenueCat \
RevenueCat envía los siguientes eventos. El nombre del evento es el valor de la etiquetalast_event_type y el nombre del Custom Event.
Etiquetas que envía RevenueCat \
Con cada evento, RevenueCat agrega o actualiza estas etiquetas en el usuario. Al crear la integración, un nombre de etiqueta vacío usa el nombre predeterminado. Para dejar de enviar una etiqueta, borra su nombre en el panel de RevenueCat después de crear la integración. Si todos los nombres de etiqueta están vacíos, RevenueCat no envía nada a OneSignal.active_subscription no tiene un nombre predeterminado. RevenueCat la envía solo después de que ingreses un nombre de etiqueta para ella en el panel de RevenueCat.Etiqueta subscription_status \
Cuando un evento cambia el estado de suscripción del usuario, RevenueCat actualiza subscription_status a uno de estos valores. Por ejemplo, el ejemplo de NON_RENEWING_PURCHASE que aparece a continuación no la incluye.
subscription_status refleja solo la suscripción con el evento más reciente.
Ejemplos de etiquetas \
Estos ejemplos muestran la actualización de etiquetas que RevenueCat envía a OneSignal para cada evento.- INITIAL_PURCHASE
- TRIAL_STARTED
- TRIAL_CONVERTED
- TRIAL_CANCELLED
- RENEWAL
- CANCELLATION
- UNCANCELLATION
- NON_RENEWING_PURCHASE
- SUBSCRIPTION_PAUSED
- EXPIRATION
- BILLING_ISSUE
- PRODUCT_CHANGE
Custom Events que envía RevenueCat \
Con Send as Custom Events activado, RevenueCat envía a OneSignal cada evento de Eventos que envía RevenueCat como un Custom Event, además de actualizar las etiquetas. Está activado de forma predeterminada en las integraciones nuevas. Las integraciones configuradas antes de que existiera la opción lo tienen desactivado hasta que lo actives. Cada Custom Event:- Recibe el nombre del evento, como
TRIAL_STARTEDoRENEWAL. - Va al mismo usuario y aplicación de OneSignal que la actualización de etiquetas.
- Usa la hora del evento como marca de tiempo, como la hora de compra o de caducidad.
- Incluye los datos de la suscripción como propiedades del evento, con los nombres de etiqueta que configuraste.
app_user_id, last_event_type, last_event_at y cualquier etiqueta con el nombre vacío. Si todos los nombres de etiqueta están vacíos, RevenueCat no envía ni la actualización de etiquetas ni el Custom Event.
- Iniciar un Journey cuando un usuario activa
TRIAL_STARTEDoBILLING_ISSUE. - Esperar en un Journey hasta que un usuario active
TRIAL_CONVERTEDy, si no lo hace, enviar un mensaje alternativo. - Personalizar los mensajes del Journey con propiedades del evento, como
{{ journey.first_event.properties.product_id }}cuando el evento hizo entrar al usuario en el Journey. Los nombres de las propiedades coinciden con los nombres de etiqueta que configuraste en RevenueCat. - Segmentar usuarios según los eventos de compra que activaron.
- Acceso a flujos de eventos para eventos de mensajes salientes (Se aplican limitaciones del plan y sobrecargos)
- Acceso a eventos personalizados para sincronización de eventos entrantes (Se aplican limitaciones del plan y sobrecargos)
- Plan de cuenta actualizado (no disponible en aplicaciones gratuitas)
Custom Events
Preguntas frecuentes \
¿Cómo sé si la integración funciona? \
Busca el OneSignal ID del usuario en Audience > Users & subscriptions y comprueba las etiquetas que estableció RevenueCat. En RevenueCat, el Customer History muestra si cada evento de la integración de OneSignal se entregó. Para comprobar los Custom Events, ve a Data > Events & conversions.¿Por qué los eventos de RevenueCat no llegan a OneSignal? \
La causa más común es un OneSignal ID ausente o desactualizado en RevenueCat. Confirma que$onesignalUserId está establecido en el usuario en RevenueCat y que llamas a login antes de enviarlo. Comprueba también que la compra fue a la aplicación correcta: las compras sandbox, incluidas las de TestFlight y los testers de licencias de Google Play, van a la aplicación de la sección Sandbox.