Logo Help Portal
  • Démarrer

    Introduction

    • Onboarding overview
    • Initiation de projet
    • Email compliance
    • Gestion de Compte

    Données

    • Echange de données
    • Adaptation de données
    • Web data collection

    Channels

    • Email onboarding
    • Smart Insight
    • Predict
  • Formation
    • Online Self Learning
    • Vidéos d'intégration
    • Instructor Led Training
    • Webinaires
    • Séminaires
  • Guides d'utilisation

    Stratégie

    • Personnalisation
    • Automatisation
    • Data Monitoring

    Channels

    • Email
    • Application mobile
    • Web
    • Ads

    Add-ons

    • Smart Insight
    • Predict
    • Recommandations d'incitations
    • AIM
  • Articles de support technique

    Nouveautés

    • Quoi de neuf sur la Plateforme Emarsys ?
    • Fonctionnalités pilotes
    • Articles sur la RGPD et la Protection des Données
    • Release notes - archive

    Support

    • L'aide et le support chez Emarsys
    • Gérer votre profil d'utilisateur
  • |
  • Dévelopeurs
  • Etat du système
Besoin d’aide? Envoyer une demande
Français Deutsch English Español Русский Türkçe 简体中文
Connexion
  • Documentation_-Execution_- Application mobile
  • Mobile Engage
  • 0 Documentation_-Execution_- Application mobile Mobile Engage

Dans cette section :

  • A propos de Mobile Engage
  • Le modèle de flux de données Mobile Engage
  • L'API Mobile Engage v2
  • L'initialisation de Mobile Engage
  • Importer les Publics Push Précédents vers Mobile Engage
  • Guide Mobile Engage à destination de l'utilisateur final
  • Mobile Engage - Fonctionnalités avancées
  • Creating a Trackable Deep Link for Mobile in Email
  • Obtaining Certifications and Tokens for Sending Push Messages
  • Glossaire Mobile Engage
  • Afficher plus

in Emarsys42

    Expand all

    L'API Mobile Engage v2

    Updated: 22 mai 2017 14:57

    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:

    • Swift
    • Objective-C

    LepushToken doit être configuré lorsqu'il arrive:

    • Swift
    • Objective-C

    Si vous souhaitez recevoir le journal des erreurs, vous devez paramétrer MobileEngage.statusDelegate:

    • Swift
    • Objective-C

    Chaque appel renvoie un eventId, qui peut être utilisé avec le statusDelegate pour tracer nos appels. LestatusDelegate définit deux méthodes:

    • Swift
    • Objective-C

    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:

    • Swift
    • Objective-C

    Si les données d'authentification sont déjà connues, l'appLogin doit être utilisé avec les paramètres :

    • Swift
    • Objective-C

    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 :

    • Swift
    • Objective-C

    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:

    • Swift
    • Objective-C

    Lorsque l'utilisateur se déconnecte, la fonction appLogout doit être utilisée :

    • Swift
    • Objective-C

    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), ou onStatusLog (Android) sont appelées avec l'eventId et un message de log.
    • Si la demande a échoué, les méthodes mobileEngageErrorHappened (iOS), ou onError (Android) sont sollicitées avec l' eventId et 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.

    événements-sdk-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.appLogin
    MobileEngage.appLogout
    MobileEngage.trackCustomEvent

    4. 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.appLogin
    MobileEngage.appLogout
    MobileEngage.trackCustomEvent
    Cet article vous a-t-il été utile ?

    Vous avez d’autres questions ? Envoyer une demande
    Retour en haut

    You may also be interested in:

    Articles associés

    • A propos de Mobile Engage
    • Guide Mobile Engage à destination de l'utilisateur final
    • L'API Mobile Engage
    • Importer les Publics Push Précédents vers Mobile Engage
    • Data Collection JavaScript API Reference
    Copyright © 2019 Emarsys eMarketing Systems. All rights reserved
    Legal Notice Privacy Policy Master Services Agreement Anti-spam Policy
    test new search