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 :

  1. Rendre un modèle disponible.
  2. Créer 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
  • 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.

To do this, see the Templates documentation.

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.

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

  2. Create a page and select Adobe Campaign Classic Profile or Adobe Campaign Standard Profile and click Next.

    chlimage_1-43

    Remarque

    If the desired template is not available, see Template Availability.

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

  4. Saisissez un titre dans le champ Titre, puis cliquez sur Créer.

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

    chlimage_1-44

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

If the desired template is not available, see Making a template available.

Cette section présente uniquement les liens spécifiques à Adobe Campaign. For more information on a more general overview of how to use forms in Adobe Experience Manager, see Editmode components.

  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. On the page, in the Form Start component, click the Configuration icon.

    chlimage_1-46

  3. Click the Advanced tab and select the type of form it is - Subscribe, Unsubscribe, or Save Profile and click 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.
  4. 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.

  5. Drag the component Encrypted Primary Key to the form (anywhere) and click or tap the Configuration icon. 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.

    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 afficher le composant. For example, in Text Field (Campaign) component, change the title and text.

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

    chlimage_1-48

    Remarque

    You can add/remove fields that are displayed in the recipient table by following the instructions here: 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 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

You must have an Encryted Primary Key component on each form. 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.

To create that link, you use the variable Main resource identifier(Adobe Campaign Standard) or Encrypted identifier (Adobe Campaign Classic) (for example, in a Text & Personalization (Campaign) component), which links to the epk in Adobe Campaign.

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

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

    • In Adobe Campaign Standard - Navigate to Profiles and Audiences > Profiles, which lists the existing profiles. Make sure the table displays the Main Resource Identifier field in a column (This can be configured by clicking/tapping Configure list). Copiez l’identifiant de ressource principale du profil souhaité.
    • In Adobe Campaign Classic, go to Profiles and Targets > Recipients, which lists the existing profiles. Make sure the table displays the Encrypted identifier field in a column (This can be configured by right-clicking on an entry and selecting Configure list…). Copiez l’identifiant chiffré du profil souhaité.
  2. In AEM, open the form page on the publish instance and append the EPK from step 1 as a URL parameter: use the same name that you previously defined in the EPK component when authoring the form (for example: ?epk=...)

  3. 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é.

Sur cette page