Adobe Marketing Cloud

Envoyez les e-mails transactionnels The Wallet Crew via Adobe Journey Optimizer, Adobe Campaign ou Marketo Engage à l’aide du fournisseur d’e-mails par script.

Utilisez cette intégration lorsque vous souhaitez que The Wallet Crew envoie des e-mails transactionnels via un produit marketing Adobe que votre marque utilise déjà.

« Adobe Marketing Cloud » n’est pas un seul produit d’e-mail. L’envoi des e-mails dépend de ce que vous utilisez dans Adobe :

• Adobe Journey Optimizer (AJO) pour les parcours déclenchés par API et les envois en quasi temps réel.
• Adobe Campaign Transactional Messaging pour les événements de messagerie transactionnelle dans les stacks Adobe héritées.
• Marketo Engage (Transactional Email API) pour les envois d’e-mails transactionnels liés aux modèles Marketo.

Il s’agit d’un basé sur un script connecteur. The Wallet Crew génère toujours le contenu de l’e-mail si vous le souhaitez. Votre script délègue ensuite la livraison finale à Adobe.

Vous pouvez utiliser deux modèles de livraison :

• The Wallet Crew génère le HTML, et Adobe l’envoie.
• Adobe génère le modèle, et The Wallet Crew n’envoie que les variables.

L’architecture reste la même dans tous les cas.

• Une marque de distribution utilise AJO pour l’orchestration, le consentement et le reporting. The Wallet Crew fournit le HTML final.
• Une marque dispose déjà d’Adobe Campaign Transactional Messaging en production. Elle y conserve la gouvernance et le reporting.
• Une équipe utilise Marketo Engage pour l’automatisation marketing et souhaite que les envois transactionnels soient visibles dans les journaux d’activité de Marketo.
• Une équipe sécurité exige que tous les e-mails sortants passent par une seule plateforme auditée. Le fournisseur de script l’impose.

Avant de commencer

Vous devez implémenter l’interface de script décrite dans l’extensibilité d’EmailSender. Cette page se concentre sur ce qui change lorsque le « fournisseur derrière le script » est Adobe.

Vous aurez également besoin d’un accès à votre produit Adobe pour créer et publier tout ce qui est nécessaire à l’envoi d’e-mails (campagne, événement ou modèle). The Wallet Crew ne peut pas créer ces objets pour vous.

Si vous envoyez déjà des e-mails depuis Adobe et souhaitez seulement intégrer des liens « Add to Wallet », vous n’avez pas besoin de cette page. Utilisez vos modèles Adobe et placez les liens The Wallet Crew derrière vos CTA. Voir Livraison des e-mails pour cette approche.

Choisissez votre produit Adobe

Chaque produit Adobe possède sa propre API, ses propres ressources et son propre modèle de gouvernance. Choisissez celui que votre organisation utilise déjà.

• Adobe Journey Optimizer (AJO) est le choix habituel lorsque vous disposez de parcours déclenchés par API.
• Adobe Campaign Transactional Messaging convient aux stacks Adobe Campaign héritées avec des événements transactionnels.
• Marketo Engage (Transactional Email API) convient bien lorsque vous souhaitez que les envois et l’activité soient suivis dans Marketo.

Choisissez une seule stratégie de rendu. Évitez de dupliquer la création de modèles à la fois dans The Wallet Crew et Adobe.

Activez le fournisseur d’e-mails de script dans The Wallet Crew

C’est l’option qui amène The Wallet Crew à appeler votre SendEmail implémentation.

1

Implémentez runtime.scriptable.emailEngine.SendEmail

Commencez à partir de l’extensibilité d’EmailSender et ajoutez votre code de livraison Adobe dans SendEmail.

Assurez-vous que votre script peut accéder de manière sécurisée aux identifiants Adobe. N’intégrez jamais de secrets en dur dans le script.

2

Mettez à jour /server/emails.yml

Ouvrez l’éditeur de configuration avancée, puis créez ou modifiez /server/emails.yml.

Définissez le type de fournisseur sur script. Conservez ressources pointant vers votre répertoire de modèles d’e-mail.

/server/emails.yml

provider:
  type: script
resources:
  - /locales/emails/

3

Déclenchez un e-mail transactionnel et vérifiez dans Adobe

Déclenchez un vrai e-mail (lien de téléchargement, e-mail de vérification ou e-mail d’inscription).

Vérifiez qu’Adobe reçoit l’appel et que le message est accepté. Validez ensuite la livraison dans les en-têtes de la boîte aux lettres si nécessaire (SPF/DKIM/DMARC).

Stratégie de modèles et de cultures

The Wallet Crew peut générer les modèles localement via buildEmail. Adobe peut aussi générer les modèles de son côté, selon le produit.

Choisissez l’un de ces modèles et conservez-le de façon cohérente :

• The Wallet Crew est propriétaire du HTML. Vous envoyez le rendu Objet et Corps à Adobe.
• Adobe est propriétaire du HTML. Vous n’envoyez que les variables, et Adobe choisit le modèle.

La sélection de la culture reste de votre responsabilité. La plateforme fournit un cultures tableau. Les stratégies courantes consistent à sélectionner la première culture, à associer une culture à un asset Adobe spécifique, ou à revenir à une valeur par défaut.

Notes sur la sécurité et la confidentialité

Considérez cette intégration comme une connexion serveur à serveur.

• Conservez tous les identifiants Adobe côté serveur. Ne les exposez jamais aux clients.
• Privilégiez des jetons d’accès à durée de vie courte. Faites régulièrement tourner les secrets client.
• Évitez de journaliser le corps complet des e-mails rendus. Le contenu des e-mails peut contenir des données personnelles.
• Journalisez plutôt des identifiants stables (nom du modèle, identifiant de campagne/d’événement Adobe et identifiant de corrélation).

Dépannage

Si les e-mails cessent d’être envoyés, isolez le problème dans cet ordre :

• Vérifiez /server/emails.yml est un YAML valide et qu’il est enregistré dans le bon tenant.
• Vérifiez que votre script enregistre runtime.scriptable.emailEngine et exporte SendEmail.
• Vérifiez que l’authentification Adobe fonctionne (génération du jeton et scopes).
• Vérifiez que l’asset Adobe est publié et appelable (campagne/parcours/événement/modèle).
• Consultez les journaux Adobe pour les requêtes rejetées (champs manquants, incompatibilité de schéma, limites de débit).

FAQ

Quelle option devons-nous choisir ?

Choisissez le produit que votre organisation utilise déjà et gouverne pour les e-mails transactionnels. Si Adobe Journey Optimizer est disponible pour vos envois déclenchés par API, c’est généralement le choix le plus pérenne.

Pouvons-nous changer plus tard ?

Oui. Le rendu est séparé de la livraison. Si vous conservez vos modèles dans The Wallet Crew, le changement du produit Adobe en aval se résume surtout à une modification du script.

Adobe doit-il héberger les modèles ?

Pas nécessairement. Vous pouvez envoyer du HTML entièrement rendu depuis The Wallet Crew, ou déléguer le rendu à Adobe. Choisissez une seule stratégie pour éviter les incohérences.

Avons-nous besoin de cette intégration si nous envoyons déjà des e-mails depuis Adobe ?

Pas toujours. Si votre marque envoie déjà l’e-mail depuis Adobe et que vous souhaitez seulement ajouter des liens « Add to Wallet », conservez l’e-mail entièrement dans Adobe. Intégrez ensuite les liens The Wallet Crew derrière vos CTA. Voir Livraison des e-mails pour cette approche.

Utilisez le fournisseur de script uniquement lorsque vous souhaitez que The Wallet Crew déclenche l’envoi transactionnel et délègue la livraison finale à Adobe.

Devons-nous envoyer le HTML rendu ou seulement les variables ?

Envoyez du HTML rendu lorsque vous voulez que The Wallet Crew soit la source de vérité pour le contenu et les traductions des e-mails. Envoyez seulement les variables lorsque votre équipe e-mail a besoin d’un contrôle total du modèle et du flux de validation dans Adobe.

Évitez de mélanger les deux modèles d’un parcours à l’autre. Cela crée des différences difficiles à déboguer entre les e-mails.

Pouvons-nous utiliser plusieurs produits Adobe en même temps ?

Techniquement oui, car votre script peut acheminer les envois comme vous le souhaitez. En pratique, choisissez un produit par tenant lorsque c’est possible. Cela maintient une gouvernance, un reporting et un dépannage clairs.