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.

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

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 respectivement Adobe Campaign 6.1.x ou Adobe Campaign Standard.

Création d’un formulaire

  1. Démarrez dans siteadmin.

  2. Parcourez l’arborescence jusqu’à atteindre l’emplacement où vous souhaitez créer le formulaire dans le site Web sélectionné.

  3. Sélectionnez Nouveau > Nouvelle page….

  4. Sélectionnez le modèle Profil Adobe Campaign (AC 6.1) ou Profil Adobe Campaign (ACS) et saisissez les propriétés de la page.

    REMARQUE

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

  5. Cliquez sur Créer pour créer le formulaire.

    chlimage_1-187

    Vous pouvez alors modifier et configurer le contenu de votre 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. Accédez au formulaire que vous souhaitez modifier.

  2. Dans la boîte à outils, sélectionnez Page > Propriétés de page… et accédez ensuite à l’onglet Services cloud de la fenêtre contextuelle.

  3. Ajoutez le service Adobe Campaign en cliquant sur Ajouter un service et en choisissant ensuite la configuration qui correspond à votre instance Adobe Campaign dans la liste déroulante du service. Cette configuration est effectuée lors de la configuration de la connexion entre les différentes instances. Pour plus d’informations, consultez Connexion d’AEM à Adobe Campaign.

    REMARQUE

    Le cas échéant, déverrouillez la configuration en cliquant sur l’icône en forme de cadenas pour pouvoir ajouter le service Adobe Campaign.

  4. Accédez aux paramètres généraux du formulaire à l’aide du bouton Modifier situé au début du formulaire. L’onglet Formulaire vous permet de choisir une page de remerciements vers laquelle l’utilisateur sera redirigé après avoir validé le formulaire.

    Le formulaire Avancé vous permet de choisir le type de formulaire. Le champ Options de publication vous donne le choix entre trois types de formulaires Adobe Campaign :

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

    Le champ Configuration de l’action vous permet de spécifier si vous voulez créer le profil cible dans la base de données Adobe Campaign, s’il n’existe pas encore. Pour ce faire, cochez l’option Créer un utilisateur s’il n’existe pas.

  5. Ajoutez les composants sélectionnés en les faisant glisser depuis la boîte à outils et en les déposant dans le formulaire. Pour plus d’informations sur les composants spécifiques à Adobe Campaign disponibles, voir Adobe de composants de formulaire.

    chlimage_1-188

  6. Configurez les champs ajoutés en cliquant deux fois dessus. L’onglet Adobe Campaign vous permet de lier le champ à un champ dans le tableau de destinataires Adobe Campaign. Vous pouvez également indiquer si le champ fait partie de la clé de réconciliation qui permet aux destinataires qui sont déjà présents dans la base de données Adobe Campaign d’être reconnus.

    ATTENTION

    Le Nom de l’élément doit être différent pour chaque champ de formulaire. Modifiez-le si nécessaire.

    Chaque formulaire doit contenir un composant Clé primaire chiffrée afin de gérer correctement les destinataires dans la base de données Adobe Campaign.

  7. Activez la page en choisissant Page > Activer la page dans la boîte à outils. La page est activée sur votre site. Vous pouvez l’afficher en accédant à votre instance de publication AEM. Les données de la base Adobe Campaign sont mises à jour une fois qu’un formulaire est validé.

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, vous utilisez la variable Identifiant de ressource principale (Adobe Campaign Standard) ou l’identifiant chiffré (Adobe Campaign 6.1) (par exemple, dans un composant Texte et personnalisation (Campaign)), qui est 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 6.11, 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