Passer au contenu principal

​
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

​
Configuration

​
Connecter OneSignal à RevenueCat

  1. Dans votre tableau de bord RevenueCat, accédez aux paramètres de votre projet et choisissez ‘OneSignal’ dans le menu Intégrations.
  2. Ajoutez votre identifiant d’application OneSignal et votre clé API OneSignal. Consultez Clés et identifiants pour plus d’informations.
  3. 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 :
1

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.
2

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 :
3

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

1

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.
2

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.
3

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.
4

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.
TagDescription
app_user_idL’identifiant utilisateur d’application RevenueCat qui a déclenché l’événement
period_typeLe 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_atTemps Unix en secondes du dernier achat ou renouvellement d’abonnement
expiration_atTemps Unix en secondes de la dernière date d’expiration de l’abonnement
storeSoit APP_STORE, PLAY_STORE, ou STRIPE
environmentSoit SANDBOX ou PRODUCTION
last_event_typeLe dernier type d’événement de l’utilisateur. Soit : INITIAL_PURCHASE, TRIAL_STARTED, TRIAL_CONVERTED, TRIAL_CANCELLED, RENEWAL, CANCELLATION
product_idLe dernier identifiant de produit d’abonnement que l’utilisateur a acheté ou renouvelé
entitlement_idsChaîne séparée par des virgules d’identifiants d’autorisations RevenueCat que l’utilisateur a débloqués
active_subscriptionLa valeur sera définie sur true pour tout événement d’achat/renouvellement, et false sur EXPIRATION
subscription_statusVoir l’attribut Statut d’abonnement ci-dessous
grace_period_expiration_atSi 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.
  • initial_purchase
  • trial_started
  • trial_converted
  • trial_cancelled
  • renewal
  • cancellation
  • uncancellation
  • non_subscription_purchase
  • subscription_paused
  • expiration
  • billing_issue
  • product_change
{
    "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"
    }
}

​
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 :
StatutDescription
activeLe client a un abonnement actif et payant qui est configuré pour se renouveler à sa prochaine date de renouvellement.
introLe client a un abonnement actif et payant via une offre d’introduction payante.
cancelledLe client a un abonnement payant qui est configuré pour expirer à sa prochaine date de renouvellement.
grace_periodLe client a un abonnement payant qui est entré dans une période de grâce après avoir échoué à se renouveler avec succès.
trialLe 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_trialLe client est dans une période d’essai qui est configurée pour expirer à la fin de sa période d’essai.
grace_period_trialLe 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.
expiredL’abonnement du client a expiré.
promotionalLe client a accès à une autorisation via RevenueCat
expired_promotionalLe client avait précédemment accès à une autorisation via une autorisation accordée RevenueCat qui a depuis expiré.
pausedLe 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.