RevenueCat

Aperçu

RevenueCat vous aide à suivre les achats intégrés et les cycles de vie des abonnements sur toutes les plateformes. Avec OneSignal, vous pouvez utiliser ces données pour envoyer des messages personnalisés en fonction du statut d’abonnement d’un utilisateur. Cette intégration met à jour automatiquement les tags utilisateur dans OneSignal avec leurs dernières informations d’abonnement.

Principaux avantages

Avec l’intégration RevenueCat–OneSignal, vous pouvez :

Envoyer des messages d’accueil aux utilisateurs en période d’essai gratuite ou qui viennent de s’abonner.
Réengager les utilisateurs désabonnés avec des sondages ou des réductions.
Envoyer des messages transactionnels pour les achats, les problèmes de facturation ou les renouvellements.

Avec des données d’abonnement précises dans OneSignal, vos campagnes seront plus intelligentes et plus efficaces.

Prérequis

Compte RevenueCat
- RevenueCat Purchases SDK
- Comprendre l’intégration RevenueCat-OneSignal
Compte OneSignal avec SDK intégré
- Comprendre les Tags, les Utilisateurs et les Abonnements OneSignal

Configuration

Connecter OneSignal à RevenueCat

Dans votre tableau de bord RevenueCat, accédez aux paramètres de votre projet et choisissez ‘OneSignal’ dans le menu Intégrations.
Ajoutez votre identifiant d’application OneSignal et votre clé API OneSignal. Consultez Clés et identifiants pour plus d’informations.
Saisissez les noms de tags que RevenueCat doit utiliser, ou choisissez les noms de tags par défaut.

Transmettre l’identifiant OneSignal à RevenueCat

RevenueCat utilise l’identifiant utilisateur OneSignal (OneSignal ID) pour mettre à jour les tags utilisateur dans OneSignal en fonction des détails utilisateur RevenueCat.

La définition de l’identifiant externe dans OneSignal est requise pour un identifiant stable. S’il change en cours de session, l’identifiant OneSignal peut également changer, rompant ainsi la connexion RevenueCat.

Pour transmettre l’identifiant OneSignal à RevenueCat, vous devez :

Définir l'identifiant externe dans OneSignal

Définissez l’identifiant externe dans OneSignal avec votre identifiant utilisateur principal. Cela peut être effectué avec la méthode login du SDK.

Obtenir l'identifiant OneSignal

Nous recommandons d’utiliser la méthode d’observateur d’état utilisateur pour obtenir l’identifiant OneSignal, mais nous fournissons également des méthodes getter :

Observateurs d’état utilisateur :
- État utilisateur addObserver du SDK Mobile
- État utilisateur addObserver du SDK Web
Méthodes getter :
- Méthode getOneSignalId du SDK Mobile
- Propriété OneSignalId du SDK Web

Transmettre l'identifiant OneSignal à RevenueCat

Transmettez l’identifiant OneSignal à RevenueCat.

Propriété RevenueCat : $onesignalUserId
Méthode d’assistance RevenueCat : setOneSignalUserID() (recommandée)

Envoyer les événements RevenueCat vers OneSignal

Les utilisateurs ayant un identifiant OneSignal mappé avec RevenueCat verront leurs tags mis à jour automatiquement.

Tester l’intégration

Effectuer un achat sandbox

Simulez un nouvel utilisateur installant votre application et parcourez le flux de votre application pour effectuer un achat sandbox.

Assurez-vous que l’identifiant OneSignal est défini dans RevenueCat.

Vérifier que les données d'appareil requises sont collectées

Dans RevenueCat, accédez à la vue client pour l’utilisateur de test qui vient d’effectuer un achat. Assurez-vous que toutes les données requises sont listées comme attributs pour l’utilisateur.

Vérifier que l'événement OneSignal a été livré avec succès

Toujours dans la vue client, cliquez sur l’événement d’achat de test dans l’historique client et assurez-vous que l’événement d’intégration OneSignal existe et a été livré avec succès.

Vérifier que les tags OneSignal sont mis à jour

Dans OneSignal, accédez à Audience > Utilisateurs et recherchez l’identifiant OneSignal. Vous devriez voir les tags qui ont été mis à jour par RevenueCat.

Intégration terminée ! Vous devriez maintenant voir les tags dans OneSignal se mettre à jour automatiquement lorsque les utilisateurs effectuent des achats ou mettent à jour leur statut d’abonnement.

Tags d’événements RevenueCat

Pour chaque événement d’abonnement à renouvellement automatique dans RevenueCat, les tags suivants sont ajoutés ou mis à jour sur l’utilisateur dans OneSignal. En laissant le tag vide dans le tableau de bord RevenueCat, vous pouvez choisir de ne pas envoyer de valeur pour un ou plusieurs tags spécifiques.

Tag	Description
`app_user_id`	L’identifiant utilisateur d’application RevenueCat qui a déclenché l’événement
`period_type`	Le dernier type de période pour l’achat ou le renouvellement. Soit : `TRIAL` (pour les essais gratuits), `INTRO` (ou tarification d’introduction), `NORMAL` (abonnement standard)
`purchased_at`	Temps Unix en secondes du dernier achat ou renouvellement d’abonnement
`expiration_at`	Temps Unix en secondes de la dernière date d’expiration de l’abonnement
`store`	Soit `APP_STORE`, `PLAY_STORE`, ou `STRIPE`
`environment`	Soit `SANDBOX` ou `PRODUCTION`
`last_event_type`	Le dernier type d’événement de l’utilisateur. Soit : `INITIAL_PURCHASE`, `TRIAL_STARTED`, `TRIAL_CONVERTED`, `TRIAL_CANCELLED`, `RENEWAL`, `CANCELLATION`
`product_id`	Le dernier identifiant de produit d’abonnement que l’utilisateur a acheté ou renouvelé
`entitlement_ids`	Chaîne séparée par des virgules d’identifiants d’autorisations RevenueCat que l’utilisateur a débloqués
`active_subscription`	La valeur sera définie sur `true` pour tout événement d’achat/renouvellement, et `false` sur `EXPIRATION`
`subscription_status`	Voir l’attribut Statut d’abonnement ci-dessous
`grace_period_expiration_at`	Si un problème de facturation se produit, nous enverrons la date d’expiration de la période de grâce.

Abonnements à renouvellement automatique uniquement
RevenueCat met à jour les tags de données dans OneSignal uniquement en réponse à des événements d’abonnement à renouvellement automatique.

Exemples d’événements RevenueCat

Les exemples JSON fournis montrent les tags envoyés à OneSignal basés sur les événements RevenueCat. L’événement est enregistré comme tag last_event_type.

{
    "app_id": "12345678-1234-1234-1234-123456789012",
    "tags": {
        "user_id": "$RCAnonymousID:87c6049c58069238dce29853916d624c",
        "period_type": "NORMAL",
        "purchased_at": 1600016247,
        "expiration_at": 1602608247,
        "store": "APP_STORE",
        "environment": "PRODUCTION",
        "last_event_type": "initial_purchase",
        "last_event_at": 1600016250,
        "product_id": "monthly_sub",
        "entitlement_ids": "Pro"
    }
}

{
    "app_id": "12345678-1234-1234-1234-123456789012",
    "tags": {
        "user_id": "$RCAnonymousID:87c6049c58069238dce29853916d624c",
        "period_type": "TRIAL",
        "purchased_at": 1600031584,
        "expiration_at": 1600290784,
        "store": "APP_STORE",
        "environment": "PRODUCTION",
        "last_event_type": "trial_started",
        "last_event_at": 1600031586,
        "product_id": "three_month_sub_trial",
        "entitlement_ids": "Pro"
    }
}

{
    "app_id": "12345678-1234-1234-1234-123456789012",
    "tags": {
        "app_user_id": "$RCAnonymousID:87c6049c58069238dce29853916d624c",
        "period_type": "NORMAL",
        "purchased_at": 1602136340,
        "expiration_at": 1602741140,
        "store": "APP_STORE",
        "environment": "PRODUCTION",
        "last_event_type": "trial_converted",
        "last_event_at": 1602114850,
        "product_id": "weekly_sub_trial",
        "entitlement_ids": null
    }
}

{
    "app_id": "12345678-1234-1234-1234-123456789012",
    "tags": {
        "app_user_id": "$RCAnonymousID:87c6049c58069238dce29853916d624c",
        "period_type": "TRIAL",
        "purchased_at": 1602051920,
        "expiration_at": 1602311120,
        "store": "APP_STORE",
        "environment": "PRODUCTION",
        "last_event_type": "trial_cancelled",
        "last_event_at": 1602129368,
        "product_id": "weekly_sub_trial",
        "entitlement_ids": null
    }
}

{
    "app_id": "12345678-1234-1234-1234-123456789012",
    "tags": {
        "app_user_id": "$RCAnonymousID:87c6049c58069238dce29853916d624c",
        "period_type": "NORMAL",
        "purchased_at": 1602125078,
        "expiration_at": 1604807078,
        "store": "APP_STORE",
        "environment": "PRODUCTION",
        "last_event_type": "renewal",
        "last_event_at": 1602122793,
        "product_id": "monthly_sub",
        "entitlement_ids": "Pro"
    }
}

{
    "app_id": "12345678-1234-1234-1234-123456789012",
    "tags": {
        "app_user_id": "$RCAnonymousID:87c6049c58069238dce29853916d624c",
        "period_type": "NORMAL",
        "purchased_at": 1602086660,
        "expiration_at": 1602691460,
        "store": "APP_STORE",
        "environment": "PRODUCTION",
        "last_event_type": "cancellation",
        "last_event_at": 1602118600,
        "product_id": "weekly_sub",
        "entitlement_ids": null
    }
}

{
    "app_id": "12345678-1234-1234-1234-123456789012",
    "tags": {
        "app_user_id": "$RCAnonymousID:87c6049c58069238dce29853916d624c",
        "period_type": "TRIAL",
        "purchased_at": 1663445025,
        "expiration_at": 1664049825,
        "store": "APP_STORE",
        "environment": "PRODUCTION",
        "last_event_type": "uncancellation",
        "last_event_at": 1663969096,
        "product_id": "annual_sub",
        "entitlement_ids": "Premium"
    }
}

{
    "app_id": "12345678-1234-1234-1234-123456789012",
    "tags": {
        "app_user_id": "$RCAnonymousID:87c6049c58069238dce29853916d624c",
        "purchased_at": 1602086660,
        "store": "APP_STORE",
        "environment": "PRODUCTION",
        "last_event_type": "non_renewing_purchase",
        "last_event_at": 1602118600,
        "product_id": "one_time_purchase_product",
        "entitlement_ids": null
    }
}

{
    "app_id": "12345678-1234-1234-1234-123456789012",
    "tags": {
        "app_user_id": "$RCAnonymousID:87c6049c58069238dce29853916d624c",
        "period_type": "NORMAL",
        "purchased_at": 1602086660,
        "expiration_at": 1602691460,
        "store": "PLAY_STORE",
        "environment": "PRODUCTION",
        "last_event_type": "subscription_paused",
        "last_event_at": 1602118600,
        "product_id": "weekly_sub",
        "auto_resume_at": 1602119600,
        "entitlement_ids": null
    }
}

{
    "app_id": "12345678-1234-1234-1234-123456789012",
    "tags": {
        "period_type": "NORMAL",
        "purchased_at": 1652374230,
        "expiration_at": 1652979030,
        "last_event_type": "expiration",
        "last_event_at": 1652988735
    }
}

{
    "app_id": "12345678-1234-1234-1234-123456789012",
    "tags": {
        "app_user_id": "$RCAnonymousID:87c6049c58069238dce29853916d624c",
        "period_type": "TRIAL",
        "purchased_at": 1652383957,
        "expiration_at": 1654371157,
        "store": "APP_STORE",
        "environment": "PRODUCTION",
        "last_event_type": "billing_issue",
        "last_event_at": 1652988776,
        "product_id": "annual_sub",
        "entitlement_ids": "Premium"
    }
}

{
    "app_id": "12345678-1234-1234-1234-123456789012",
    "tags": {
        "app_user_id": "$RCAnonymousID:87c6049c58069238dce29853916d624c",
        "period_type": "NORMAL",
        "purchased_at": 1602086660,
        "expiration_at": 1602691460,
        "store": "APP_STORE",
        "environment": "PRODUCTION",
        "last_event_type": "product_change",
        "last_event_at": 1602118600,
        "product_id": "weekly_sub",
        "new_product_id": "monthly_sub",
        "entitlement_ids": null
    }
}

Tag `subscription_status`

Lorsque RevenueCat envoie un événement à OneSignal, un tag subscription_status est ajouté ou mis à jour avec tous les changements applicables, utilisant l’une des valeurs suivantes :

Statut	Description
active	Le client a un abonnement actif et payant qui est configuré pour se renouveler à sa prochaine date de renouvellement.
intro	Le client a un abonnement actif et payant via une offre d’introduction payante.
cancelled	Le client a un abonnement payant qui est configuré pour expirer à sa prochaine date de renouvellement.
grace_period	Le client a un abonnement payant qui est entré dans une période de grâce après avoir échoué à se renouveler avec succès.
trial	Le client est dans une période d’essai qui est configurée pour se convertir en abonnement payant à la fin de sa période d’essai.
cancelled_trial	Le client est dans une période d’essai qui est configurée pour expirer à la fin de sa période d’essai.
grace_period_trial	Le client était dans une période d’essai et est maintenant entré dans une période de grâce après avoir échoué à se renouveler avec succès.
expired	L’abonnement du client a expiré.
promotional	Le client a accès à une autorisation via RevenueCat
expired_promotional	Le client avait précédemment accès à une autorisation via une autorisation accordée RevenueCat qui a depuis expiré.
paused	Le client a un abonnement payant qui a été mis en pause et est configuré pour reprendre à une date future.

Pour les clients ayant plusieurs abonnements actifs, cet attribut représentera le statut uniquement de l’abonnement pour lequel l’événement le plus récent s’est produit.

FAQ

Comment savoir si l’intégration fonctionne ?

Dans OneSignal, accédez à Audience > Utilisateurs et recherchez l’identifiant OneSignal. Vous devriez voir les tags qui ont été mis à jour par RevenueCat. Vous pouvez également aller dans Audience > Segments et créer un segment qui filtre les tags que vous avez définis via RevenueCat.

Combien de tags puis-je définir ?

Il n’y a pas de limite au nombre de tags que vous pouvez définir dans OneSignal, mais il y a une limite au nombre de tags que chaque utilisateur peut avoir à un moment donné. Consultez notre page de tarification pour plus d’informations.

Premiers pas et paramètres

Canaux de messagerie

Journeys

Audience et événements personnalisés

Analyses et intégrations

Confidentialité et sécurité

Aperçu

Principaux avantages

Prérequis

Configuration

Connecter OneSignal à RevenueCat

Transmettre l’identifiant OneSignal à RevenueCat

Envoyer les événements RevenueCat vers OneSignal

Tester l’intégration

Tags d’événements RevenueCat

Exemples d’événements RevenueCat

Tag `subscription_status`

FAQ

Comment savoir si l’intégration fonctionne ?

Combien de tags puis-je définir ?

​Aperçu

​Principaux avantages

​Prérequis

​Configuration

​Connecter OneSignal à RevenueCat

​Transmettre l’identifiant OneSignal à RevenueCat

​Envoyer les événements RevenueCat vers OneSignal

​Tester l’intégration

​Tags d’événements RevenueCat

​Exemples d’événements RevenueCat

​Tag subscription_status

​FAQ

​Comment savoir si l’intégration fonctionne ?

​Combien de tags puis-je définir ?

Aperçu

Principaux avantages

Prérequis

Configuration

Connecter OneSignal à RevenueCat

Transmettre l’identifiant OneSignal à RevenueCat

Envoyer les événements RevenueCat vers OneSignal

Tester l’intégration

Tags d’événements RevenueCat

Exemples d’événements RevenueCat

Tag `subscription_status`

FAQ

Comment savoir si l’intégration fonctionne ?

Combien de tags puis-je définir ?