OneSignal

OneSignal est une plateforme d’engagement client de premier plan qui propose des notifications push, des e-mails, des SMS et des messages in-app. L’intégration d’Adapty avec OneSignal vous permet d’accéder à tous vos événements d’abonnement en un seul endroit, ce qui vous permet de déclencher des communications automatisées basées sur ces événements.

Avec Adapty, vous pouvez suivre les événements d’abonnement sur plusieurs stores, analyser le comportement des utilisateurs et utiliser ces données pour une communication plus ciblée. Cette intégration vous permet de surveiller les événements d’abonnement dans votre tableau de bord OneSignal et de les associer à vos campagnes d’acquisition.

Adapty met à jour les tags OneSignal en fonction des événements d’abonnement, ce qui vous permet d’envoyer des notifications push personnalisées avec une configuration minimale.

Caractéristiques de l’intégration

Configuration de l’intégration One Signal

Pour configurer l’intégration :

1. Ouvrez Integrations → OneSignal dans votre Adapty Dashboard.

   

2. Activez le bouton d’intégration.

3. Saisissez votre OneSignal App ID.

Pour configurer l’intégration avec OneSignal, rendez-vous dans Integrations -> OneSignal dans votre Adapty Dashboard, activez le bouton bascule et configurez les identifiants de l’intégration.

Récupérer votre OneSignal App ID

Trouvez votre OneSignal App ID dans votre OneSignal Dashboard :

1. Accédez à Settings → Keys & IDs.

   

2. Copiez votre OneSignal App ID et collez-le dans le champ App ID de l’Adapty Dashboard.

Vous trouverez plus d’informations sur l’identifiant OneSignal dans la documentation suivante.

Configuration des événements

Adapty vous permet d’envoyer trois groupes d’événements à OneSignal. Activez ceux dont vous avez besoin dans l’Adapty Dashboard. Vous pouvez consulter la liste complète des événements disponibles avec leur description détaillée ici.

Adapty envoie les événements d’abonnement à OneSignal via une intégration serveur à serveur, ce qui vous permet de suivre toute l’activité liée aux abonnements dans OneSignal.

Tags personnalisés

Cette intégration met à jour et attribue diverses propriétés à vos utilisateurs Adapty sous forme de tags, qui sont ensuite envoyés à OneSignal. Consultez la liste des tags ci-dessous pour trouver ceux qui correspondent le mieux à vos besoins.

Toutes les valeurs décimales sont arrondies à des entiers. Les chaînes de caractères restent inchangées.

En plus des tags prédéfinis, vous pouvez envoyer des attributs personnalisés en tant que tags, ce qui offre une plus grande flexibilité dans les données que vous incluez. C’est utile pour suivre des détails spécifiques liés à votre produit ou service.

Les attributs utilisateur personnalisés sont automatiquement envoyés à OneSignal si la case Send user attributes est cochée sur la page d’intégration. Lorsqu’elle est décochée, Adapty envoie exactement 10 tags. Lorsqu’elle est cochée, plus de 10 tags peuvent être envoyés, permettant une capture de données enrichie.

Configuration du SDK

Il existe deux façons d’intégrer OneSignal avec Adapty :

1. Legacy (avant v5) : Utilise playerId (déprécié dans le SDK OneSignal v5).
2. Actuel (v5+) : Utilise subscriptionId.

// SubscriptionID
OneSignal.Notifications.requestPermission({ accepted in
    Task {
        // Adapty SDK 4.x
        try await Adapty.setIntegrationIdentifier(.oneSignalSubscriptionId(OneSignal.User.pushSubscription.id))
        // Adapty SDK 3.x
        try await Adapty.setIntegrationIdentifier(
            key: "one_signal_subscription_id", 
            value: OneSignal.User.pushSubscription.id
        )
    }
}, fallbackToSettings: true)

// SubscriptionID
val oneSignalSubscriptionObserver = object: IPushSubscriptionObserver {
    override fun onPushSubscriptionChange(state: PushSubscriptionChangedState) {
        Adapty.setIntegrationIdentifier("one_signal_subscription_id", state.current.id) { error ->
            if (error != null) {
                // handle the error
            }
        }
    }
}

// SubscriptionID
IPushSubscriptionObserver oneSignalSubscriptionObserver = state -> {
    Adapty.setIntegrationIdentifier("one_signal_subscription_id", state.getCurrent().getId(), error -> {
        if (error != null) {
            // handle the error
        }
    });
};

// 1. Since OneSignal.User.pushSubscription.id may return null if called too early, 
// OneSignal suggests to listen for the updates:

OneSignal.User.pushSubscription.addObserver((state) {
   if (state.current.optedIn) {
      // now you can try to retrieve subscriptionId
   }
});

// 2. Then you can push subscriptionId to Adapty:
final subscriptionId = OneSignal.User.pushSubscription.id;
if (subscriptionId != null) {
   await Adapty().setIntegrationIdentifier(key: "one_signal_subscription_id", value: subscriptionId);
}

using AdaptySDK;
using OneSignalSDK;

var pushUserId = OneSignal.Default.PushSubscriptionState.userId;

Adapty.SetIntegrationIdentifier(
  "one_signal_player_id", 
  pushUserId, 
  (error) => {
  // handle the error
});

OneSignal.User.pushSubscription.addEventListener('change', (subscription) => {
  const subscriptionId = subscription.current.id;

  if (subscriptionId) {
    adapty.setIntegrationIdentifier("one_signal_subscription_id", subscriptionId);
  }
});

// PlayerID
// in your OSSubscriptionObserver implementation
func onOSSubscriptionChanged(_ stateChanges: OSSubscriptionStateChanges) {
    if let playerId = stateChanges.to.userId {
        Task {
            // Adapty SDK 4.x
            try await Adapty.setIntegrationIdentifier(.oneSignalPlayerId(playerId))
            // Adapty SDK 3.x
            try await Adapty.setIntegrationIdentifier(
                key: "one_signal_player_id", 
                value: playerId
            )
        }
    }
}

// PlayerID
val osSubscriptionObserver = OSSubscriptionObserver { stateChanges ->
    stateChanges?.to?.userId?.let { playerId ->
        Adapty.setIntegrationIdentifier("one_signal_player_id", playerId) { error ->
            if (error != null) {
                // handle the error
            }
        }
    }
}

// PlayerID
OSSubscriptionObserver osSubscriptionObserver = stateChanges -> {
    OSSubscriptionState to = stateChanges != null ? stateChanges.getTo() : null;
    String playerId = to != null ? to.getUserId() : null;
    
    if (playerId != null) {
        Adapty.setIntegrationIdentifier("one_signal_player_id", playerId, error -> {
            if (error != null) {
                // handle the error
            }
        });
    }
};

// PlayerID (pre-v5 OneSignal SDK)
// in your OSSubscriptionObserver implementation
func onOSSubscriptionChanged(_ stateChanges: OSSubscriptionStateChanges) {
    if let playerId = stateChanges.to.userId {
        Task {
            try await Adapty.setIntegrationIdentifier(
                key: "one_signal_player_id", 
                value: playerId
            )
        }
    }
}

OneSignal.addSubscriptionObserver(event => {
  const playerId = event.to.userId;
  
  adapty.setIntegrationIdentifier("one_signal_player_id", playerId);
});

En savoir plus dans la documentation OneSignal :

• ID d’abonnement push
• Modifications d’abonnement push

Gérer plusieurs appareils

Si un utilisateur possède plusieurs appareils, le suivi des événements d’achat et des abonnements peut s’avérer complexe. OneSignal propose une solution via les identifiants utilisateur externes.

Pour maintenir la cohérence des données utilisateur sur tous les appareils :

1. Faites correspondre les différents appareils côté serveur et envoyez ces données à OneSignal.
2. Utilisez le customer_user_id d’Adapty comme externalUserId dans OneSignal. Si votre application n’a pas de système d’inscription, envisagez d’utiliser un autre identifiant unique qui reste cohérent sur tous les appareils de l’utilisateur.

Il est important de maintenir la cohérence de l’identifiant utilisateur sur tous les appareils et de mettre à jour OneSignal chaque fois que l’ID d’un utilisateur change. Cela simplifie le suivi de l’activité et des abonnements des utilisateurs tout en garantissant une messagerie cohérente, et permet une analyse plus précise ainsi qu’une meilleure expérience utilisateur. Pour plus de détails, consultez la documentation OneSignal sur les identifiants utilisateurs externes.

Résolution des problèmes

access_level_updated apparaît comme échoué dans le fil d’événements

access_level_updated est un événement réservé aux webhooks. Adapty ne l’envoie jamais à cette intégration. Mais Adapty enregistre un résultat pour chaque intégration activée, et un événement non pris en charge est affiché comme un échec.