Configurer le canal de notification push push-notification-configuration

Pour envoyer des notifications push avec Adobe Campaign, vous devez d’abord configurer votre environnement et votre application, comme décrit sur cette page. Dans Adobe Campaign, le canal d’envoi des notifications push est le canal de l’application mobile.

CAUTION
Certaines modifications importantes apportées au service Android FCM (Firebase Cloud Messaging) seront publiées en 2024 et auront 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.

Avant de commencer à envoyer des notifications push avec Adobe Campaign, vous devez vous assurer que les configurations et les intégrations sont en place sur l’application mobile et pour les balises dans Adobe Experience Platform. Le SDK mobile Adobe Experience Platform fournit des API d’intégration côté client pour vos mobiles via les SDK compatibles Android et iOS.

Pour configurer votre application avec des SDK mobiles Adobe Experience Platform, procédez comme suit :

  1. Vérifiez les conditions préalables.
  2. Configurez une propriété de balise mobile dans la collecte de données Adobe Experience Platform.
  3. Obtenez le SDK mobile Adobe Experience Platform, comme expliqué sur cette page.
  4. (facultatif) Activez la journalisation et les mesures de cycle de vie, comme expliqué sur cette page.
  5. (facultatif) Ajoutez Adobe Experience Platform Assurance dans votre application to validate your implementation. Learn how to implement Adobe Experience Platform Assurance extension in this page.
  6. Configurez vos services mobiles iOS et Android dans Adobe Campaign, comme expliqué sur cette page.
  7. Installez et configurez l’extension Adobe Campaign dans votre propriété mobile.
  8. Suivez la documentation du SDK mobile Adobe Experience Platform pour obtenir une configuration avec les SDK mobiles Adobe Experience Platform dans votre application.

Conditions préalables before-starting

Configurer les autorisations setup-permissions

Avant de créer une application mobile, vous devez vous assurer que vous disposez ou attribuez des autorisations utilisateur/utilisatrice appropriées pour les balises dans Adobe Experience Platform. Les autorisations utilisateur/utilisatrice pour les balises dans Adobe Experience Platform sont attribuées aux utilisateurs et utilisatrices via Adobe Admin Console. Pour en savoir plus, consultez la documentation sur les balises.

CAUTION
La configuration des notifications push doit être effectuée par un utilisateur ou une utilisatrice expert(e). Selon votre modèle de mise en œuvre et les personnes impliquées dans celle-ci, vous devrez peut-être attribuer l’ensemble des autorisations à un profil de produit unique ou partager les autorisations entre le développeur/la développeuse de l’application et l’administrateur ou l’administratrice Adobe Campaign.

Pour attribuer des droits Propriété et Entreprise, procédez comme suit :

  1. Accédez à l’Admin Console.

  2. Dans l’onglet Produits, sélectionnez la vignette Collecte de données Adobe Experience Platform.

  3. Sélectionnez un Profil de produit ou créez-en un à l’aide du bouton Nouveau profil. Découvrez comment créer un Nouveau profil dans la documentation d’Admin Console.

  4. Dans l’onglet Autorisations, sélectionnez Droits de propriété.

  5. Cliquez sur Tout ajouter. Vous ajouterez ainsi les droits suivants à votre profil de produit :

    • Approuver
    • Développer
    • Modifier la propriété
    • Gérer les environnements
    • Gérer les extensions
    • Publier

    Ces autorisations sont requises pour installer et publier l’extension Adobe Campaign et publier la propriété de l’application dans le SDK mobile Adobe Experience Platform.

  6. Sélectionnez ensuite Droits d’entreprise dans le menu de gauche.

  7. Ajoutez les droits suivants :

    • Gérer les configurations d’application
    • Gérer les propriétés

    Ces autorisations sont requises pour que le développeur/la développeuse d’applications mobiles configure les informations d’identification des notifications push dans Collecte de données Adobe Experience Platform.

  8. Cliquez sur Enregistrer.

Pour affecter un Profil de produit aux utilisateurs et utilisatrices, procédez comme suit :

  1. Accédez à l’Admin Console.

  2. Dans l’onglet Produits, sélectionnez la vignette Collecte de données Adobe Experience Platform.

  3. Sélectionnez le profil de produit précédemment configuré.

  4. Dans l’onglet Utilisateurs, cliquez sur Ajouter un utilisateur.

  5. Saisissez le nom ou l’adresse e-mail de la personne, puis sélectionnez-la. Cliquez ensuite sur Enregistrer.

    note note
    NOTE
    Si la personne n’a pas été créée auparavant dans l’Admin Console, reportez-vous à la documentation Ajouter des utilisateurs.

Configurer votre application configure-app

La configuration technique implique une collaboration étroite entre le développeur/la développeuse de l’application et l’administrateur/l’administratrice de l’entreprise. Avant de commencer à envoyer des notifications push avec Adobe Campaign, vous devez définir les paramètres dans Adobe Experience Platform Data Collection et intégrer votre application mobile aux SDK mobiles Adobe Experience Platform.

Suivez les étapes de mise en œuvre présentées dans les liens ci-dessous :

  • Pour Apple iOS  : découvrez comment enregistrer votre application avec des APNs dans la documentation Apple.
  • Pour Google Android  : découvrez comment configurer une application cliente Firebase Cloud Messaging sur Android dans la documentation Google.

Configurer une propriété de balise mobile dans la collecte de données Adobe Experience Platform launch-property

La configuration d’une propriété mobile permet aux développeurs et développeuses d’applications mobiles ou aux spécialistes du marketing de configurer les SDK mobiles. En règle générale, vous créez une propriété mobile pour chaque application mobile que vous souhaitez gérer. Découvrez comment créer et configurer une propriété mobile dans la documentation du SDK mobile Adobe Experience Platform.

Pour en savoir plus sur les balises Adobe Experience Platform Data Collection, consultez la documentation Adobe Experience Platform.

Une fois créée, ouvrez la nouvelle propriété de balise et créez une bibliothèque. Pour cela :

  1. Accédez à Flux de publication dans le volet de navigation de gauche, puis sélectionnez Ajouter une bibliothèque.
  2. Saisissez le nom de la bibliothèque et sélectionnez l’environnement.
  3. Sélectionnez Ajouter toutes les ressources modifiées, puis Enregistrement et création en vue du développement.
  4. Enfin, définissez cette bibliothèque comme votre bibliothèque de travail en cliquant sur le bouton Sélectionner une bibliothèque de travail.

Configurer vos services mobiles dans Campaign push-service

Une fois votre application mobile configurée dans Adobe Experience Platform Data Collection, vous devez créer deux services (un pour les appareils iOS et un pour les appareils Android) pour pouvoir envoyer des notifications push depuis Adobe Campaign.

Les notifications push sont envoyées aux utilisateurs et utilisatrices de votre application par le biais d’un service dédié. Lorsque les utilisateurs et utilisatrices installent votre application, ils s’abonnent à ce service : Adobe Campaign s’appuie sur ce service pour cibler uniquement les abonné(e)s de votre application. Dans ce service, vous devez ajouter vos applications iOS et Android à envoyer sur les appareils iOS et Android.

Pour créer un service destiné à envoyer des notifications push, procédez comme suit :

  1. Accédez à l’onglet Profils et cibles > Services et abonnements, puis cliquez sur Créer.

    {width="800"}

  2. Saisissez un Libellé et un Nom interne, puis sélectionnez un type d’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 les mappings de ciblage, consultez cette page.
  3. Ensuite, utilisez l’icône Ajouter sur la droite pour définir les applications mobiles qui utilisent ce service.

iOS

Pour créer une application pour les appareils iOS, procédez comme suit :

  1. Sélectionnez Créer une application iOS, puis cliquez sur Suivant.

    {width="600"}

  2. Saisissez le nom de votre application dans le champ Libellé.

  3. (facultatif) Vous pouvez enrichir le contenu d’un 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, les variables mediaURl et mediaExt sont ajoutées pour créer une notification push enrichie et fournir à l’application l’image à afficher dans la notification.

    {width="600"}

  4. Accédez à l’onglet Paramètres d’abonnement pour définir le mapping avec une extension du schéma Applications abonnées (nms:appsubscriptionRcp).

  5. Accédez à l’onglet Sons pour définir 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.

  6. Cliquez sur Suivant pour passer à la configuration de l’application de développement.

  7. La clé d’intégration est spécifique à chaque application. Elle relie l’application mobile à Adobe Campaign.

    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 en savoir plus, consultez la documentation pour les développeurs et développeuses.

    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.
    Vous ne pouvez pas utiliser le même certificat pour la version de développement (sandbox) et la version de production de l’application.
  8. Sélectionnez l’icône dans le champ Icône de l’application pour personnaliser l’application mobile dans votre service.

  9. Sélectionnez le mode d'authentification. Deux modes sont disponibles :

    • (Recommandé) Authentification basée sur les jetons  : renseignez les paramètres de connexion APNs Identifiant de la clé, Identifiant de l'équipe et Identifiant de paquet, puis sélectionnez votre certificat p8 en cliquant sur Renseigner la clé privée…. Pour plus d'informations sur l'authentification basée sur les jetons, reportez-vous à la documentation Apple.

    • Authentification basée sur les certificats  : cliquez sur Renseigner le certificat…, sélectionnez votre clé p12 et saisissez le mot de passe fourni par l’équipe de développement d’applications mobiles. Notez que ce certificat est fourni avec une date d’expiration et doit être renouvelé tous les ans. Pour éviter toute interruption de service pour vos utilisateurs et utilisatrices, mettez à jour vos certificats avant qu’ils n’expirent. Les certificats sont valides pendant un an. Vous devez les mettre à jour pour continuer à communiquer avec les APN.

  10. Utilisez le bouton Tester la connexion pour valider votre configuration.

  11. Cliquez sur Suivant pour passer à la configuration de l’application de production et procédez comme décrit ci-dessus.

  12. Cliquez sur Terminer.

Votre application iOS est maintenant prête à être utilisée dans Campaign.

Android

Pour créer une application pour les appareils Android, procédez comme suit :

  1. Sélectionnez Créer une application Android, puis cliquez sur Suivant.

    {width="600"}

  2. Saisissez le nom de votre application dans le champ Libellé.

  3. La clé d’intégration est spécifique à chaque application. Elle relie l’application mobile à Adobe Campaign.

    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 en savoir plus, consultez la documentation pour les développeurs et développeuses.

    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 l’icône dans le champ Icône de l’application pour personnaliser l’application mobile dans votre service.

  5. Sélectionnez HTTP v1 dans la liste déroulante Version de l’API.

  6. Cliquez sur le lien Charger le fichier JSON du projet pour extraire les détails du projet… pour charger votre fichier de clé JSON. Pour plus d’informations sur l’extraction de votre fichier JSON, consultez la documentation sur Firebase de Google.

    Vous pouvez également saisir manuellement les informations suivantes :

    • Identifiant du projet
    • Clé privée
    • Email client
  7. Utilisez le bouton Tester la connexion pour valider votre configuration.

    note caution
    CAUTION
    Le bouton Tester la connexion ne vérifie pas si le serveur MID a accès au serveur FCM.
  8. (facultatif) Vous pouvez, si nécessaire, enrichir le contenu d'un message push avec certaines variables d’application. Elles sont entièrement personnalisables et font partie de la payload du message envoyé à l'appareil mobile.

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

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

table 0-row-3 1-row-3 2-row-3 1-align-center 2-align-center 3-align-center 5-align-center 6-align-center 7-align-center 9-align-center 10-align-center 11-align-center
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

Configurer l’extension Adobe Campaign dans votre propriété mobile configure-extension

L’Extension Adobe Campaign Classic pour les SDK mobiles Adobe Experience Platform alimente les notifications push de vos applications mobiles. Elle vous aide à collecter des jetons push utilisateur et à gérer la mesure des interactions avec les services Adobe Experience Platform.

Cette extension, qui s’applique à la fois à Campaign Classic v7 et Campaign v8, est préinstallée sur votre environnement et doit être configurée. Pour configurer l’extension de votre propriété de balise mobile, procédez comme suit :

  1. Ouvrez la propriété de balise que vous avez créée précédemment.
  2. Dans le volet de navigation de gauche, accédez à Extensions, puis ouvrez l’onglet Catalogue. Utilisez le champ de recherche pour rechercher l’extension Adobe Campaign Classic.
  3. Dans la vignette Campaign Classic, cliquez sur le bouton Installer.
  4. Saisissez les paramètres comme décrit dans la documentation du SDK mobile Adobe Experience Platform.

Vous pouvez maintenant ajouter Campaign à votre application, comme indiqué dans la documentation du SDK mobile Adobe Experience Platform.

recommendation-more-help
35662671-8e3d-4f04-a092-029a056c566b