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 également gérer les nouveaux abonnements des 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 des formulaires Adobe Campaign dans AEM, suivez les étapes décrites dans ce document :

Rendre un modèle disponible.
Créer un formulaire.
Modifier le contenu du formulaire.

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

Enregistrement d’un profil
Abonnement à un service
Désabonnement d’un service

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

Même si vous créez ces formulaires individuellement, dans un cas d’utilisation standard, vous générez un lien personnalisé sur une page de formulaire à l’intérieur du contenu de la newsletter, afin que les destinataires puissent ouvrir le lien et modifier les données de leur profil (qu’il s’agisse pour eux de se désabonner, de s’abonner ou de mettre à jour leur profil).

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

Rendre un modèle disponible

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, reportez-vous à la section Documentation sur les modèles.

Création d’un formulaire

Tout d’abord, vérifiez la connexion entre les instances de création et de publication et assurez-vous qu’Adobe Campaign est en cours d’exécution. 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.

Dans AEM, dans Sites, naviguez jusqu’à l’emplacement où vous souhaitez créer une page.
Créez une page et sélectionnez Profil Adobe Campaign Classic ou Profil Adobe Campaign Standard et cliquez sur Suivant.

REMARQUE

Si le modèle souhaité n’est pas disponible, voir Disponibilité des modèles.
Dans le champ Nom, ajoutez le nom de la page. Il doit s’agir d’un nom JCR valide.
Saisissez un titre dans le champ Titre, puis cliquez sur Créer.
Ouvrez la page, puis choisissez Ouvrir les propriétés, ajoutez ensuite la configuration Adobe Campaign aux services cloud et cliquez sur la coche pour enregistrer vos modifications.
Sur la page, dans le composant Début du formulaire, choisissez le type du formulaire en question : 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

Les formulaires dédiés à Adobe Campaign présentent des composants spécifiques. Ces composants disposent d’une option pour vous permettre de lier chaque champ du formulaire à un champ dans la base de données Adobe Campaign.

REMARQUE

Si le modèle souhaité n’est pas disponible, voir Mettre un modèle à disposition.

Cette section présente uniquement les liens spécifiques à Adobe Campaign. Pour plus d’informations sur une présentation plus générale de l’utilisation des formulaires dans Adobe Experience Manager, voir Composants du mode d’édition.

Sélectionnez Ouvrir les propriétés, ajoutez la configuration Adobe Campaign aux services cloud et cliquez sur la coche pour enregistrer vos modifications.
Sur la page , dans la variable Début du formulaire , cliquez sur l’icône Configuration .
Cliquez sur le bouton Avancé et sélectionnez 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 : vous permet de créer ou de mettre à jour un destinataire dans Adobe Campaign (valeur par défaut).
- Adobe Campaign : s’abonner aux services : vous permet de gérer les abonnements d’un destinataire dans Adobe Campaign.
- Adobe Campaign : se désabonner des services : vous permet d’annuler les abonnements d’un destinataire dans Adobe Campaign.
Vous devez disposer d’un composant Clé primaire chiffrée sur chaque formulaire. Ce composant définit le paramètre d’URL utilisé pour accepter la clé primaire chiffrée d’un profil Adobe Campaign. Dans Composants, sélectionnez Adobe Campaign afin que seuls ces composants soient visibles.
Faire glisser le composant Clé Principal cryptée dans le formulaire (n’importe où), puis cliquez ou appuyez sur Configuration icône . Dans l’onglet Adobe Campaign, spécifiez un nom pour le 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 affecter la clé primaire chiffrée d’un profil Adobe Campaign. La clé primaire chiffrée doit présenter un format URL correct.
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.
Cliquez sur l’icône Configuration pour afficher le composant. Par exemple, dans Champ de texte (Campaign) , modifiez le titre et le texte.

Cliquez sur Adobe Campaign pour mapper le champ de formulaire à une variable de métadonnées Adobe Campaign. Lors de l’envoi du formulaire, le champ mappé est mis à jour dans Adobe Campaign. Seuls les champs contenant des types correspondants sont disponibles dans le sélecteur de variables (par exemple, des variables de chaîne pour les champs de texte).

REMARQUE

Vous pouvez ajouter/supprimer les champs affichés dans la table des destinataires en suivant les instructions ici : https://blogs.adobe.com/experiencedelivers/experience-management/aem-campaign-integration/
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 aussi tester un formulaire.

ATTENTION

Vous devez accorder les autorisations de lecture à l’utilisateur anonyme sur le service cloud pour utiliser des formulaires sur l’instance de publication. Tenez toutefois compte des potentiels problèmes de sécurité liés au fait d’accorder les autorisations de lecture à un utilisateur anonyme et assurez-vous d’atténuer les risques associés, par exemple, en configurant le dispatcher.

Test d’un formulaire

Une fois que vous avez créé un formulaire et modifié son contenu, il est conseillé de tester manuellement que le formulaire fonctionne comme prévu.

REMARQUE

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

Même si dans cette procédure vous saisissez le numéro d’EPK manuellement, dans la pratique, les utilisateurs recevront un lien vers cette page (pour se désabonner, s’abonner ou mettre à jour leur profil) dans une newsletter. En fonction de l’utilisateur, l’EPK est mis à jour automatiquement.

Pour créer ce lien, vous utilisez la variable Identifiant de ressource principale(Adobe Campaign Standard) ou Identifiant crypté (Adobe Campaign Classic) (par exemple, dans une Texte et personnalisation (Campaign) ), qui pointe vers le fichier epk dans Adobe Campaign.

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

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 affiche la variable Identifiant de ressource principal dans une colonne (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, qui répertorie les profils existants. Assurez-vous que le tableau affiche la variable Identifiant crypté dans une colonne (Cette option peut être configurée en cliquant avec le bouton droit de la souris sur une entrée et en sélectionnant Configurer la liste…). Copiez l’identifiant chiffré du profil souhaité.
Dans AEM, ouvrez la page de 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 EPK lors de la création du formulaire (par exemple : ?epk=...)
Le formulaire peut maintenant être utilisé pour modifier les données et les abonnements associés au profil Adobe Campaign lié. Après avoir modifié certains champs et envoyé le formulaire, vous pouvez vérifier dans Adobe Campaign que les données ont été mises à jour.