Intégration RevenueCat

Assistance d'un développeur requise

Vous aurez besoin de l’aide de votre équipe de développement pour configurer l’intégration. Veuillez leur partager ce guide.

RevenueCat est une plateforme de gestion d’abonnements qui simplifie les achats et les abonnements in-app pour les entreprises sur les plateformes iOS, Android et web. Elle fournit des outils complets pour créer, analyser et améliorer les abonnements in-app.

En intégrant Pushwoosh à RevenueCat, les entreprises peuvent envoyer des notifications push ciblées, des messages in-app et d’autres messages aux utilisateurs en fonction des événements d’abonnement envoyés par RevenueCat à Pushwoosh. Cela peut encourager les utilisateurs à renouveler leurs abonnements, à passer à des niveaux supérieurs ou à profiter d’offres spéciales, améliorant ainsi l’engagement, maximisant les revenus et simplifiant la gestion des abonnements.

Cas d’utilisation

Communication personnalisée

Les entreprises peuvent utiliser l’intégration pour personnaliser la communication avec les clients. Par exemple, une plateforme d’e-learning peut stimuler l’engagement des utilisateurs en envoyant des notifications push personnalisées lorsqu’un changement de plan d’abonnement est détecté. Ces notifications offrent des conseils de transition, recommandent des cours pertinents en fonction du nouveau plan et fournissent des avantages exclusifs alignés sur la mise à jour.

Notifications de problèmes de facturation

Lorsqu’un problème de facturation survient pour l’abonnement d’un utilisateur, les entreprises peuvent utiliser l’intégration RevenueCat avec Pushwoosh pour envoyer rapidement des notifications ciblées. Par exemple, un service de streaming peut informer l’utilisateur du problème de facturation et fournir des instructions pour le résoudre, comme la mise à jour des informations de paiement.

Notifications d’achat non renouvelable

Les entreprises peuvent tirer parti de l’intégration RevenueCat avec Pushwoosh pour transformer les achats uniques en relations clients durables. Par exemple, un service de livraison de repas peut envoyer une notification push post-achat pour remercier le client et recommander des produits pertinents ou promouvoir un plan d’abonnement pour une commodité continue. Cela favorisera la fidélité des clients, générera des opportunités de vente incitative et convertira potentiellement les acheteurs uniques en abonnés.

Promotions de mise à niveau de niveau

Les applications avec plusieurs niveaux d’abonnement peuvent utiliser l’intégration pour surveiller les abonnements des utilisateurs et envoyer des incitations de mise à niveau sur mesure. Par exemple, une application de jeu pourrait utiliser des notifications push pour souligner les avantages des niveaux premium, comme du contenu exclusif ou des réductions, encourageant les utilisateurs à élever leurs abonnements.

Événements

Chaque webhook envoyé par RevenueCat devient un événement Pushwoosh nommé RC_ suivi du type d’événement RevenueCat, par exemple RC_INITIAL_PURCHASE, RC_RENEWAL, RC_CANCELLATION, RC_BILLING_ISSUE ou RC_EXPIRATION. Pushwoosh crée l’événement la première fois qu’un webhook de ce type arrive : les nouveaux types d’événements RevenueCat apparaissent donc d’eux-mêmes dans votre application. Consultez Types d’événements dans la documentation RevenueCat pour la liste complète.

Chaque événement transporte les champs du webhook RevenueCat sous forme d’attributs d’événement, par exemple price, price_in_purchased_currency, currency, product_id, store, period_type, environment, country_code et entitlement_ids :

• Les champs contenant une heure en millisecondes deviennent des dates sans le suffixe _ms, par exemple purchased_at et expiration_at. La date d’envoi du webhook correspond à l’attribut timestamp.
• Ces dates sont en UTC et au format YYYY-MM-DD, sans l’heure de la journée.
• Les attributs client que vous définissez dans RevenueCat deviennent également des attributs d’événement. Les attributs qui identifient une personne ou un appareil, tels que l’e-mail, le numéro de téléphone, le nom d’affichage, l’adresse IP, les identifiants publicitaires et les jetons push, ne sont pas transmis à Pushwoosh.
• Un événement conserve jusqu’à 100 attributs.

Les achats provenant de l’App Store, de Google Play, du Mac App Store et d’Amazon sont enregistrés sur les plateformes iOS, Android, macOS et Amazon. Les achats provenant d’autres stores, tels que Stripe, RevenueCat Billing ou les octrois promotionnels, sont enregistrés sans plateforme.

Vous pouvez utiliser ces événements dans vos parcours client. Les événements avec l’attribut price peuvent être utilisés avec la segmentation RFM.

Conseil

Vous pouvez également suivre les revenus d’événements comme RC_INITIAL_PURCHASE, RC_RENEWAL ou RC_NON_RENEWING_PURCHASE (en utilisant leurs attributs price et currency) en tant qu’événements de conversion. Évitez de suivre les revenus de RC_CANCELLATION ou RC_EXPIRATION. Les événements de conversion ne prennent pas en charge les remboursements ni les annulations, ils resteraient donc comptabilisés comme des revenus.

Configuration de l’intégration

L’intégration fonctionne via les webhooks RevenueCat, disponibles avec le forfait Pro de RevenueCat.

Faire correspondre les clients RevenueCat aux utilisateurs Pushwoosh

Pushwoosh enregistre un webhook pour l’utilisateur Pushwoosh qu’il désigne et ignore un webhook qui ne désigne aucun utilisateur. Choisissez la façon dont RevenueCat désigne l’utilisateur :

• Si votre application identifie les utilisateurs avec son propre ID et le transmet à RevenueCat en tant qu’App User ID, utilisez l’App User ID comme User ID Pushwoosh.
• Si l’App User ID diffère du User ID Pushwoosh, par exemple lorsque RevenueCat utilise des ID anonymes comme $RCAnonymousID:…, envoyez les ID Pushwoosh en tant qu’attributs RevenueCat. Sans eux, les événements sont attribués à un User ID que Pushwoosh ne connaît pas.

Utiliser l’App User ID RevenueCat comme User ID Pushwoosh

Définissez l’App User ID que vous transmettez à RevenueCat comme User ID Pushwoosh (setUserId).

Android

Java

Pushwoosh.getInstance().setUserId(appUserID);

iOS

Swift

Pushwoosh.configure.setUserId(appUserID)

Envoyer les ID Pushwoosh en tant qu’attributs RevenueCat

Définissez les attributs pushwooshUserId et pushwooshHwid dans RevenueCat. Pushwoosh les utilise à la place de l’App User ID :

• pushwooshUserId : le User ID Pushwoosh du client.
• pushwooshHwid : l’identifiant matériel Pushwoosh (HWID) de l’appareil du client. Il est facultatif. Sans lui, Pushwoosh utilise le User ID comme 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()
])

Envoyer les webhooks RevenueCat à Pushwoosh

Dans votre tableau de bord RevenueCat :

1. Ouvrez votre projet, trouvez la carte Integrations dans le menu de gauche et cliquez sur + New.

2. Choisissez Webhooks.

3. Si RevenueCat affiche la liste de vos webhooks, cliquez sur Add new configuration.
4. Donnez à l’intégration un nom simple, tel que Pushwoosh, pour une identification facile.
5. Saisissez l’URL suivante comme URL du webhook :

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

Dans l’URL, remplacez APP_CODE par votre code d’application Pushwoosh existant qui se trouve sous le nom de votre application dans votre compte Pushwoosh.

6. Dans le champ Authorization header value, insérez votre jeton API Pushwoosh. Vous pouvez trouver ce jeton sous Settings > API Access dans Pushwoosh.

7. Décidez si vous souhaitez transmettre les événements pour les achats de production (en direct), les achats de bac à sable (test), ou les deux.
8. Dans le menu déroulant App, spécifiez si les événements de webhook doivent être envoyés pour une seule application ou pour toutes les applications du projet.
9. Dans le menu déroulant Event Type, sélectionnez si vous souhaitez envoyer tous les événements ou spécifiez quels événements envoyer à Pushwoosh.

10. Choisissez d’afficher tous les événements, uniquement les événements réussis, ou uniquement les événements échoués.

Pour vérifier la connexion, envoyez un webhook de test depuis RevenueCat. Une livraison réussie signifie que Pushwoosh a accepté l’URL et le jeton API. Le webhook de test lui-même n’est pas enregistré comme événement : chaque événement RC_ apparaît sous Audience → Événements dans votre application Pushwoosh dès que le premier webhook réel de ce type arrive.