Étapes de configuration pour Android

Une fois le package installé, vous pouvez définir les paramètres de votre application Android dans Adobe Campaign Classic.

NOTE

Pour savoir comment configurer votre application pour iOS et comment créer une diffusion pour iOS, reportez-vous à cette section.

Les étapes clés sont les suivantes :

  1. Configuration du compte externe Android
  2. Configuration du service Android
  3. Création de l’application mobile dans Campaign
  4. Étendre le schéma de l’application avec des données supplémentaires

Vous pourrez alors créer une notificationAndroid enrichie.

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

    NOTE

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

Configuration du service Android

Découvrez comment configurer un service Android dans la vidéo

  1. Dans l'arborescence, positionnez-vous sur le nœud 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.

    NOTE

    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. Créez votre application Android. Pour plus d'informations à ce sujet, consultez cette section.

Création d'applications mobiles Android

Après avoir créé votre service, vous devez maintenant créer votre application Android :

  1. Dans le service que vous venez de créer, cliquez sur le bouton Ajouter pour choisir le type d'application.

  2. Sélectionnez Créer une application Android et saisissez un libellé.

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

    NOTE

    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.

  4. Sélectionnez la version de l’ API : HTTP v1 ou HTTP (hérité). These configurations are detailed in this section

  5. Fill in the Firebase Cloud Messaging the Android connection settings fields.

  6. 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 :

Sélectionner la version d'API

Après avoir créé un service et une nouvelle application mobile, vous devez configurer votre application mobile en fonction de la version d'API choisie.

  • La configuration HTTP v1 est détaillée dans cette section.
  • La configuration HTTP (héritée) est détaillée dans cette section.

Configuration de l’API HTTP v1

Pour configurer la version d'API HTTP v1, procédez comme suit :

  1. Dans la fenêtre de l'assistant de création d'une application mobile, sélectionnez HTTPV1 dans la liste déroulante Versions d'API.

  2. Cliquez sur Charger le fichier json du projet pour extraire les détails du projet… pour charger directement votre fichier de clé JSON. Pour plus d'informations sur l'extraction de votre fichier JSON, consultez cette page.

    Vous pouvez également saisir manuellement les informations suivantes :

    • Identifiant du projet
    • Clé privée
    • Email client

  3. Cliquez sur Tester la connexion pour vérifier que votre configuration est correcte et que le serveur marketing a accès au FCM.

    CAUTION

    Dans le cas de déploiement Mid-sourcing, le bouton Tester la connexion ne vérifie pas si le serveur MID a accès au serveur FCM.

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

  5. Cliquez sur Terminer, puis sur Enregistrer. Votre application Android est maintenant prête à être utilisée dans Campaign Classic.

Vous trouverez ci-dessous les noms de payload FCM pour personnaliser davantage votre notification push :

Type de message Élément de message configurable (nom de payload FCM) Options configurables (nom de payload FCM)
Message de données N/A validate_only
Message de notification title, body, android_channel_id, icon, sound, tag, color, click_action, image, ticker, sticky, visibility, notification_priority, notification_count
validate_only


Configuration de l’API HTTP (héritée)

Pour configurer la version d'API HTTP (hérité), procédez comme suit :

  1. Dans la fenêtre de l'assistant de création d'une application mobile, sélectionnez HTTP (hérité) dans la liste déroulante Versions d'API.

  2. Saisissez la clé du projet fournie par le développeur de l'application mobile.

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

  4. Cliquez sur Terminer, puis sur Enregistrer. Votre application Android est maintenant prête à être utilisée dans Campaign Classic.

Vous trouverez ci-dessous les noms de payload FCM pour personnaliser davantage votre notification push :

Type de message Élément de message configurable (nom de payload FCM) Options configurables (nom de payload FCM)
Message de données N/A dryRun
Message de notification title, body, android_channel_id, icon, sound, tag, color, click_action
dryRun

Étendre le schéma appsubscriptionRcp

Découvrez comment étendre le schéma appsubscriptionRcp en vidéo

Vous devez étendre la valeur appsubscriptionRcp pour définir de nouveaux champs supplémentaires afin de stocker les paramètres de l’application dans la base de données Campaign. Ces champs seront utilisés pour la personnalisation, par exemple. Pour cela :

  1. Créez une extension du schéma Applications abonnées (nms:appSubscriptionRcp) et définissez les nouveaux champs. Learn more about schema extension in this page

  2. Définissez le mapping dans l'onglet Paramètres d'abonnement.

    CAUTION

    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.

Création d'une notification Android enrichie

Firebase Cloud Messaging vous permet de choisir entre deux types de messages :

  • Message de données, géré par l'application cliente.

    Les messages sont envoyés directement à l'application mobile qui génèrera et affichera la notification Android sur l'appareil. Les messages de données contiennent uniquement vos variables d'application personnalisées.

  • Message de notification, géré automatiquement par le SDK FCM.

    FCM affiche automatiquement le message sur les appareils de vos utilisateurs pour le compte de l'application cliente. Les messages de notification contiennent un ensemble de paramètres et d'options prédéfini, mais peuvent encore être personnalisés avec des variables d'application personnalisées.

Pour plus d'informations sur les types de messages Firebase Cloud Messaging, consultez la documentation de FCM.

Création d'un message de données

  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, le mapping de ciblage Application abonnés est appliquée. Cliquez sur Ajouter pour sélectionner votre service.

  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. Sélectionnez le message de données comme type de message.

  8. Modifiez la notification enrichie.

  9. Si nécessaire, vous pouvez ajouter des informations dans vos variables d'application configurées précédemment. Les variables d'application doivent être configurées dans le service Android et font partie de la payload du message envoyée à l'appareil mobile.

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

Création d'un message de notification

NOTE

D'autres options de message de notification sont disponibles uniquement avec la configuration d'API HTTP v1. Pour plus d'informations à ce sujet, consultez cette section.

Découvrez comment créer une notification Push Android dans la vidéo

  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, le mapping de ciblage Application abonnés est appliquée. Cliquez sur Ajouter pour sélectionner votre service.

  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.

  7. Sélectionnez le message de notification comme type de message.

  8. Ajoutez un titre et modifiez votre message. Personnalisez votre notification push avec les options de notification :

    • Identifiant de canal : définissez l'identifiant de canal de votre notification. L'application doit créer un canal avec cet identifiant de canal avant la réception d'une notification avec cet identifiant de canal.
    • Son : définissez le son à émettre lorsque l'appareil reçoit votre notification.
    • Couleur définissez la couleur de l'icône de votre notification.
    • Icône : définissez l'icône de la notification pour qu'elle s'affiche sur les appareils de vos profils.
    • Balise : définissez l'identifiant utilisé pour remplacer les notifications existantes dans le tiroir de notifications.
    • Action de clic : définissez l'action associée à un clic de l'utilisateur sur votre notification.

    Pour plus d'informations sur les options de notification et sur la façon de remplir ces champs, consultez la documentation FCM.

  9. Si votre application est configurée avec le protocole API HTTP v1, vous pouvez personnaliser davantage votre notification push à l'aide des options supplémentaires HTTPV1 suivantes :

    • Bandeau déroulant : définissez le texte du bandeau déroulant de votre notification. Uniquement disponible pour les appareils configurés sur Android 5.0 Lollipop.
    • Image : définissez l'URL de l'image à afficher dans votre notification.
    • Nombre de notifications : définissez le nombre de nouvelles informations non lues à afficher directement sur l'icône de l'application.
    • Épinglé : définissez cette variable sur true ou false. Si elle est définie sur false, la notification est automatiquement ignorée lorsque l'utilisateur clique dessus. Si elle est définie sur true, la notification reste affichée même lorsque l'utilisateur clique dessus.
    • Priorité des notifications : définissez les niveaux de priorité de votre notification sur 'par défaut', 'minimum', 'basse' ou 'élevée'. Pour plus d'informations à ce propos, consultez la documentation FCM.
    • Visibilité : définissez les niveaux de visibilité de votre notification sur public, privé ou secret. Pour plus d'informations à ce propos, consultez la documentation FCM.

    Pour plus d'informations sur les options supplémentaires HTTPv1 et sur la façon de remplir ces champs, consultez la documentation FCM.

  10. Si nécessaire, vous pouvez ajouter des informations dans vos variables d'application configurées précédemment. Les variables d'application doivent être configurées dans le service Android et font partie de la payload du message envoyée à l'appareil mobile.

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

Sur cette page