Intégration standard de la campagne dans AEM

Introduction:

Dans ce guide complet, nous vous guiderons tout au long du processus d’intégration d’Adobe Campaign Standard dans Adobe Experience Manager (AEM) avec un cas d’utilisation réel. Vous apprendrez à connecter de manière transparente les deux plates-formes et à tirer parti de la puissance des fonctionnalités d’automatisation du marketing d’Adobe Campaign au sein d’AEM. Nous couvrirons les étapes depuis la configuration de l’intégration, la création de projets, la génération de paires de clés et l’établissement d’une authentification sécurisée. Avec un cas d’utilisation pratique, nous montrerons comment récupérer les profils des clients, envoyer des messages transactionnels personnalisés et abonner les utilisateurs aux newsletters de manière transparente. Préparez-vous à libérer tout le potentiel d’Adobe Campaign Standard dans votre environnement AEM.

Conditions préalables:

1. Vous devriez avoir accès à Console développeur Adobe
2. Sur la console de développement, vous devriez avoir accès à Campagne Adobe
3. Vous devez également avoir accès à l’accès à l’instance Adobe Campaign Standard pour créer des campagnes et des messages.

Étapes pour intégrer les API Adobe Campaign dans le projet AEM

1. Créez un compte au Console développeur Adobe.
2. Sur la console de développement, créez un projet et ajoutez-y l’API Campaign
3. Générez une paire de clés dans la configuration du projet et stockez la clé privée à partir du fichier de configuration téléchargé.
4. Accédez à la documentation de l’API pour voir quelles opérations vous pouvez effectuer dans Adobe Campaigns via Adobe I/O.
5. Établissez une connexion avec le serveur standard de la campagne à l’aide du jeton JWT pour récupérer le jeton d’accès. Tu peux trouver Documentation sur la façon de procéder sur la console développeur.
6. vous avez le jeton d’accès, vous pouvez utiliser toutes les API disponibles à partir d’Adobe I/O.

Étapes expliquées

1. Créer un projet pour les campagnes sur la console de développement Adobe

1. Naviguez vers le console de développement. Si vous n’avez pas créé le compte, créez-le et continuez.
   Créer un projet pour votre candidature.
2. Une fois créé ajouter l’API de campagne à votre projet. Sélectionnez Adobe Campaign puis Générer une paire de clés à l’étape suivante.
   config.zip est téléchargé. Le certificat de clé publique et la clé privée sont téléchargés
3. Après la création réussie de l’API, vous accéderez aux détails du SDK Adobe Campaign pour votre projet avec les informations d’identification du compte de service.
4. Si vous allez au dernier de la page, vous pouvez naviguer vers le Documentation API où vous pouvez utiliser ces informations d’identification pour accéder aux API de campagne. Ici, vous pouvez naviguer sur toutes les opérations que nous pouvons effectuer dans les campagnes Adobe via Adobe I/O.

2. Authentification standard des campagnes

Vous pouvez établir une connexion avec le serveur standard de la campagne à l’aide du jeton JWT pour récupérer le jeton d’accès. (Documentation)

À partir de la configuration que nous avons téléchargée précédemment lors de la création du projet sur la console développeur,
Obtenir et stocker la clé privée.

E/S Adobe – configuration des étapes d’accès à l’API

Pour la référence d’implémentation, vérifiez le code ci-dessous.
Publication API de connexion

 
 
 
 
 String[] metascopes = new String[]{"ent_campaign_sdk"}; HashMap<String, Object> jwtClaims = new HashMap<>(); jwtClaims.put("iss", orgid); jwtClaims.put("sub", techact); jwtClaims.put("exp", System.currentTimeMillis() / 1000 + 86400L); jwtClaims.put("aud", "https://" + AUTH_SERVER_FQDN + "/c/" + apikey); for (String metascope : metascopes) {     jwtClaims.put("https://" + AUTH_SERVER_FQDN + "/s/" + metascope, Boolean.TRUE); }     String jwtToken = Jwts.builder().setClaims(jwtClaims).signWith(RS256, privateKey).compact();     HttpPost authPostRequest = new HttpPost("https://ims-na1.adobelogin.com/ims/exchange/jwt/"); authPostRequest.addHeader(CACHE_CONTROL, NO_CACHE); List<NameValuePair> params = new ArrayList<>(); params.add(new BasicNameValuePair("jwt_token", jwtToken)); params.add(new BasicNameValuePair("client_id", apikey)); params.add(new BasicNameValuePair("client_secret", clientsecret)); authPostRequest.setEntity(new UrlEncodedFormEntity(params)); HttpResponse response = httpClient.execute(authPostRequest);     HttpEntity entity = response.getEntity(); JsonObject jo = new JsonParser().parse(EntityUtils.toString(entity)).getAsJsonObject(); return jo.get("access_token").getAsString();

3. Récupérer les profils de la norme de campagne

Documentation API

cURL ajouté, utilisé dans le projet de démonstration, ci-dessous pour référence
Récupérer des profils

curl --location -g --request GET 'https://mc.adobe.io/{{org_id}}/campaign/profileAndServices/profile' \ --header 'X-Api-Key: {{api_key}}' \ --header 'Authorization; Bearer {{access_token}}' \ --header 'Content-Type: application/json' \ --data-raw '{     "ctx": {     },     "email": "\"\\\"polidew222@agrolivana.com\\\"\"" }'

Nous avons intégré les e-mails de prise de vue de notre application de démonstration AEM via Messagerie transactionnelle et souscrire à Campagnes de newsletter sur la norme de campagne :

4. Envoi d’un message transactionnel depuis l’application AEM :

Documentation API pour créer un message transactionnel sur la norme de campagne
Une fois que vous avez suivi les étapes ci-dessus et publié et testé votre message transactionnel
Vous pouvez accéder à la configuration de l’événement du message transactionnel et vérifier l’aperçu de l’API pour gestion du message via REST Api.

Reportez-vous à cURL ci-dessous, utilisé dans notre application de démonstration AEM, pour référence
Envoyer un message transactionnel

curl --location -g --request POST 'https://mc.adobe.io/{{org_id}}/campaign/mctangerinedigiapacptrsd/EVTsampleTransactionalEmail' \ --header 'X-Api-Key: {{api_key}}' \ --header 'Authorization; Bearer {{access_token}}' \ --header 'Content-Type: application/json' \ --data-raw '{     "email": "test-u6vse5z1s@srv1.mail-tester.com",     "ctx": {         "hasInsurance": false,         "dob": "string127",         "lname": "Vashistha",         "fname": "Pulkit"     } }'

5. Intégration de l’abonnement à la newsletter :

En utilisant Adobe I/O, nous avons intégré la suite Logic for Campaign Standard avec la campagne S’abonner à la newsletter sur notre application AEM :

Dans le composant ci-dessus sur la page d’accueil, l’utilisateur saisit l’identifiant de messagerie et clique sur s’abonner :
Maintenant, sur la couche d’application, nous utilisons la logique métier suivante pour abonner l’utilisateur à la newsletter :

1. Authentification de l’utilisateur via JWT pour récupérer le jeton d’authentification
2. Vérifier si l’utilisateur existe sur la base de données utilisateur Campaign Standard (Rechercher sur la page liée => Exemple de demande pour filtrer les profils sur la base de l’e-mail)
3. Si non alors créer et aller chercher profil
4. S’il existe, stockez le profil
5. Envoyer un message transactionnel à l’identifiant de messagerie.
6. Utilisez le profil pour récupérer l’URL d’abonnement pour le profil à partir du json => profilejson[0].abonnements.href
7. Utilisez maintenant l’URL d’abonnement pour l’utilisateur et la clé P pour le service d’abonnement dans Campaign Standard pour abonner l’utilisateur au service (utilisez la méthode 1).

Conclusion:

En conclusion, cet article a décrit comment intégrer les API Adobe Campaign à AEM. L’intégration vous permet d’envoyer des messages transactionnels et d’abonner les utilisateurs aux campagnes de newsletter sur Campaign Standard. Les exemples de code fournis dans l’article peuvent être utilisés comme point de départ pour vos propres projets d’intégration. L’intégration d’Adobe Campaign et d’AEM offre un certain nombre d’avantages, notamment une meilleure délivrabilité des e-mails, un engagement accru et des workflows automatisés.

Concrètement, Adobe Campaign peut vous aider à :

• Améliorez la délivrabilité de vos e-mails en fournissant des informations sur votre audience et en vous aidant à créer des messages ciblés et personnalisés.
• Augmentez l’engagement avec vos abonnés par e-mail en vous fournissant des outils pour suivre les ouvertures, les clics et d’autres mesures.
• Automatisez vos workflows de marketing par e-mail, libérant ainsi votre temps pour vous concentrer sur d’autres tâches.

Si vous cherchez un moyen d’améliorer votre marketing par e-mail, l’intégration d’Adobe Campaign à AEM est une excellente option. L’intégration offre un certain nombre d’avantages qui peuvent vous aider à améliorer la délivrabilité, l’engagement et l’automatisation de vos campagnes par e-mail.

Si vous avez encore des questions, laissez un commentaire et rejoignez la discussion !

En attendant, consultez nos autres articles de blog : Chiffrement JOSE et intégration du magasin de clés AEM

TROUVÉ CELA UTILE ? PARTAGEZ-LE