Integración con RevenueCat

Se necesita la ayuda de un desarrollador

Necesitará la ayuda de su equipo de desarrollo para configurar la integración. Por favor, comparta esta guía con ellos.

RevenueCat es una plataforma de gestión de suscripciones que simplifica las compras y suscripciones dentro de la aplicación para empresas en las plataformas iOS, Android y web. Proporciona herramientas completas para crear, analizar y mejorar las suscripciones dentro de la aplicación.

Al integrar Pushwoosh con RevenueCat, las empresas pueden enviar notificaciones push dirigidas, mensajes in-app y otros mensajes a los usuarios basados en los eventos de suscripción enviados por RevenueCat a Pushwoosh. Esto puede animar a los usuarios a renovar suscripciones, actualizar a niveles superiores o aprovechar ofertas especiales, mejorando el compromiso, maximizando los ingresos y simplificando la gestión de suscripciones.

Casos de uso

Comunicación personalizada

Las empresas pueden utilizar la integración para personalizar la comunicación con los clientes. Por ejemplo, una plataforma de e-learning puede aumentar el compromiso del usuario enviando notificaciones push personalizadas cuando detecta un cambio en el plan de suscripción. Estas notificaciones ofrecen orientación para la transición, recomiendan cursos relevantes basados en el nuevo plan y proporcionan beneficios exclusivos alineados con la actualización.

Notificaciones de problemas de facturación

Cuando la suscripción de un usuario se enfrenta a un problema de facturación, las empresas pueden utilizar la integración de RevenueCat con Pushwoosh para enviar rápidamente notificaciones dirigidas. Por ejemplo, un servicio de streaming puede notificar al usuario sobre el problema de facturación y proporcionar instrucciones para resolverlo, como actualizar la información de pago.

Notificaciones de compras no renovables

Las empresas pueden aprovechar la integración de RevenueCat con Pushwoosh para convertir las compras únicas en relaciones duraderas con los clientes. Por ejemplo, un servicio de entrega de comidas puede enviar una notificación push post-compra agradeciendo al cliente y recomendando productos relevantes o promocionando un plan de suscripción para una mayor comodidad. Esto fomentará la lealtad del cliente, impulsará las oportunidades de venta adicional y potencialmente convertirá a los compradores únicos en suscriptores.

Promociones de actualización de nivel

Las aplicaciones con múltiples niveles de suscripción pueden utilizar la integración para supervisar las suscripciones de los usuarios y enviar mensajes de actualización personalizados. Por ejemplo, una aplicación de juegos podría utilizar notificaciones push para subrayar los beneficios de los niveles premium, como contenido exclusivo o descuentos, animando a los usuarios a elevar sus suscripciones.

Eventos

Cada webhook que envía RevenueCat se convierte en un evento de Pushwoosh llamado RC_ más el tipo de evento de RevenueCat, por ejemplo, RC_INITIAL_PURCHASE, RC_RENEWAL, RC_CANCELLATION, RC_BILLING_ISSUE o RC_EXPIRATION. Pushwoosh crea el evento la primera vez que llega un webhook de ese tipo, por lo que los nuevos tipos de eventos de RevenueCat aparecen en su aplicación por sí solos. Consulte Tipos de eventos en la documentación de RevenueCat para ver la lista completa.

Cada evento incluye los campos del webhook de RevenueCat como atributos del evento, por ejemplo, price, price_in_purchased_currency, currency, product_id, store, period_type, environment, country_code y entitlement_ids:

• Los campos que contienen una hora en milisegundos se convierten en fechas sin el sufijo _ms, por ejemplo, purchased_at y expiration_at. La fecha en que se envió el webhook es el atributo timestamp.
• Estas fechas están en UTC y tienen el formato YYYY-MM-DD, sin la hora del día.
• Los atributos de cliente que establece en RevenueCat también se convierten en atributos del evento. Los atributos que identifican a una persona o un dispositivo, como el correo electrónico, el número de teléfono, el nombre visible, la dirección IP, los identificadores publicitarios y los tokens push, no se transmiten a Pushwoosh.
• Un evento conserva hasta 100 atributos.

Las compras de App Store, Google Play, Mac App Store y Amazon se registran en las plataformas iOS, Android, macOS y Amazon. Las compras de otras tiendas, como Stripe, RevenueCat Billing o concesiones promocionales, se registran sin plataforma.

Puede utilizar estos eventos en sus customer journeys. Los eventos con el atributo price se pueden utilizar con la segmentación RFM.

Consejo

También puede realizar el seguimiento de ingresos de eventos como RC_INITIAL_PURCHASE, RC_RENEWAL o RC_NON_RENEWING_PURCHASE (utilizando sus atributos price y currency) como eventos de conversión. Evite realizar el seguimiento de ingresos de RC_CANCELLATION o RC_EXPIRATION. Los eventos de conversión no admiten reembolsos ni reversiones, por lo que seguirían contándose como ingresos.

Configuración de la integración

La integración funciona a través de los webhooks de RevenueCat, que están disponibles en el plan Pro de RevenueCat.

Vincular los clientes de RevenueCat con los usuarios de Pushwoosh

Pushwoosh registra un webhook para el usuario de Pushwoosh que este indica y omite un webhook que no indica ningún usuario. Elija cómo RevenueCat indica el usuario:

• Si su aplicación identifica a los usuarios con su propio ID y lo pasa a RevenueCat como App User ID, utilice el App User ID como User ID de Pushwoosh.
• Si el App User ID difiere del User ID de Pushwoosh, por ejemplo, cuando RevenueCat utiliza identificadores anónimos como $RCAnonymousID:…, envíe los ID de Pushwoosh como atributos de RevenueCat. Sin ellos, los eventos van a un User ID que Pushwoosh no tiene.

Utilizar el App User ID de RevenueCat como User ID de Pushwoosh

Establezca el App User ID que pasa a RevenueCat como User ID de Pushwoosh (setUserId).

Android

Java

Pushwoosh.getInstance().setUserId(appUserID);

iOS

Swift

Pushwoosh.configure.setUserId(appUserID)

Enviar los ID de Pushwoosh como atributos de RevenueCat

Establezca los atributos pushwooshUserId y pushwooshHwid en RevenueCat. Pushwoosh los utiliza en lugar del App User ID:

• pushwooshUserId: el User ID de Pushwoosh del cliente.
• pushwooshHwid: el ID de hardware (HWID) de Pushwoosh del dispositivo del cliente. Es opcional. Sin él, Pushwoosh utiliza el User ID como HWID.

Android

Kotlin

Purchases.sharedInstance.setAttributes(mapOf(
    "pushwooshUserId" to pushwooshUserId,
    "pushwooshHwid" to Pushwoosh.getInstance().hwid
))

iOS

Swift

Purchases.shared.attribution.setAttributes([
    "pushwooshUserId": pushwooshUserId,
    "pushwooshHwid": Pushwoosh.configure.getHWID()
])

Enviar webhooks de RevenueCat a Pushwoosh

En su panel de control de RevenueCat:

1. Abra su proyecto, busque la tarjeta Integraciones en el menú de la izquierda y haga clic en + Nuevo.

2. Elija Webhooks.

3. Si RevenueCat muestra la lista de sus webhooks, haga clic en Añadir nueva configuración.
4. Dé a la integración un nombre sencillo, como Pushwoosh, para una fácil identificación.
5. Introduzca la siguiente URL como URL del webhook:

https://integration-revenuecat.svc-nue.pushwoosh.com/integration-revenuecat/v1/post-event?pwapp=APP_CODE

En la URL, reemplace APP_CODE con su código de aplicación de Pushwoosh existente, que se encuentra debajo del nombre de su aplicación en su cuenta de Pushwoosh.

6. En el campo Valor de la cabecera de autorización, inserte su token de la API de Pushwoosh. Puede encontrar este token en Ajustes > Acceso a la API en Pushwoosh.

7. Decida si desea transmitir eventos para compras de producción (en vivo), compras de sandbox (de prueba), o ambas.
8. En el desplegable App, especifique si los eventos de webhook deben ser enviados para una sola aplicación o para todas las aplicaciones dentro del proyecto.
9. En el desplegable Tipo de evento, seleccione si desea enviar todos los eventos o especifique qué eventos enviar a Pushwoosh.

10. Elija mostrar todos los eventos, solo los eventos exitosos o solo los eventos fallidos.

Para comprobar la conexión, envíe un webhook de prueba desde RevenueCat. Una entrega correcta significa que Pushwoosh aceptó la URL y el token de la API. El webhook de prueba en sí no se registra como evento: cada evento RC_ aparece en Audiencia → Eventos en su aplicación de Pushwoosh cuando llega el primer webhook real de ese tipo.