Cas d'utilisation : envoi d'e-mails transactionnels avec des pièces jointes transactional-email-with-attachments
L'objectif de ce cas pratique est d'ajouter des pièces jointes d'emails à la volée aux envois sortants.
Principales étapes key-steps
Dans ce scénario, vous allez apprendre à envoyer des emails transactionnels avec des pièces jointes individuelles et/ou personnalisées. Les pièces jointes ne seront pas préchargées sur le serveur de messagerie transactionnelle, mais générées à la volée.
Lorsque vous capturez des interactions ou des détails sur un client, vous devrez peut-être lui renvoyer ces informations à la fin du processus, par exemple dans un fichier PDF joint à un email.
Voici les étapes générales de ce scénario :
- Le client accède au site web et trouve le produit qu'il souhaite acheter.
- Il sélectionne le produit et personnalise certaines options.
- Il termine la transaction.
- Un email est envoyé au client pour confirmer la transaction. L'envoi de PII dans un email n'étant pas recommandé, un fichier PDF sécurisé est généré et joint à cet email.
- Le client reçoit l'email et la pièce jointe contenant toutes les données nécessaires.
Dans ce scénario, les pièces jointes ne sont pas créées à l'avance, mais ajoutées à la volée aux emails sortants, avec les avantages suivants :
- Vous pouvez personnaliser le contenu de la pièce jointe.
- Si elle est associée à une transaction (comme dans l’exemple de scénario ci-dessus), elle peut contenir des données dynamiques générées pendant le processus client.
- L'ajout de fichiers PDF optimise la sécurité lorsque vous pouvez les chiffrer et les envoyer via HTTPS.
Recommendations et mécanismes de sécurisation important-notes
Pour éviter des problèmes de performances, les images incluses dans les e-mails ne doivent pas dépasser 100 Ko. Cette limite, définie par défaut, peut être modifiée à partir de l’option NmsDelivery_MaxDownloadedImageSize. Cependant, Adobe recommande vivement d’éviter les images volumineuses dans vos diffusions e-mail.
Adobe recommande également de limiter la taille et le nombre de fichiers joints. Par défaut, vous ne pouvez ajouter qu’un seul fichier en tant que pièce jointe à un e-mail. Ce seuil peut être configuré à partir de l’option NmsDelivery_MaxRecommendedAttachments.
En savoir plus dans la liste des options de Campaign Classic.
Avant de mettre en œuvre ce scénario, lisez attentivement les directives suivantes :
- Les instances de messagerie transactionnelle ne doivent pas être utilisées pour stocker, exporter ou charger des fichiers ou des données. Elles ne peuvent être utilisées que pour les données d'événements et les informations s'y rapportant. Elles ne doivent pas être considérées comme un système de stockage de fichiers.
- Comme il n'existe aucun accès direct aux instances de messagerie transactionnelle ou aux serveurs à l'extérieur d'Adobe, il n'y a aucun moyen standard de transférer ces fichiers sur ces serveurs (pas d'accès FTP).
- D'un point de vue contractuel, il n'est pas correct d'utiliser l'espace disque sur l'instance de messagerie transactionnelle pour stocker des fichiers, quels qu'ils soient, même pour les pièces jointes.
- Pour héberger ces fichiers, vous devez utiliser un autre système de disque en ligne. Vous avez besoin d'un accès FTP à ce système et vous devez pouvoir écrire et supprimer des fichiers.
Mise en œuvre implementation
Le diagramme suivant montre les différentes étapes pour mettre en œuvre ce scénario :
Pour ajouter à la volée une pièce jointe à un message transactionnel, procédez comme suit :
-
Commencez par créer votre pièce jointe. Voir à ce propos cette section.
Vous pouvez ainsi joindre les fichiers à un email, même s'ils ne sont pas hébergés sur l'instance d'exécution.
-
Vous pouvez envoyer des emails via un déclencheur de message SOAP. Un appel SOAP contient un paramètre d’URL (attachmentURL).
Pour plus d'informations sur les requêtes SOAP, voir la section Description des événements.
-
Lors de la conception de votre email, cliquez sur Pièce jointe.
-
Dans l'écran Définition d'un fichier attaché, saisissez le paramètre de pièce jointe SOAP :
code language-none <%= rtEvent.ctx.attachmentUrl %> -
Lorsque le message est traité, le système extrait le fichier de l'emplacement distant (serveur tiers) et le joint au message.
Comme ce paramètre peut être une variable, il doit accepter la variable d'URL distante entièrement formée de votre fichier, envoyée via l'appel SOAP.
