Création de formulaires Adobe Campaign dans AEM

AEM vous permet de créer et d’utiliser des formulaires qui interagissent avec Adobe Campaign sur votre site web. Vous pouvez insérer des champs spécifiques dans vos formulaires et les mapper à la base de données Adobe Campaign.

Vous pouvez gérer les nouveaux abonnements aux contacts, les désabonnements et les données de profil utilisateur, tout en intégrant leurs données dans votre base de données Adobe Campaign.

Pour utiliser Adobe Campaign forms dans AEM, procédez comme suit, comme décrit dans ce document :

  1. Rendez un modèle disponible.
  2. Créez un formulaire.
  3. Modifier le contenu du formulaire.

Trois types de formulaires, spécifiques à Adobe Campaign, sont disponibles par défaut :

  • Enregistrement d’un profil
  • Abonner à un service
  • Se désabonner d’un service

Ces formulaires définissent un paramètre d’URL qui accepte la clé Principale chiffrée d’un profil Adobe Campaign. En fonction de ce paramètre d’URL, le formulaire met à jour les données du profil Adobe Campaign associé.

Bien que vous créiez ces formulaires indépendamment, dans un cas d’utilisation classique, vous générez un lien personnalisé vers une page de formulaire dans le contenu de la newsletter, de sorte que les destinataires puissent ouvrir le lien et ajuster les données de leur profil (désinscription, inscription ou mise à jour de leur profil).

Le formulaire est automatiquement mis à jour en fonction de l’utilisateur. Voir Modification du contenu d’un formulaire pour plus d’informations.

Mise à disposition d’un modèle

Avant de pouvoir créer des formulaires spécifiques à Adobe Campaign, vous devez rendre les différents modèles disponibles dans votre application AEM.

Pour ce faire, consultez la Documentation relative aux modèles.

Création d’un formulaire

Tout d’abord, vérifiez la connexion entre les instances d’auteur et de publication et Adobe Campaign fonctionne. Voir Intégration à Adobe Campaign Standard ou Intégration à Adobe Campaign Classic.

REMARQUE

Vérifiez que la propriété acMapping sur le nœud jcr:content de la page est définie sur mapRecipient ou profile, lorsque vous utilisez Adobe Campaign Classic ou Adobe Campaign Standard, respectivement.

  1. Dans AEM, dans Sites, naviguez jusqu’à l’emplacement où vous souhaitez créer une page.

  2. Créez une page et sélectionnez Profil Adobe Campaign Classic ou Profil Adobe Campaign Standard et cliquez sur Suivant.

    chlimage_1-43

    REMARQUE

    Si le modèle désiré n’est pas disponible, consultez Disponibilité des modèles.

  3. Dans le Nom , ajoutez le nom de la page. Il doit s’agir d’un nom JCR valide.

  4. Dans le Titre , saisissez un titre, puis cliquez sur Créer.

  5. Ouvrez la page et sélectionnez Ouvrir les propriétés et dans les Cloud Services, ajoutez la configuration Adobe Campaign et sélectionnez la coche pour enregistrer vos modifications.

    chlimage_1-44

  6. Sur la page , dans la variable Début du formulaire , sélectionnez le type de formulaire : S’abonner, se désabonner, ou Enregistrer le profil. Vous pouvez uniquement disposer d’un type par formulaire. Vous pouvez désormais modifier le contenu du formulaire.

Modification du contenu d’un formulaire

Forms dédié à Adobe Campaign comporte des composants spécifiques. Ces composants disposent d’une option permettant de lier chaque champ du formulaire à un champ de la base de données Adobe Campaign.

REMARQUE

Si le modèle désiré n’est pas disponible, consultez Rendre un modèle disponible.

Cette section présente uniquement les liens spécifiques à Adobe Campaign. Pour plus d’informations sur l’utilisation des formulaires dans Adobe Experience Manager, consultez Composants en mode création.

  1. Sélectionnez Ouvrir les propriétés, ajoutez la configuration Adobe Campaign aux services cloud et cliquez sur la coche pour enregistrer vos modifications.

    chlimage_1-45

  2. Sur la page, dans le composant Début du formulaire, cliquez sur l’icône Configuration.

    chlimage_1-46

  3. Cliquez sur l’onglet Avancé et choisissez le type de formulaire S’abonner, Se désabonner ou Enregistrer le profil et cliquez sur OK. Vous pouvez uniquement disposer d’un type par formulaire.

    • Adobe Campaign : Enregistrer le profil: permet de créer ou mettre à jour un destinataire dans Adobe Campaign (valeur par défaut).
    • Adobe Campaign : Abonnement aux services: permet de gérer les abonnements d'un destinataire dans Adobe Campaign.
    • Adobe Campaign : Désabonnement des services: permet d'annuler les abonnements d'un destinataire dans Adobe Campaign.
  4. Vous devez disposer d’un Clé Principal cryptée sur chaque formulaire. Ce composant définit le paramètre d’URL qui sera utilisé pour accepter la clé Principale chiffrée d’un profil Adobe Campaign. Dans Composants, sélectionnez Adobe Campaign afin que seuls ces composants soient visibles.

  5. Faites glisser le composant Clé primaire chiffrée sur le formulaire (n’importe où) et cliquez ou appuyez sur l’icône Configuration. Dans le Adobe Campaign , indiquez le nom du paramètre d’URL. Cliquez ou appuyez sur la coche pour enregistrer vos modifications.

    Les liens générés vers ce formulaire doivent utiliser ce paramètre d'URL et lui attribuer la clé Principale cryptée d'un profil Adobe Campaign. La clé Principale cryptée doit être correctement encodée en URL (pourcentage).

    chlimage_1-47

  6. Ajoutez au formulaire autant de composants que vous le souhaitez, tels qu’un champ de texte, un champ de date, un champ de case à cocher, un champ d’option, etc. Voir Composants de formulaire Adobe Campaign pour plus d’informations sur chaque composant.

  7. Cliquez sur l’icône Configuration pour ouvrir le composant. Par exemple, dans le composant Champ de texte (Campaign), changez le titre et le texte.

    Cliquez sur Adobe Campaign pour mapper le champ de formulaire à une variable de métadonnées Adobe Campaign. Lorsque vous envoyez le formulaire, le champ mappé est mis à jour dans Adobe Campaign. Seuls les champs avec les types correspondants sont disponibles dans le sélecteur de variables (par exemple, les variables de chaîne pour les champs de texte).

    chlimage_1-48

    REMARQUE

    Vous pouvez ajouter ou supprimer des champs qui sont affichés dans le tableau Destinataire en suivant les instructions ici :https://blogs.adobe.com/experiencedelivers/experience-management/aem-campaign-integration/

  8. Cliquez sur Publier la page. La page est activée sur votre site. Vous pouvez l’afficher en accédant à votre instance de publication AEM. Vous pouvez également test d’un formulaire.

    ATTENTION

    Vous devez fournir des autorisations de lecture à l’utilisateur anonyme sur le service cloud pour utiliser les formulaires à la publication. Sachez toutefois les problèmes de sécurité potentiels liés à l’octroi d’autorisations de lecture à l’utilisateur anonyme et assurez-vous de les atténuer, par exemple en configurant le Dispatcher.

Test d’un formulaire

Après avoir créé un formulaire et en avoir modifié le contenu, vous pouvez tester manuellement que le formulaire fonctionne comme prévu.

REMARQUE

Vous devez disposer d’un composant Clé primaire chiffrée (EPK) sur chaque formulaire. Dans Composants, sélectionnez Adobe Campaign afin que seuls ces composants soient visibles.

Bien que dans cette procédure, vous saisissiez manuellement le numéro epk, en pratique, les utilisateurs reçoivent un lien vers cette page (qu’il s’agisse de se désabonner, de s’abonner ou de mettre à jour votre profil) dans une newsletter. En fonction de l’utilisateur, le fichier epk se met automatiquement à jour.

Pour créer ce lien, utilisez la variable Identifiant de ressource principale (Adobe Campaign Standard) ou l’identifiant chiffré (Adobe Campaign Classic) (par exemple, dans un composant Texte et personnalisation (Campaign)), lié à l’EPK dans Adobe Campaign.

Pour ce faire, vous devez obtenir manuellement l’EPK d’un profil Adobe Campaign, puis l’ajouter à l’URL :

  1. Pour obtenir la clé primaire chiffrée (EPK) d’un profil Adobe Campaign :

    • Dans Adobe Campaign Standard, accédez à Profils et audiences > Profils, qui répertorie les profils existants. Assurez-vous que le tableau contient le champ Identifiant de ressource principale dans l’une de ses colonnes (cela peut être configuré en cliquant/appuyant sur Configurer la liste). Copiez l’identifiant de ressource principale du profil souhaité.
    • Dans Adobe Campaign Classic, accédez à Profils et cibles > Destinataires où les profils existants sont répertoriés. Assurez-vous que le tableau contient le champ Identifiant chiffré dans l’une de ses colonnes (cela peut être configuré en cliquant avec le bouton droit sur une entrée et en choisissant Configurer la liste…). Copiez l’identifiant chiffré du profil souhaité.
  2. Dans AEM, ouvrez la page du formulaire sur l’instance de publication et ajoutez l’EPK de l’étape 1 comme paramètre d’URL. Utilisez le même nom que celui précédemment défini dans le composant lors de la création du formulaire (par exemple, ?epk=...).

  3. Le formulaire peut maintenant être utilisé pour modifier les données et abonnements associés au profil Adobe Campaign associé. Après avoir modifié certains champs et envoyé le formulaire, vous pouvez vérifier dans Adobe Campaign que les données appropriées ont été mises à jour.

Les données de la base Adobe Campaign sont mises à jour une fois qu’un formulaire est validé.

Sur cette page