Le SDK Mobile Engage, c'est quoi ?
Le SDK Mobile Engage vous permet d'utiliser très simplement Mobile Engage.En incorporant le SDK dans votre appli, nous vous aidons, entre autres, à gérer les identifiants, les appels API, le traçage des ouvertures et des événements ainsi que les connexions et les déconnexions dans l'appli.
Le SFK Mobile Engage est en open source afin d'augmenter la transparence et d'éviter les soucis de confidentialité. Ceci implique également que vous pouvez toujours être à jour sur ce sur quoi nous travaillons.
Utiliser le SDK est également avantageux pour l'aspect du produit : l'envoi de messages push via votre appli est de ce fait beaucoup plus facile. Vous n'avez pas besoin de suivre et de mettre en place des changements dans nos appels, points d'entrée et paramètres API : Nous le faisons pour vous dans le kit de développement (SDK). Votre seule tâche est d'utiliser la dernière version du SDK dans votre appli, et nous nous occupons de tout le reste.
Intégrer avec iOS
Installation avec CocoaPods
CocoaPods est un gestionnaire de dépendance pour iOS, qui automatise et simplifie le processus d'utilisation de bibliothèques tierces.
Vous pouvez l'installer avec la commande suivante :
$ gem install cocoapods
1. Podfile
Pour intégrer le SDK Mobile ENfage sur cotre projet Xcode avec CocoaPods, spécifiez-le dans votre Podfile:
Lorsque vous voyez <NomCible> ou quelque chose de semblable entre <> crochets, vous devez les changer en fonction de votre convention de nommage personnalisée.
2. Installer Pods
Après avoir créé le Podfile, il vous faut exécuter la commande ci-dessous pour en télécharger les dépendances :
pod install
3. Obligations
La cible iOS doit être iOS 9 ou plus récent.
4. Utilisation
Pour configurer le SDK, voici ce qui doit être fait dans l'AppDelegate de l'application:
LepushToken doit être configuré lorsqu'il arrive:
Si vous souhaitez recevoir le journal des erreurs, vous devez paramétrer MobileEngage.statusDelegate:
Chaque appel renvoie un eventId, qui peut être utilisé avec le statusDelegate pour tracer nos appels. LestatusDelegate définit deux méthodes:
Lorsque l'installation de l'application est terminée, l'appLogin doit être appelée. Si l'utilisateur n'est plus connecté, il peut être utilisé sans paramtres:
Si les données d'authentification sont déjà connues, l'appLogin doit être utilisé avec les paramètres :
Si vous souhaitez vérifier si les messages push ont été ouverts, c'est la fonction trackMessageOpen qu'il faut utiliser. Dans le plus simple des cas, il se trouvera dans la méthode didReceiveRemoteNotification:fetchCompletionHandler: de l'AppDelegate :
Si vous souhaitez vérifier les événements personnalisés, c'est la fonction trackCustomEvent qu'il faut utliser, où le paramètre nomévénement est obligatoire, mais tous les autres attributs sont facultatifs:
Lorsque l'utilisateur se déconnecte, la fonction appLogout doit être utilisée :
Après cette étape, l'installation est terminée.
Intégrer avec Android
1. Installation avec Gradle
Gradle est un système de construction pour Android, qui automatise et simplifie le processus d'utilisation de bibliothèques tierces.
2. Spécifier le SDK Mobile Engage
Pour intégrer le SDK Mobile Engage dans votre projet Android sur Gradle, vous devez le spécifier dans le fichier build.gradle de votre application :
Lorsque vous voyez <Chaîne> ou quelque chose de semblable entre <> crochets, vous devez les changer en fonction de votre convention de nommage personnalisée.
3. Obligations
La version minimum d'Android doit être au moins API level 14.
Le SDK Mobile Engage va de pair avec les dépendances Firebase, mais il ne vous fournit pas tous les paramètres nécessaires pour que votre appli fonctionne.
Pour intégrer Firebase dans votre appli, suivez les instructions dans la documentaiton Firebase. En revanche, vous n'avez pas besoin d'ajouter les dépendances de Firebase pourfirebase-core et firebase-messaging, car ils sont déjà inclus dans le SDK Mobile Engage.
Pour permettre au SDK Mobile Engage de gérer automatiquement les appelssetPushToken and trackMessageOpen pour vous, merci de d'inscrire ces services dans votre fichier manifest.
De plus, vous pouvez installer une icône de notification personnalisée, en précisant qu'il s'agit de méta-données entre le tag de votre application :
4. Utilisation
Pour configurer le Kit de Développement (SDK), vous devez exécuter ce qui suit dans la méthodeonCreate dans la classe Application, Et nous pouvons configurer le statusListener également :
LestatusListenerpeut également être réglé plus tard; il n'est pas obligatoire pour l'initialisation de Mobile Engage:
Chaque appel renvoie un eventId, qui peut être utilisé avec le statusListener pour tracer nos appels. Le statusListener définit deux méthodes:
Lorsque l'installation de l'application est terminée, vos pouvez utiliser les méthodes d'appLogin pour identifier l'utilisateur. Si vous souhaitez vérifier les uilisateurs aninymes, vous pouvez utiliser appLogin sans paramètres:
Si l'utilisateur est déjà connu, vous pouvez utiliser les paramètres : appLogin avec contactFieldID et contactFieldValue :
Si vous souhaitez vérifier si les messages push ont été ouverts, c'est la fonction trackMessageOpen qu'il faut utiliser; et nous envoyons le RemoteMessage que nous recevons du FCM :
Si vous souhaitez vérifier les événements personnalisés, c'est la fonction trackCustomEvent qu'il faut utliser, où le paramètre nom est obligatoire, mais tous les autres attributs sont facultatifs:
Lorsque l'utilisateur se déconnecte, la fonction appLogout doit être utilisée :
Après cette étape, l'installation est terminée.
Résolution des problèmes
Il y a deux méthodes pour vérifier l'intégration du SDK.
1. Vérifier les résultats des appels SDK
Chaque appel MobileEngage (appLogin, appLogout, trackCustomEvent) renvoie un unique eventId, ce qui vous permet de tracer le résultat de chaque appel.
Aussitôt que le SDK Mobile Engage reçoit une réaction de nos serveurs, le statusDelegate fourni sur iOS ou bien le MobileEngageStatusListener sur Android est notifié du succès de cet eventId:
- Si la requête a fonctionné, les méthodes
mobileEngageLogReceived(iOS), ouonStatusLog(Android) sont appelées avec l'eventIdet un message de log. - Si la demande a échoué, les méthodes
mobileEngageErrorHappened(iOS), ouonError(Android) sont sollicitées avec l'eventIdet l'Erreur/Exception. L'erreur/exception peut être une erreur de réseau (IOException) ou une exception personnalisée accompagnant la réponse du serveyr. Par exemple : 400 - Mauvaise demande.
2. Vérifier que les appels SDK sont reçus par nos serveurs
Vous pouvez vérifier si les appels SDK ont été reçus par nos serveurs en cliquant sur l'icône SDK events sur les onglets e Apps De l'interface utilisateur Mobile Engage.
La colonne Nom montre l'événement qui a été reçu alors que la colonne Statut montre le code de réponse. Si sa valeur est 201 ou 202,l'intégration du SDK est réussie.
Mettre à jour le SDK
Pourquoi est-il avantageux de mettre à jour le SDK?
Chaque nouvelle sortie du SDK apporte soit de nouvelles fonctionnalités, soit des corrections de problèmes connus, donc il est toujours avantageux de mettre à jour vers la nouvelle version.
Nous faisons en sorte d'assurer que le SDK sot de qualité maximale, et cela implique de prendre en compte la compatibilité rétroactive.
A quelle fréquence devriez-vous mettre à jour le tout nouveau SDK ?
De manière générale, il est conseillé de mettra à jour votre version aussi souvent que possible. Même si vous ne prévoyez pas d'incorporer des nouvelles fonctionnalités à votre appli, nous vous encourageons quand même à faire au moins une mise à jour lorsqu'une nouvelle version patch sort, afin de ne pas manquer les corrections de bogues et d'autres améliorations du SDK.
Qu'est-ce que la numérotation de versions du SDK?
Le Versioning du SDK suit la logique x,y,z pour laquelle xest une version majeure, y est une version mineure, etz une version de correction (patch)
- Version majeure - C'est une nouvelle version importante, qui implique par exemple une fonctionnalité attendue impatiemment.Bien que cela arrive contre notre plein gré, il se peut qu'une nouvelle version majeure affecte la compatibilité rétroactive avec la précédente version.Nous nous efforçons d'en sortir un minimum et ce pour une raison importante. Ceci sera toujours communiqué avant.
- version mineure - Elle apporte de nouvelles petites fonctionnalités. Les versions mineures ne régressent jamais sur la compatibilité.
- Version de correction - Elle vous apporte des corrections de bugs, de la stabilité et des améliorations de performance.Les versions de correction ne régressent pas non plus sur la compatibilité.
Effectuer la migration de l'API Mobile Engage API au SDK Mobile Engage
iOS
Afin de passer au nouveau SDK Mobile Engage sur iOS, procédez comme suit :
1. Activer les services push
Les instructions pour activer les notifications push se trouvent dans la documentation officielle Apple iOS.
2. Initialiser le SDK Mobile Engage
Initialisez le SDKdans l'AppDelegate de votre appli. Pour en savoir plus, consultez le Guide d'intégration du SDK iOS Mobile Engage.
3. Passer des appels API aux invocations de la méthode SDK
Au lieu d'appels API, utilisez ces méthodes correspondantes :
MobileEngage.appLoginMobileEngage.appLogoutMobileEngage.trackCustomEvent4. Installer jeton push
Utilisez la méthode MobileEngage.setPushToken. Pour en savoir plus, consultez le Guide d'intégration du SDK iOS Mobile Engage.
Android
Afin de passer au nouveau SDK Mobile Engage sur Android, procédez comme suit :
1. Activer les services push
Vous devez ajouter Firebase à votre projet, soit via l'Assistant Firebase, soit manuellement. Pour en savoir plus, consultez la rubrique Intégrer avec Android ci-dessus.
2. Initialiser le SDK Mobile Engage
Initialisez le SDK dans la méthodeonCreate dans la classe de l'application. Pour en savoir plus, consultez le Guide d'intégration du SDK Android Mobile Engage.
3. Passer des appels API aux invocations de la méthode SDK
Au lieu d'appels API, utilisez ces méthodes correspondantes :
MobileEngage.appLoginMobileEngage.appLogoutMobileEngage.trackCustomEvent