Intégration à Adobe Campaign Classic

Adobe Campaign permet de gérer le contenu et les formulaires d’envoi de courrier électronique directement dans Adobe Experience Manager.

Pour utiliser les deux solutions conjointement et simultanément, vous devez d’abord les configurer de manière à les connecter l’une à l’autre. Cela implique certaines étapes de configuration à la fois dans Adobe Campaign et dans Adobe Experience Manager, qui sont décrites en détail dans ce document.

L’utilisation d’Adobe Campaign dans AEM comprend la possibilité d’envoyer un courrier électronique par le biais d’Adobe Campaign. Cette possibilité est décrite dans la section Utilisation d’Adobe Campaign. Cela inclut également l’utilisation de formulaires dans des pages AEM pour manipuler des données.

En outre, les rubriques suivantes peuvent être utiles lors de l’intégration d’AEM avec Adobe Campaign :

• Meilleures pratiques des modèles de courrier électronique
• Résolution des incidents liés à votre intégration Adobe Campaign

Si vous étendez votre intégration à Adobe Campaign, vous pouvez consulter les pages suivantes :

• Création d’extensions personnalisées
• Création de mappages de formulaires personnalisés

Processus d’intégration d’AEM et d’Adobe Campaign

Cette section décrit un processus de production type entre AEM et Adobe Campaign lors de la création de campagnes et de la diffusion de contenu.

Le processus type, décrit en détail ci-dessous, implique les conditions suivantes :

1. Commencez à créer votre campagne (à la fois dans Adobe Campaign et dans AEM).
2. Avant de lier le contenu et la diffusion, personnalisez le contenu dans AEM et créez une diffusion dans Adobe Campaign.
3. Liez le contenu et la diffusion dans Adobe Campaign.

Commencez à créer votre campagne

Vous commencez à créer une campagne à tout moment. Avant la liaison du contenu, AEM et Adobe Campaign sont indépendants. Cela signifie que les spécialistes du marketing peuvent commencer à créer leurs campagnes et leur ciblage dans Adobe Campaign, tandis que les créateurs de contenu travaillent sur la création dans AEM.

Avant de lier le contenu et la diffusion

Avant de lier le contenu et de créer un mécanisme de diffusion, vous devez effectuer les opérations suivantes :

Dans AEM

• À l’aide des champs de personnalisation du composant Texte et personnalisation, personnalisez ce qui doit l’être.

Dans Adobe Campaign

• Créez un type de diffusion aemContent.

Liaison du contenu et définition de la diffusion

Après avoir préparé le contenu pour la liaison et la diffusion, vous déterminez exactement comment lier le contenu et à quel emplacement.

Toutes ces étapes sont effectuées dans Adobe Campaign.

1. Spécifiez l’instance AEM à utiliser.
2. Synchronisez le contenu en cliquant sur le bouton Synchroniser.
3. Ouvrez le sélecteur de contenu pour sélectionner le contenu.

Si vous êtes un utilisateur novice d’AEM

Si vous êtes un utilisateur novice d’AEM, vous trouverez les liens ci-dessous utiles pour comprendre pleinement AEM :

• Démarrage d’AEM
• Compréhension des agents de réplication
• Recherche et utilisation des fichiers journaux
• Introduction à la plateforme AEM

Configuration d’Adobe Campaign

La configuration d’Adobe Campaign implique les tâches suivantes :

1. Installation du module d’intégration AEM dans Adobe Campaign
2. Configuration d’un compte externe
3. Vérification de la configuration appropriée d’AEMResourceTypeFilter

Vous pouvez également effectuer des configurations avancées :

• Gestion des blocs de contenu
• Gestion des champs de personnalisation

Voir Configurations avancées.

Prérequis

Au préalable, assurez-vous de disposer des éléments suivants :

• Une instance de création AEM
• Une instance de publication AEM
• Une instance Adobe Campaign Classic - y compris un client et un serveur
• Internet Explorer 11

Installation du module d’intégration AEM

Vous devez installer le Intégration AEM dans Adobe Campaign. Pour ce faire :

1. Accédez à l’instance Adobe Campaign à lier à AEM.

2. Sélectionner Outils > Avancé > Importer un package….

   

3. Cliquez sur Installer un package standard, puis sélectionnez la variable Intégration AEM module.

   

4. Cliquez sur Suivant, puis Début.

   Ce module contient la variable aemserver qui sera utilisé pour connecter le serveur AEM à Adobe Campaign.

   ATTENTION

   Par défaut, aucune zone de sécurité n’est configurée pour cet opérateur. Pour vous connecter à Adobe Campaign le biais d’AEM, vous devez en sélectionner une.

   Dans le serverConf.xml , allowUserPassword de la zone de sécurité sélectionnée doit être défini sur true pour autoriser AEM à se connecter à Adobe Campaign par login/mot de passe.

   Il est vivement recommandé de créer une zone de sécurité dédiée à AEM afin d’éviter tout problème de sécurité. Voir à ce sujet la section Guide d’installation.

   

Configuration d’un compte externe AEM

Vous devez configurer un compte externe permettant de connecter Adobe Campaign à votre instance AEM.

Pour configurer un compte externe AEM :

1. Accédez au Administration > Plateforme > Comptes externes noeud .

2. Créez un compte externe et sélectionnez l’option AEM type.

3. Saisissez les paramètres d’accès pour votre instance de création AEM : l’adresse du serveur, ainsi que l’ID et le mot de passe utilisés pour la connexion à cette instance. Le mot de passe du compte de l’utilisateur de l’API Campaign est identique à celui de l’utilisateur à distance d’Adobe Campaign pour lequel vous définissez un mot de passe dans AEM.

   REMARQUE

   Assurez-vous que l’adresse du serveur ne se termine pas par une barre oblique. Par exemple, saisissez https://yourserver:4502 au lieu de https://yourserver:4502/

   

4. Assurez-vous que la variable Activé est sélectionnée.

Vérification de l’option AEMResourceTypeFilter

Le AEMResourceTypeFilter sert à filtrer les types de ressources AEM pouvant être utilisés dans Adobe Campaign. Cela permet à Adobe Campaign de récupérer le contenu AEM conçu spécifiquement pour n’être utilisé que dans Adobe Campaign.

Cette option devrait être préconfigurée. Cependant, si vous la modifiez, l’intégration risque de ne pas fonctionner.

Pour vérifier que l’option AEMResourceTypeFilter est configurée :

1. Sélectionnez Plateforme >Options.

2. Dans le AEMResourceTypeFilter , vérifiez que les chemins sont corrects. Ce champ doit contenir la valeur :

   mcm/campaign/components/newsletter,mcm/campaign/components/campaign_newsletterpage,mcm/neolane/components/newsletter

   Ou, dans certains cas, la valeur est la suivante :

   mcm/campaign/components/newsletter

   

Configuration d’Adobe Experience Manager

Pour configurer AEM, vous devez procéder comme suit :

• Configurez la réplication entre les instances.
• Connectez AEM à Adobe Campaign via des services cloud.
• Configurez l’externaliseur.

Configuration de la réplication entre les instances AEM

Le contenu créé à partir de l’instance de création AEM est d’abord envoyé à l’instance de publication. Vous devez effectuer la publication de sorte que les images de la newsletter soient disponibles dans l’instance de publication et pour ses destinataires. L’agent de réplication doit donc être configuré pour répliquer à partir de l’instance de création AEM vers l’instance de publication AEM.

Cette étape est également nécessaire pour répliquer certaines configurations d’instance de création dans l’instance de publication.

Pour configurer la réplication entre les instances AEM :

1. Dans l’instance de création, sélectionnez Logo AEM> Outils icon > Déploiement > Réplication > Agents sur l’auteur, puis cliquez sur Agent par défaut.

   

   REMARQUE

   Évitez d’utiliser l’hôte local localhost (il s’agit d’une copie locale d’AEM) lors de la configuration de votre intégration avec Adobe Campaign, à moins que les instances de publication et de création se trouvent toutes deux sur le même ordinateur.

2. Appuyez ou cliquez sur Modifier sélectionnez ensuite le Transport .

3. Configurez l’URI en remplaçant localhost par l’adresse IP ou l’adresse de l’instance de publication AEM.

   

Connexion d’AEM à Adobe Campaign

Avant que vous puissiez utiliser AEM et Adobe Campaign ensemble, vous devez établir la liaison entre les deux solutions afin qu’elles puissent communiquer.

1. Connectez-vous à votre instance de création AEM.

2. Sélectionner Logo AEM > Outils icon > Déploiement > Cloud Services, puis Configurer maintenant dans la section Adobe Campaign .

   

3. Créez une configuration en saisissant une Titre et cliquez sur Créer ou sélectionnez la configuration existante à lier à votre instance Adobe Campaign.

4. Modifiez la configuration afin qu’elle corresponde aux paramètres de votre instance Adobe Campaign.

   • Nom d’utilisateur: aemserver, l’opérateur de package Intégration Adobe Campaign AEM utilisé pour établir le lien entre les deux solutions.
   • Mot de passe : mot de passe de l’opérateur aemserver Adobe Campaign. Vous devrez peut-être respécifier le mot de passe pour cet opérateur directement dans Adobe Campaign.
   • Point de terminaison de l’API : URL de l’instance Adobe Campaign.

5. Sélectionner Connexion à Adobe Campaign et cliquez sur OK.

   

   REMARQUE

   Après avoir créé et publié votre courrier électronique, vous devez republier la configuration sur votre instance de publication.

   

Configuration de l’externaliseur

Vous devez configurer l’externaliseur dans AEM sur votre instance de création. L’externaliseur est un service OSGi qui vous permet de transformer un chemin de ressources en une URL absolue externe. Ce service propose un emplacement centralisé pour configurer ces adresses URL externes et les créer.

Pour des instructions générales, voir Configuration de l’externaliseur. Pour l’intégration d’Adobe Campaign, assurez-vous de configurer le serveur de publication à l’adresse https://<host>:<port>/system/console/configMgr/com.day.cq.commons.impl.ExternalizerImplne pointe pas vers localhost:4503 mais à un serveur accessible par la console Adobe Campaign.

S’il pointe vers localhost:4503 ou un autre serveur auquel Adobe Campaign ne parvient pas à se connecter, les images ne s’affichent pas dans la console Adobe Campaign.

Configurations avancées

Vous pouvez également effectuer des configurations avancées, à savoir :

• Gérez les champs et les blocs de personnalisation.
• Désactivez un bloc de personnalisation.
• Gérez les données d’extension cible.

Gestion des champs et des blocs de personnalisation

Les champs et les blocs disponibles pour ajouter une personnalisation au contenu de vos courriers électroniques dans AEM sont gérés par Adobe Campaign.

Une liste par défaut est fournie, mais peut être modifiée. Vous pouvez également ajouter ou masquer des champs et des blocs de personnalisation.

Ajout d’un champ de personnalisation

Pour ajouter un nouveau champ de personnalisation à ceux déjà disponibles, vous devez étendre Adobe Campaign. nms:seedMember schéma comme suit :

1. Accédez au Administration > Configuration > Schémas de données dans la navigation Adobe Campaign.

2. Sélectionner Nouveau.

   

3. Dans la fenêtre contextuelle, sélectionnez Étendre les données du tableau à l’aide d’un schéma d’extension et cliquez sur Suivant.

   

4. Saisissez les différents paramètres du schéma étendu :

   • Schéma: sélectionnez la variable nms:seedMember schéma. Les autres champs de la fenêtre sont renseignés automatiquement.
   • Espace de noms : personnalisez l’espace de noms du schéma étendu.

5. Modifiez le code XML du schéma pour spécifier le champ que vous souhaitez ajouter. Pour plus d’informations sur l’extension de schémas dans Adobe Campaign, reportez-vous à la section Guide de configuration.

6. Enregistrez votre schéma puis mettez à jour la structure de la base Adobe Campaign via le Outils > Avancé > Mettre à jour la structure de la base de données dans la console.

7. Déconnectez-vous de la console Adobe Campaign, puis reconnectez-vous-y pour enregistrer vos modifications. Le nouveau champ figure maintenant dans la liste des champs de personnalisation disponibles dans AEM.

Exemple

Pour ajouter une Numéro d’enregistrement , vous devez disposer des éléments suivants :

• Le nms:recipient extension de schéma nommée cus:recipient contient :

<element desc="Recipient table (profiles)" img="nms:recipient.png" label="Recipients" labelSingular="Recipient" name="recipient">

  <attribute dataPolicy="smartCase" desc="Recipient registration number"
  label="Registration Number"
  length="50" name="registrationNumber" type="string"/>

</element>

Le nms:seedMember extension de schéma nommée cus:seedMember contient :

<element desc="Seed to insert in the export files" img="nms:unknownad.png" label="Seed addresses" labelSingular="Seed" name="seedMember">

  <element name="custom_nms_recipient">
    <attribute name="registrationNumber"
    template="cus:recipient:recipient/@registrationNumber"/>
  </element>

</element>

Le Numéro d’enregistrement fait désormais partie des champs de personnalisation disponibles :

Masquage d’un champ de personnalisation

Pour masquer un champ de personnalisation parmi ceux déjà disponibles, vous devez étendre Adobe Campaign. nms:seedMember schéma comme décrit dans la section Ajouter un champ de personnalisation . Procédez comme suit :

1. Copiez le champ à utiliser du schéma nms:seedMember vers le schéma étendu (cus :seedMember, par exemple).

2. Ajoutez la variable advanced="true" Attribut XML au champ. Il ne figure plus dans la liste des champs de personnalisation disponibles dans AEM.

   Par exemple, pour masquer la variable Middle Name , le champ cud:seedMember Le schéma doit contenir l’élément suivant :

   <element desc="Seed to insert in the export files" img="nms:unknownad.png" label="Seed addresses" labelSingular="Seed" name="seedMember">
   
     <element name="custom_nms_recipient">
       <attribute advanced="true" name="middleName"/>
     </element>
   
   </element>
   

Désactivation d’un bloc de personnalisation

Pour désactiver un bloc de personnalisation parmi les blocs disponibles :

1. Accédez au Ressources > Gestion de campagne > Blocs de personnalisation dans la navigation Adobe Campaign.

2. Sélectionnez le bloc de personnalisation à désactiver dans AEM.

3. Effacez la variable Visible dans les menus de personnalisation et enregistrez vos modifications. Le bloc ne figure plus dans la liste des blocs de personnalisation disponibles dans AEM.

   

Gestion des données d’extension cible

Vous pouvez également insérer des données d’extension cible pour la personnalisation. Les données d’extension cible (également appelées « données cibles ») sont issues de l’enrichissement ou de l’ajout de données dans une requête dans un processus de campagne, par exemple. Pour plus d’informations, reportez-vous à la section Créer une requête et Enrichir des données sections.