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

IMPORTANT
Certaines modifications importantes apportées au service Android FCM (Firebase Cloud Messaging) seront publiées en 2024 et pourront avoir une incidence sur votre mise en œuvre d’Adobe Campaign. Il se peut que la configuration de vos services d’abonnement pour les notifications push Android doive être mise à jour pour prendre en charge cette modification. Vous pouvez déjà vérifier et agir. En savoir plus dans cette note technique d’Adobe Campaign v8.

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 :

  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

    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.

  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 configuring-android-service

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.

    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.

  4. Cliquez ensuite sur le bouton Ajouter pour sélectionner le type d'application.

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

  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.

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

Configurer la version d’API select-api-version

IMPORTANT
Certaines modifications importantes apportées au service Android FCM (Firebase Cloud Messaging) seront publiées en 2024 et pourront avoir une incidence sur votre mise en œuvre d’Adobe Campaign. Dans le cadre des efforts constants de Google pour améliorer ses services, les API FCM héritées seront abandonnées le 20 juin 2024. En savoir plus dans la note technique d’Adobe Campaign v8.

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 :

  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.

    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.

  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

Étendre le schéma appsubscriptionRcp extend-subscription-schema

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 notamment pour la personnalisation. 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.

    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.
recommendation-more-help
601d79c3-e613-4db3-889a-ae959cd9e3e1