OneSignal
OneSignal es una plataforma líder de engagement con clientes que ofrece notificaciones push, correo electrónico, SMS y mensajería in-app. Integrar Adapty con OneSignal te permite acceder a todos tus eventos de suscripción en un solo lugar, lo que te permite activar comunicaciones automatizadas basadas en esos eventos. Con Adapty, puedes rastrear eventos de suscripción en múltiples stores, analizar el comportamiento de los usuarios y utilizar esos datos para una comunicación más personalizada. Esta integración te permite monitorear eventos de suscripción en tu dashboard de OneSignal y asociarlos con tus campañas de adquisición.
Adapty actualiza las etiquetas de OneSignal en función de los eventos de suscripción, lo que te permite enviar notificaciones push personalizadas con una configuración mínima.
Características de la integración
| Característica de integración | Descripción |
|---|---|
| Frecuencia | Actualizaciones en tiempo real |
| Dirección de datos | Unidireccional: de Adapty al servidor de OneSignal |
| Punto de integración de Adapty |
|
Configurar la integración con One Signal
Para configurar la integración:
-
Abre Integrations → OneSignal en tu Adapty Dashboard.
-
Activa el interruptor de la integración.
-
Introduce tu OneSignal App ID. Para configurar la integración con OneSignal, ve a Integrations -> OneSignal en tu Adapty Dashboard, activa el interruptor y configura las credenciales de la integración.
Obtén tu OneSignal App ID
Encuentra tu OneSignal App ID en tu OneSignal Dashboard:
-
Ve a Settings → Keys & IDs.
-
Copia tu OneSignal App ID y pégalo en el campo App ID del Adapty Dashboard.
Puedes encontrar más información sobre el OneSignal ID en la siguiente documentación.
Configuración de eventos
Adapty te permite enviar tres grupos de eventos a OneSignal. Activa los que necesites en el Adapty Dashboard. Puedes consultar la lista completa de eventos disponibles con su descripción detallada aquí.
Adapty envía eventos de suscripción a OneSignal mediante una integración servidor a servidor, lo que te permite rastrear toda la actividad relacionada con suscripciones en OneSignal.
A partir del 17 de abril de 2023, el plan gratuito de OneSignal ya no admite esta integración. Solo está disponible en los planes Growth, Professional y superiores. Para más información, consulta Precios de OneSignal.
Etiquetas personalizadas
Esta integración actualiza y asigna diversas propiedades a tus usuarios de Adapty como etiquetas, que luego se envían a OneSignal. Consulta la lista de etiquetas a continuación para encontrar las que mejor se adapten a tus necesidades.
OneSignal tiene un límite de etiquetas. Esto incluye tanto las etiquetas generadas por Adapty como cualquier etiqueta existente en OneSignal. Superar el límite puede causar errores al enviar eventos.
| Etiqueta | Tipo | Descripción |
|---|---|---|
adapty_customer_user_id | String | El identificador único del usuario en tu app. Debe ser coherente en tu sistema, Adapty y OneSignal. |
adapty_profile_id | String | El ID del perfil de usuario de Adapty, disponible en tu Adapty Dashboard. |
environment | String | Sandbox o Production, indica el entorno actual del usuario. |
store | String | Store donde se compró el producto. Opciones: app_store, play_store, stripe o el nombre de tu store personalizada. |
vendor_product_id | String | El ID del producto en el store (p. ej., org.locals.12345). |
subscription_expires_at | String | Fecha de expiración de la última suscripción (YYYY-MM-DDTHH:MM:SS+0000, p. ej., 2023-02-10T17:22:03.000000+0000). |
last_event_type | String | El tipo de evento más reciente de la lista de eventos de Adapty. Ten en cuenta lo siguiente: - Para el evento Subscription expired, Adapty envía la propiedad last_event_type como subscription_cancelled.- Para Trial renew canceled – como auto_renew_off- Para Subscription renew canceled – como auto_renew_off_subscription |
purchase_date | String | Fecha de la última transacción (YYYY-MM-DDTHH:MM:SS+0000, p. ej., 2023-02-10T17:22:03.000000+0000). |
active_subscription | String | true si el usuario tiene una suscripción activa y false si la suscripción ha expirado. |
period_type | String | Indica el tipo de período más reciente para la compra o renovación. Valores posibles: trial para un período de prueba o normal para el resto de casos. |
| Todos los valores float se redondean a enteros. Los strings no cambian. |
Además de las etiquetas predefinidas, puedes enviar atributos personalizados como etiquetas, lo que da mayor flexibilidad en los datos que incluyes. Esto es útil para rastrear detalles específicos relacionados con tu producto o servicio. Los atributos de usuario personalizados se envían automáticamente a OneSignal si la casilla Send user attributes está marcada en la página de integración. Si está desmarcada, Adapty envía exactamente 10 etiquetas. Si está marcada, se pueden enviar más de 10 etiquetas, lo que permite una captura de datos más completa.
Configuración del SDK
Hay dos formas de integrar OneSignal con Adapty:
- Legacy (anterior a v5): Usa
playerId(obsoleto en OneSignal SDK v5). - Actual (v5+): Usa
subscriptionId.
Asegúrate de enviar playerId (para OneSignal SDK anterior a v5) o subscriptionId (para OneSignal SDK v5+) a Adapty. Sin esto, las etiquetas de OneSignal no se actualizarán y la integración no funcionará correctamente.
Lee más en la documentación de OneSignal:
Gestión de múltiples dispositivos
Si un usuario tiene varios dispositivos, rastrear los eventos de compra y las suscripciones puede resultar complicado. OneSignal ofrece una forma de gestionar esto mediante IDs de usuario externas.
Para mantener la coherencia de los datos del usuario entre dispositivos:
- Relaciona los distintos dispositivos en tu servidor y envía esos datos a OneSignal.
- Usa el customer_user_id de Adapty como externalUserId en OneSignal. Si tu app no tiene un sistema de registro, considera usar otro identificador único que se mantenga consistente en todos los dispositivos del usuario. Es importante mantener la coherencia en el identificador de usuario en todos los dispositivos y actualizar OneSignal siempre que cambie el ID de un usuario. Esto simplifica el seguimiento de la actividad y las suscripciones de los usuarios, garantiza una mensajería coherente y permite un análisis más preciso y una mejor experiencia de usuario. Para más detalles, consulta la documentación de ID de usuario externo de OneSignal.