Show Menu
SUJETS×

Paramétrage de l'application mobile dans Adobe Campaign

Vous trouverez ci-dessous un exemple de configuration pour une entreprise qui vend des forfaits de vacances en ligne. Elle propose son application mobile (Neotrips) en deux versions : Neotrips pour Android et Neotrips pour iOS. Pour configurer l’application mobile dans Adobe Campaign, vous devez procéder comme suit :
  • Créez un service d’information de type Application mobile pour l’application mobile Neotrips.
  • Ajoutez, à ce service, les versions iOS et Android de l'application.
  • Créez une diffusion pour iOS et Android.
Dans l'onglet Abonnements du service, vous trouverez la liste de tous les abonnés au service, c'est-à-dire toutes les personnes ayant installé l'application sur leur terminal mobile et accepté de recevoir des notifications.

Configuration de l’application mobile avec iOS

L'application doit avoir été configurée pour des actions de Push AVANT toute intégration au SDK Adobe Campaign.
Si ce n'est pas le cas, veuillez consulter cette page .

Étape 1 : installation du package

  1. Accédez à l'assistant d'import de package depuis le menu Outils > Avancé > Import de package... de la console cliente Adobe Campaign.
  2. Sélectionnez Installer un package standard .
  3. Dans la liste qui s’affiche, cochez Mobile App Channel .
  4. Cliquez sur Suivant puis Démarrer pour commencer l'installation du package.
    Une fois les packages installés, la barre de progression indique 100 % . De plus, les logs d'installation contiennent le message suivant : L'installation des packages s'est terminée avec succès .
  5. Fermez la fenêtre d'installation.

Étape 2 : configuration du compte externe iOS

Deux connecteurs sont disponibles pour iOS :
  • Le connecteur binaire iOS envoie des notifications au serveur APNS binaire.
  • Le connecteur HTTP/2 iOS envoie des notifications à l'APNS HTTP/2.
Pour sélectionner le connecteur à utiliser, procédez comme suit :
  1. Accédez à Administration > Plate-forme > Comptes externes .
  2. Sélectionnez le compte externe routage iOS .
  3. Dans l'onglet Connecteur , renseignez le champ URL d'accès au connecteur  :
    Pour le connecteur HTTP2 iOS : http://localhost:8080/nms/jsp/iosHTTP2.jsp
    Vous pouvez également le configurer comme suit (https://localhost:8080/nms/jsp/ios.jsp), mais nous vous conseillons d’utiliser la version 2 du connecteur.
  4. Cliquez sur Enregistrer .
Votre connecteur iOS est maintenant paramétré. Vous pouvez créer votre service.

Étape 3 : configuration du service iOS

  1. Dans l'arborescence, positionnez-vous sur le noeud Profils et Cibles > Services et abonnements et cliquez sur le bouton Nouveau .
  2. Définissez un Libellé et un Nom interne .
  3. Dans le champ Type , choisissez Application mobile .
    Le mapping de ciblage par défaut Applications abonnées (nms:appSubscriptionRcp) est lié à la table des destinataires. Si vous souhaitez utiliser un autre mapping de ciblage, vous devez créer un nouveau mapping de ciblage et le renseigner dans le champ Mapping de ciblage du service. La création d'un mapping de ciblage est présentée dans le Guide de configuration .
  4. Cliquez ensuite sur le bouton Ajouter pour sélectionner le type d’application.
  5. La fenêtre suivante s’affiche. Sélectionnez Créer une application iOS , puis indiquez le libellé .
  6. Vous pouvez, si nécessaire, enrichir un contenu de message push avec certaines variables d’application . Elles sont entièrement personnalisables et font partie de la payload du message envoyé à l’appareil mobile. Dans l’exemple suivant, nous ajoutons mediaURl et mediaExt pour créer une notification push enrichie, puis nous fournissons à l’application l’image à afficher dans la notification.
  7. L’onglet Paramètres d’abonnement permet de définir la correspondance avec une extension du schéma Applications abonnées (nms:appsubscriptionRcp) .
    Assurez-vous que vous n'utilisez pas le même certificat pour la version de développement (sandbox) et la version de production de l'application.
  8. L’onglet Sons permet de spécifier un son à lire. Cliquez sur Ajouter et renseignez le champ Nom interne . Il doit contenir le nom du fichier incorporé dans l’application ou le nom du son système.
  9. Cliquez sur Suivant pour passer à la configuration de l’application de développement.
  10. Assurez-vous que la même clé d’intégration est définie dans Adobe Campaign et dans le code de l’application via le SDK. Voir à ce sujet la section : Intégrer le SDK Campaign dans l’application mobile . Cette clé d’intégration, spécifique à chaque application, vous permet de lier l’application mobile à la plateforme Adobe Campaign.
    La clé d’intégration est entièrement personnalisable avec une valeur de chaîne, mais doit être exactement identique à celle spécifiée dans le SDK.
  11. Sélectionnez l’une des icônes d’usine dans le champ Icône de l’application pour personnaliser l’application mobile dans votre service.
  12. Cliquez sur le lien Renseigner le certificat puis sélectionnez le certificat d'authentification et saisissez le mot de passe qui vous ont été fournis par le développeur de l'application mobile. Vous pouvez cliquer sur Tester la connexion pour vous assurer qu’elle fonctionne bien.
    Apple demande différents certificats pour les versions de développement et de production d’une même application mobile. Vous devrez configurer les deux applications distinctes dans Adobe Campaign.
  13. Cliquez sur Suivant pour passer à la configuration de l’application de production et procédez comme décrit ci-dessus.
  14. Cliquez sur Terminer . Votre application iOS est maintenant prête à être utilisée dans Campaign Classic.

Étape 4 : création d’une notification iOS enrichie

Avec iOS 10 ou version ultérieure, il est possible de générer des notifications enrichies. Adobe Campaign peut envoyer des notifications à l'aide de variables qui permettront à l'appareil d'afficher des notifications enrichies.
Vous devez maintenant créer une nouvelle diffusion et l’associer à l’application mobile que vous avez créée.
  1. Accédez à Gestion de campagne  > Diffusions .
  2. Cliquez sur Nouveau .
  3. Sélectionnez Diffuser sur iOS (ios) dans la liste déroulante Modèle de diffusion . Ajoutez un Libellé à la diffusion.
  4. Cliquez sur Pour pour définir la population à cibler. Par défaut, l’ Application abonnée est appliquée. Cliquez sur Ajouter pour sélectionner le service créé précédemment.
  5. Dans la fenêtre Type de cible , sélectionnez Abonnés d’une application mobile iOS (iPhone, iPad) et cliquez sur Suivant .
  6. Dans la liste déroulante Service , sélectionnez le service créé précédemment, puis l’application ciblée, et cliquez sur Terminer . Les variables d’application sont automatiquement ajoutées en fonction de ce qui a été incorporé au cours des étapes de configuration.
  7. Éditez la notification enrichie.
  8. Cochez la case Contenu mutable dans la fenêtre d’édition des notifications. L’application mobile pourra ainsi télécharger le contenu multimédia.
  9. Cliquez sur Enregistrer , puis envoyez votre diffusion.
L’image et la page web doivent s’afficher dans la notification push lors de la réception sur les appareils iOS des abonnés.

Configuration de l’application mobile avec Android

Étape 1 : installation du package

  1. Accédez à l'assistant d'import de package depuis le menu Outils > Avancé > Import de package... de la console cliente Adobe Campaign.
  2. Sélectionnez Installer un package standard .
  3. Dans la liste qui s’affiche, cochez Mobile App Channel .
  4. Cliquez sur Suivant puis Démarrer pour commencer l'installation du package.
    Une fois les packages installés, la barre de progression indique 100 % . De plus, les logs d'installation contiennent le message suivant : L'installation des packages s'est terminée avec succès .
  5. Fermez la fenêtre d'installation.

Étape 2 : configuration du compte externe Android

Deux connecteurs sont disponibles pour Android :
  • Le connecteur V1 permet une connexion par MTA child.
  • Le connecteur V2 permet plusieurs connexions simultanées avec le serveur FCM pour améliorer le débit.
Pour sélectionner le connecteur à utiliser, procédez comme suit :
  1. Accédez à Administration > Plate-forme > Comptes externes .
  2. Sélectionnez le compte externe de routage Android .
  3. Dans l'onglet Connecteur , renseignez le champ JavaScript du connecteur  :
    Pour Android V2 : https://localhost:8080/nms/jsp/androidPushConnectorV2.js
    Vous pouvez également le configurer comme suit (https://localhost:8080/nms/jsp/androidPushConnector.js), mais nous vous conseillons d’utiliser la version 2 du connecteur.
  4. Pour Android V2, un paramètre supplémentaire est disponible dans le fichier de configuration du serveur Adobe (serverConf.xml) :
    • maxGCMConnectPerChild  : limite maximale du nombre de requêtes HTTP parallèles sur le serveur FCM initiées par chaque serveur fils (8 par défaut).

Étape 3 : configuration du service Android

  1. Dans l'arborescence, positionnez-vous sur le noeud Profils et Cibles > Services et abonnements et cliquez sur le bouton Nouveau .
  2. Définissez un Libellé et un Nom interne .
  3. Dans le champ Type , choisissez Application mobile .
    Le mapping de ciblage par défaut Applications abonnées (nms:appSubscriptionRcp) est lié à la table des destinataires. Si vous souhaitez utiliser un autre mapping de ciblage, vous devez créer un nouveau mapping de ciblage et le renseigner dans le champ Mapping de ciblage du service. La création d'un mapping de ciblage est présentée dans le Guide de configuration .
  4. Cliquez ensuite sur le bouton Ajouter pour sélectionner le type d’application.
  5. Sélectionnez Créer une application Android .
  6. Saisissez un Libellé .
  7. Assurez-vous que la même clé d’intégration est définie dans Adobe Campaign et dans le code de l’application via le SDK. Voir à ce sujet la section : Intégrer le SDK Campaign dans l’application mobile .
    La clé d’intégration est entièrement personnalisable avec une valeur de chaîne, mais doit être exactement identique à celle spécifiée dans le SDK.
  8. Sélectionnez l’une des icônes d’usine dans le champ Icône de l’application pour personnaliser l’application mobile dans votre service.
  9. Renseignez les paramètres de connexion de l’application : saisissez la clé de projet qui vous a été fournie par le développeur de l’application mobile.
  10. Vous pouvez, si nécessaire, enrichir un contenu de message push avec certaines variables d’application . Elles sont entièrement personnalisables et font partie de la payload du message envoyé à l’appareil mobile.
    Dans l’exemple suivant, nous ajoutons title , imageURL et iconURL pour créer une notification push enrichie, puis nous fournissons à l’application l’image, le titre et l’icône à afficher dans la notification.
  11. Cliquez sur Terminer , puis sur Enregistrer . Votre application Android est maintenant prête à être utilisée dans Campaign Classic.
Par défaut, Adobe Campaign enregistre une clé dans le champ Identifiant de l'utilisateur (@userKey) de la table Applications abonnées (nms:appSubscriptionRcp) . Cette clé permet de relier un abonnement à un destinataire. Si vous souhaitez collecter des données additionnelles (par exemple une clé de réconciliation complexe), vous devez effectuer le paramétrage suivant :
  1. Créez une extension du schéma Applications abonnées (nms:appSubscriptionRcp) et définissez les nouveaux champs.
  2. Définissez le mapping dans l'onglet Paramètres d'abonnement .
    Assurez-vous que les noms des paramètres dans l'onglet Paramètres d’abonnement sont les mêmes que dans le code de l’application mobile. Voir Intégrer le SDK Campaign dans l’application mobile .

Étape 4 : création d’une notification Android enrichie

Vous devez maintenant créer une nouvelle diffusion et l’associer à l’application mobile que vous avez créée.
  1. Accédez à Gestion de campagne  > Diffusions .
  2. Cliquez sur Nouveau .
  3. Sélectionnez Diffuser sur Android (android) dans la liste déroulante Modèle de diffusion . Ajoutez un Libellé à la diffusion.
  4. Cliquez sur Pour pour définir la population à cibler. Par défaut, l’ Application abonnée est appliquée. Cliquez sur Ajouter pour sélectionner le service créé précédemment.
  5. Dans la fenêtre Type de cible , sélectionnez Abonnés d’une application mobile Android, puis cliquez sur Suivant .
  6. Dans la liste déroulante Service , sélectionnez le service créé précédemment, puis l’application ciblée, et cliquez sur Terminer . Les variables d’application sont automatiquement ajoutées en fonction de ce qui a été incorporé au cours des étapes de configuration.
  7. Éditez la notification enrichie.
  8. Cliquez sur Enregistrer , puis envoyez votre diffusion.
L'image et la page web doivent s'afficher dans la notification push lors de la réception sur les appareils Android des abonnés.