Saltar al contenido principal
Envía datos de suscripciones y compras de RevenueCat a OneSignal para enviar mensajes a los usuarios según la etapa de su suscripción en la que se encuentren. RevenueCat actualiza las etiquetas de cada usuario con su estado de suscripción más reciente. También puede enviar cada evento de compra a OneSignal como un Custom Event. Con la integración de RevenueCat, puedes:
  • 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 \

Debes estar familiarizado con las etiquetas, los usuarios y las suscripciones.

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.
Establece el External ID en OneSignal antes de enviar el OneSignal ID a RevenueCat. Llamar a login puede cambiar el OneSignal ID. Si RevenueCat tiene el ID anterior, sus actualizaciones no llegan al usuario.
1

Establecer el External ID en OneSignal

Establece el External ID como tu ID de usuario principal con el método login del SDK.
2

Obtener el OneSignal ID

Usa el observador de estado del usuario para obtener el OneSignal ID cada vez que cambie. También hay métodos getter disponibles.En el observador, comprueba que el External ID coincida con el usuario que esperas antes de pasar el OneSignal ID. Las solicitudes en caché, por ejemplo de un dispositivo que estaba sin conexión, pueden informar de un usuario diferente.
3

Pasar el OneSignal ID a RevenueCat

Guarda el OneSignal ID en RevenueCat como el atributo de suscriptor $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.
En el SDK de OneSignal v4 y anteriores, RevenueCat usa en su lugar el atributo $onesignalId (el Player ID) y el método auxiliar setOnesignalID().

Conectar OneSignal a RevenueCat \

1

Abrir la integración de OneSignal

En el panel de RevenueCat, abre la configuración de tu proyecto y elige OneSignal en el menú Integrations.
2

Agregar tus aplicaciones de OneSignal

Ingresa el App ID y la App API key de la aplicación de OneSignal para cada tipo de compra. Consulta Claves e IDs para encontrarlos.
  • 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.
Si dejas vacíos ambos campos de una sección, RevenueCat no envía eventos para ese tipo de compra.
3

Elegir si enviar Custom Events

Activa Send as Custom Events para enviar cada evento también como un Custom Event, además de actualizar las etiquetas. Está activado de forma predeterminada en las integraciones nuevas. Desactívalo si tu aplicación de OneSignal está en el plan gratuito.
4

Establecer los nombres de las etiquetas

Ingresa los nombres de etiqueta que RevenueCat debe usar o conserva los predeterminados. Consulta Etiquetas que envía RevenueCat.
RevenueCat elige la aplicación de OneSignal según el entorno de la compra, no según tu tipo de compilación. Las compras de TestFlight, de los testers de licencias de Google Play y de otras cuentas de prueba son compras sandbox, incluso en una compilación de lanzamiento. Asegúrate de que esos usuarios existan en tu aplicación Sandbox o la actualización fallará.
Las integraciones creadas antes de que existiera la sección Sandbox muestran la misma aplicación en Production y en Sandbox. Siguen enviando las compras sandbox al mismo lugar que antes. Para enviar las compras sandbox a otra aplicación, cambia la sección Sandbox.

Probar la integración \

1

Realizar una compra sandbox

Instala tu aplicación como un usuario nuevo y completa una compra sandbox. El evento va a la aplicación de OneSignal de la sección Sandbox, así que configúrala primero.
2

Comprobar el OneSignal ID en RevenueCat

En RevenueCat, abre la Customer View del usuario de prueba. Confirma que $onesignalUserId aparece en los atributos del usuario.
3

Comprobar que el evento se entregó

En la Customer View, abre la compra de prueba en el Customer History. Confirma que el evento de la integración de OneSignal existe y se entregó.
4

Comprobar el usuario en OneSignal

En la aplicación Sandbox de OneSignal, ve a Audience > Users & subscriptions y busca el OneSignal ID. Confirma que el usuario tiene las etiquetas que estableció RevenueCat. Si Send as Custom Events está activado, ve a Data > Events & conversions y confirma que llegó el evento, como INITIAL_PURCHASE.
Las etiquetas en OneSignal ahora se actualizan automáticamente cuando los usuarios compran, renuevan o cambian su suscripción.
Prueba con un usuario nuevo y con un usuario existente que actualice a la nueva versión de tu aplicación.

Eventos que envía RevenueCat \

RevenueCat envía los siguientes eventos. El nombre del evento es el valor de la etiqueta last_event_type y el nombre del Custom Event. No todas las tiendas informan de todos los eventos. Consulta la tabla de Events de RevenueCat para ver la compatibilidad por tienda.
No retires el acceso en SUBSCRIPTION_PAUSED. Retira el acceso solo en EXPIRATION.

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. Para los clientes con más de una suscripción activa, 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.

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_STARTED o RENEWAL.
  • 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.
Las propiedades del evento omiten 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.
Usa los Custom Events de RevenueCat para:
  • Iniciar un Journey cuando un usuario activa TRIAL_STARTED o BILLING_ISSUE.
  • Esperar en un Journey hasta que un usuario active TRIAL_CONVERTED y, 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.
Los Custom Events requieren:

Custom Events

Activa Journeys, personaliza mensajes y segmenta usuarios con 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.

¿Por qué mis compras sandbox actualizan la aplicación equivocada? \

RevenueCat envía las compras sandbox a la aplicación de la sección Sandbox y las compras de producción a la aplicación de la sección Production. Actualiza la sección Sandbox en el panel de RevenueCat para cambiar adónde van las compras sandbox.

¿Puedo usar los Custom Events de RevenueCat en el plan gratuito? \

No. Los Custom Events requieren un plan de pago de OneSignal. En el plan gratuito, desactiva Send as Custom Events en RevenueCat. Las actualizaciones de etiquetas siguen funcionando.

¿RevenueCat envía importes de ingresos a OneSignal? \

No. RevenueCat no envía precios ni ingresos a OneSignal. Envía datos de suscripción, como el producto, la tienda, el estado y las fechas.

¿Cuántas etiquetas puedo establecer? \

OneSignal limita cuántas etiquetas puede tener cada usuario a la vez. El límite depende de tu plan. Consulta Precios. Para enviar menos etiquetas, borra en el panel de RevenueCat los nombres de las etiquetas que no necesites.

Custom Events

Activa Journeys, personaliza mensajes y segmenta usuarios con eventos.

Etiquetas

Almacena propiedades de usuario y úsalas para segmentar y personalizar.

Configuración de Journeys

Haz que los usuarios entren en Journeys cuando activan un Custom Event.

Claves e IDs

Encuentra tu App ID y App API key de OneSignal.