É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.
Les étapes clés sont les suivantes :
Vous pourrez alors créer une notification Android enrichie.
Configuration du compte externe Android configuring-external-account-android
Deux connecteurs sont disponibles pour Android :
- Le connecteur V1 permet une connexion par MTA enfant.
- 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 :
-
Accédez à Administration > Plateforme > Comptes externes.
-
Sélectionnez le compte externe de routage Android.
-
Dans l'onglet Connecteur, renseignez le champ JavaScript du connecteur :
Pour Android V2 : https://localhost:8080/nms/jsp/androidPushConnectorV2.js
note note 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. 
-
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 enfant (8 par défaut).
Configuration d'un service Android configuring-android-service
-
Dans l'arborescence, positionnez-vous sur le nœud Profils et Cibles > Services et abonnements et cliquez sur le bouton Nouveau.
-
Définissez un Libellé et un Nom interne.
-
Dans le champ Type, choisissez Application mobile.
note note NOTE Par défaut, le mapping de ciblage Applications abonnées (nms:appSubscriptionRcp) est lié à la table des destinataires. Si vous souhaitez utiliser un autre mapping de ciblage, vous devez en créer un nouveau et le saisir dans le champ Mapping de ciblage du service. Pour plus d'informations sur la création d'un mapping de ciblage, reportez-vous à cette section. 
-
Cliquez ensuite sur le bouton Ajouter pour sélectionner le type d'application.
-
Créez votre application Android. Pour plus d’informations, consultez cette section.
Création de l'application mobile Android creating-android-app
Après avoir créé votre service, vous devez maintenant créer votre application Android :
-
Dans le service que vous venez de créer, cliquez sur le bouton Ajouter pour choisir le type d'application.
-
Sélectionnez Créer une application Android et saisissez un libellé.
-
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. Pour plus d’informations, consultez cette section.
note note 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. -
Sélectionnez la version de l’API : HTTP v1 ou HTTP (hérité). Ces fonctions sont présentées en détails dans cette section
-
Renseignez les champs Firebase Cloud Messaging pour paramètres de connexion Android
-
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 :
Configurer la version d’API select-api-version
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. L’API HTTP (héritée) ne doit pas être sélectionnée, car elle a été abandonnée par Google.
Pour configurer la version d'API HTTP v1, procédez comme suit :
-
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.
-
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
-
Cliquez sur Tester la connexion pour vérifier que votre configuration est correcte et que le serveur marketing a accès au FCM.
note caution 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. 
-
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.
-
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 :
Étendre le schéma appsubscriptionRcp extend-subscription-schema
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 notamment pour la personnalisation. Pour cela :
-
Créez une extension du schéma Applications abonnées (nms:appSubscriptionRcp) et définissez les nouveaux champs. En savoir plus sur l’extension de schéma dans cette page
-
Définissez le mapping dans l'onglet Paramètres d'abonnement.
note caution 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. Consultez cette section.