Messagerie transactionnelle Adobe Campaign

Envoyez les e-mails transactionnels de Wallet Crew via Adobe Campaign Transactional Messaging en utilisant le fournisseur d'e-mails basé sur des scripts.

Utilisez cette option lorsque votre organisation exécute Adobe Campaign et utilise déjà la messagerie transactionnelle pour les envois de production.

Avant d’aller plus loin, assurez-vous de comprendre comment fonctionne le fournisseur de script dans The Wallet Crew. Commencez par Adobe Marketing Cloud et le prérequis Extensibilité d’EmailSender.

Quand utiliser ceci

C’est un bon choix si vous disposez déjà de la gouvernance Adobe Campaign, des rapports et d’événements transactionnels préexistants.

Configuration requise dans Adobe

Créez et publiez un Événement de message transactionnel.

Décidez ensuite si Adobe Campaign utilisera le HTML rendu par The Wallet Crew ou construira l’e-mail final à l’aide des modèles et variables Adobe Campaign.

Vous avez également besoin d’une méthode d’authentification sécurisée côté serveur prise en charge par votre déploiement Adobe Campaign. Elle repose souvent sur Adobe I/O ou IMS.

Notes d’implémentation (appel d’événement)

Votre script rend généralement l’e-mail (si The Wallet Crew contrôle le HTML), puis appelle le point de terminaison de l’événement transactionnel avec le destinataire et le contexte.

Stockez ces valeurs en tant que secrets avant de tester :

• adobe-clientId
• adobe-clientSecret
• adobe-campaign-transactionalUrl (URL complète de l’Événement de message transactionnel)
• adobe-orgId (facultatif, selon votre configuration Campaign)
• adobe-scope (facultatif, selon votre configuration Adobe)

Exemple Adobe Campaign (implémentation SendEmail)

import { getSecret } from "neo/secrets";

const CUSTOM_DOMAIN = "wallet.brand.com";
const TENANTID = "brand";

// Adobe IMS (identifiants client OAuth2)
const IMS_TOKEN_URL = "https://ims-na1.adobelogin.com/ims/token/v3";

async function getOptionalSecret(name, fallback) {
  try {
    return (await getSecret(name)) || fallback;
  } catch (e) {
    return fallback;
  }
}

/**
 * @typedef {Object} EmailData
 * @property {string} Sujet
 * @property {string} Corps
 */

async function sendEmail(recipient, emailTemplate, data, cultures, buildEmail) {
  const email = recipient;
  const countryCode = data["country"] || "fr";
  const language = `${cultures[0]?.toLowerCase()?.substring(0, 2) || "fr"}_${countryCode.toLowerCase()}`;
  const customerId = data["id.customerId"];

  if (!customerId) {
    throw new Error('Missing "id.customerId" in email data.');
  }

  const url = `https://${CUSTOM_DOMAIN}/${TENANTID}/carte?id.customerId=${encodeURIComponent(customerId)}`;

  // Conservez la disponibilité du rendu de The Wallet Crew.
  // Si Adobe Campaign possède le modèle, vous pouvez supprimer ceci et n’envoyer que des variables.
  const rendered = await buildEmail(emailTemplate);

  const transactionalUrl = await getSecret("adobe-campaign-transactionalUrl");

  const clientId = await getSecret("adobe-clientId");
  const clientSecret = await getSecret("adobe-clientSecret");
  const scope = await getOptionalSecret("adobe-scope", "openid,AdobeID");

  // Facultatif. Certaines configurations nécessitent des en-têtes d’ID d’organisation, d’autres non.
  const orgId = await getOptionalSecret("adobe-orgId", null);

  const headers = {
    "x-api-key": clientId,
    "Content-Type": "application/json",
  };
  if (orgId) headers["x-gw-ims-org-id"] = orgId;

  const result = await fetch(transactionalUrl, {
    Method: "POST",
    Authentication: {
      mode: "OAuth2.0",
      grantType: "clientCredentials",
      sendCredentialsAsFormParams: true,
      accessTokenUrl: IMS_TOKEN_URL,
      clientId,
      clientSecret,
      scope,
    },
    Headers: headers,
    Body: JSON.stringify({
      // La charge utile doit correspondre à la définition de votre Événement de message transactionnel.
      email,
      ctx: {
        url,
        language,

        // Facultatif si vous voulez qu’Campaign utilise le rendu de The Wallet Crew :
        subject: rendered.Subject,
        body: rendered.Body,

        // Métadonnées utiles :
        template: emailTemplate,
        customerId,
      },
    }),
    ThrowOnError: false,
  });

  if (result.StatusCode < 200 || result.StatusCode >= 300) {
    throw new Error(`L’appel Adobe Campaign a échoué (${result.StatusCode}) : ${result.ResponseText}`);
  }
}

export default function (context) {
  context.register("runtime.scriptable.emailEngine", {
    SendEmail: sendEmail,
  });
}

Ce qu'il faut valider

Déclenchez un véritable e-mail transactionnel, puis validez ces points :

• Votre Événement de message transactionnel est publié et appelable.
• Le schéma de charge utile correspond à la définition de l’événement.
• Adobe Campaign accepte la requête et traite le message.

FAQ

Avons-nous besoin d’un Événement de message transactionnel ?

Oui. Votre script doit appeler un point de terminaison d’Événement de messagerie transactionnelle publié. Cet événement définit le schéma de charge utile attendu et les variables disponibles dans votre modèle Adobe Campaign.

Adobe Campaign peut-il rendre l’e-mail au lieu de The Wallet Crew ?

Oui. Dans cette configuration, votre script n’envoie que les variables (par exemple, l’URL de téléchargement de la carte et les métadonnées client). Adobe Campaign possède le HTML, l’objet et les traductions.

Quelle méthode d’authentification devons-nous utiliser ?

Cela dépend de votre déploiement Adobe Campaign et de la manière dont votre organisation Adobe gère l’accès serveur à serveur. Cette page présente une approche basée sur IMS car elle est courante, mais vous devez aligner la méthode d’authentification finale avec votre équipe d’administration Adobe et la documentation officielle d’Adobe pour votre environnement.

Quelle est la raison la plus courante du rejet d’une requête ?

Incompatibilité de schéma. La définition de l’événement est stricte. Si les champs de votre charge utile ne correspondent pas à la structure attendue par l’événement, Campaign rejettera ou ignorera des champs, et les modèles afficheront des valeurs vides.