# Adobe Marketing Cloud

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 produit d’e-mail unique. L’envoi d’e-mails dépend de ce que vous utilisez dans Adobe :

* [Adobe Journey Optimizer (AJO)](https://app.gitbook.com/s/WLc8AHXW4tdrAXUBfrYF/connect/email-provider/adobe-marketing-cloud/adobe-journey-optimizer) pour des parcours déclenchés par API et des envois en quasi temps réel.
* [Adobe Campaign Transactional Messaging](https://app.gitbook.com/s/WLc8AHXW4tdrAXUBfrYF/connect/email-provider/adobe-marketing-cloud/adobe-campaign-transactional-messaging) pour les événements de messagerie transactionnelle dans les architectures Adobe héritées.
* [Marketo Engage (Transactional Email API)](https://app.gitbook.com/s/WLc8AHXW4tdrAXUBfrYF/connect/email-provider/adobe-marketing-cloud/marketo-engage-transactional-email-api) pour les envois d’e-mails transactionnels liés aux modèles Marketo.

Il s'agit d'une **connecteur basé sur un script** Le Wallet Crew rend toujours le contenu des e-mails 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 rend le modèle**, et The Wallet Crew n’envoie que des variables.

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

* Une marque de retail 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 conserve la gouvernance et le reporting là-bas.
* Une équipe utilise Marketo Engage pour l’automatisation marketing et souhaite que les envois transactionnels soient visibles dans les journaux d’activité Marketo.
* Une équipe sécurité exige que tous les e-mails sortants passent par une unique plateforme auditée. Le fournisseur du script applique cela.

## Avant de commencer

Vous devez implémenter l’interface de script décrite dans [Extensibilité EmailSender](https://app.gitbook.com/s/WLc8AHXW4tdrAXUBfrYF/connect/custom-connector/emailsender-extensibility). Cette page se concentre sur ce qui change lorsque le « fournisseur derrière le script » est Adobe.

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

{% hint style="info" %}
Si vous envoyez déjà des e-mails depuis Adobe et souhaitez seulement intégrer des liens « Ajouter à la 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 [Inscription > Via e-mail](https://docs.thewalletcrew.io/fr/inscription/via-email) pour cette approche.
{% endhint %}

## Choisissez votre produit Adobe

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

* [Adobe Journey Optimizer (AJO)](https://app.gitbook.com/s/WLc8AHXW4tdrAXUBfrYF/connect/email-provider/adobe-marketing-cloud/adobe-journey-optimizer) est le choix habituel lorsque vous disposez de parcours déclenchés par API.
* [Adobe Campaign Transactional Messaging](https://app.gitbook.com/s/WLc8AHXW4tdrAXUBfrYF/connect/email-provider/adobe-marketing-cloud/adobe-campaign-transactional-messaging) convient aux architectures Adobe Campaign héritées avec des événements transactionnels.
* [Marketo Engage (Transactional Email API)](https://app.gitbook.com/s/WLc8AHXW4tdrAXUBfrYF/connect/email-provider/adobe-marketing-cloud/marketo-engage-transactional-email-api) est un bon choix lorsque vous voulez que les envois et l’activité soient suivis dans Marketo.

{% hint style="warning" %}
Choisissez une stratégie de rendu. Évitez de dupliquer la mise en modèle à la fois dans The Wallet Crew et dans Adobe.
{% endhint %}

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

C’est l’interrupteur qui fait que The Wallet Crew appelle votre `SendEmail` implémentation.

{% stepper %}
{% step %}

#### Implémenter `runtime.scriptable.emailEngine.SendEmail`

Commencez par [Extensibilité EmailSender](https://app.gitbook.com/s/WLc8AHXW4tdrAXUBfrYF/connect/custom-connector/emailsender-extensibility) et ajoutez votre code de livraison Adobe à l’intérieur de `SendEmail`.

Assurez-vous que votre script puisse accéder aux identifiants Adobe de manière sécurisée. Ne codez jamais les secrets en dur dans le script.
{% endstep %}

{% step %}

#### Update `/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 `resources` pointant vers votre répertoire de modèles d’e‑mail.

{% code title="/server/emails.yml" %}

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

{% endcode %}
{% endstep %}

{% step %}

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

Déclenchez un e-mail réel (lien de téléchargement de la carte, e-mail de vérification ou e-mail d’enregistrement).

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

## Stratégie de modèle et de culture

The Wallet Crew peut rendre les modèles localement via `buildEmail`. Adobe peut également rendre des modèles de son côté, selon le produit.

Choisissez l’un de ces modèles et gardez-le cohérent :

* **The Wallet Crew possède le HTML.** Vous envoyez le `Objet` et `Corps` rendu à Adobe.
* **Adobe possède le HTML.** Vous n’envoyez que des 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 incluent la sélection de la première culture, l’association d’une culture à un actif Adobe spécifique ou le recours à une valeur par défaut.

## Notes de sécurité et de confidentialité

Traitez cette intégration comme une connexion serveur-à-serveur.

* Conservez tous les identifiants Adobe côté serveur. Ne les exposez jamais aux clients.
* Privilégiez les jetons d’accès de courte durée. Faites pivoter les secrets clients régulièrement.
* Évitez de consigner les corps d’e-mails entièrement rendus. Le contenu des e-mails peut contenir des données personnelles.
* Consignez plutôt des identifiants stables (nom du modèle, id de campagne/événement Adobe et un id de corrélation).

## Dépannage

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

* Confirmez que `/server/emails.yml` est un YAML valide et enregistré dans le bon locataire.
* Confirmez que votre script enregistre `runtime.scriptable.emailEngine` et exporte `SendEmail`.
* Confirmez que l’authentification Adobe fonctionne (génération de jetons et étendues).
* Confirmez que l’actif Adobe est publié et appelable (campagne/parcours/événement/modèle).
* Vérifiez les logs Adobe pour les requêtes rejetées (champs manquants, incompatibilité de schéma, limites de taux).

## FAQ

<details>

<summary><strong>Quelle option devrions-nous choisir ?</strong></summary>

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

</details>

<details>

<summary><strong>Pouvons-nous changer plus tard ?</strong></summary>

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

</details>

<details>

<summary><strong>Avons-nous besoin qu’Adobe héberge les modèles ?</strong></summary>

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

</details>

<details>

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

Pas toujours. Si votre marque envoie déjà l’e-mail depuis Adobe et que vous voulez seulement ajouter des liens « Ajouter à la Wallet », conservez l’e-mail entièrement dans Adobe. Intégrez ensuite les liens The Wallet Crew derrière vos CTA. Voir [Inscription > Via e-mail](https://docs.thewalletcrew.io/fr/inscription/via-email) pour cette approche.

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

</details>

<details>

<summary><strong>Devons-nous envoyer du HTML rendu ou seulement des variables ?</strong></summary>

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

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

</details>

<details>

<summary><strong>Pouvons-nous utiliser plusieurs produits Adobe en même temps ?</strong></summary>

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

</details>