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 :
Trois types de formulaires, spécifiques à Adobe Campaign, sont disponibles par défaut :
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.
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.
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.
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.
Si le modèle désiré n’est pas disponible, consultez 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.
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.
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.
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 le composant Début du formulaire, cliquez sur l’icône Configuration.
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.
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.
Faites glisser le composant Clé primaire chiffrée sur le formulaire (n’importe où) et cliquez ou appuyez sur l’icône Configuration. 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 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. 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).
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/
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.
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.
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.
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.
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, 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 et ensuite l’ajouter à l’URL :
Pour obtenir la clé primaire chiffrée (EPK) d’un profil Adobe Campaign :
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=...
).
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.
Les données de la base de données Adobe Campaign sont mises à jour une fois qu’un formulaire est validé.