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

REMARQUE

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 notification Android enrichie.

Configuration du compte externe 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 :

  1. Accédez à Administration > Plateforme > 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

    REMARQUE

    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 enfant (8 par défaut).

Configuration d'un service Android

Découvrez comment configurer un service Android en 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.

    REMARQUE

    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. Pour plus d'informations sur la création d'un mapping de ciblage, reportez-vous à cette section.

  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 de l'application mobile 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. Pour plus d'informations à ce sujet, consultez cette section.

    REMARQUE

    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é). Ces fonctions sont présentées en détails dans cette section

  5. Renseignez les champs Firebase Cloud Messaging pour paramètres de connexion Android

  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.

    ATTENTION

    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. En savoir plus sur l’extension de schéma dans cette page

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

    ATTENTION

    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.

Sur cette page