Sur cette page : concevez et personnalisez le contenu des campagnes déclenchées par API avec des données contextuelles transmises dans la payload de l’API afin que chaque message soit adapté à chaque destinataire en temps réel.
Pour configurer le contenu du message, accédez à l’onglet Contenu ou cliquez sur le bouton Modifier le contenu.
Concevoir le contenu design
Le processus de création du contenu dépend du canal que vous avez sélectionné. Découvrez les étapes détaillées pour créer le contenu de votre message dans les pages suivantes :
Joindre des fichiers PDF personnalisés attachments
Pour les campagnes transactionnelle par e-mail déclenchées par API, vous pouvez inclure jusqu’à cinq pièces jointes PDF dans un e-mail, y compris des pièces jointes statiques et personnalisées. Chaque destinataire peut recevoir différents PDF personnalisés. Découvrez comment joindre des fichiers PDF personnalisés.
Personnaliser du contenu à l’aide de données contextuelles contextual
Vous pouvez transmettre des données supplémentaires dans la payload de l’API que vous pouvez ensuite utiliser pour personnaliser votre message.
Prenons un exemple où la clientèle souhaite réinitialiser son mot de passe et où vous souhaitez lui envoyer une URL de réinitialisation de mot de passe générée dans un outil tiers. Avec les campagnes déclenchées par API, vous pouvez transmettre cette URL générée dans la payload de l’API et l’utiliser dans la campagne pour l’ajouter au message.
Pour ce faire, vous devez les transmettre dans la payload de l’API et les ajouter dans votre message à l’aide de l’éditeur de personnalisation. Utilisez la syntaxe {{context.<contextualAttribute>}}, où <contextualAttribute> doit correspondre au nom de la variable dans votre payload d’API qui contient les données que vous souhaitez transmettre.
Notez que, pour l’instant, aucun attribut contextuel n’est disponible dans le menu du rail de gauche. Les attributs doivent être saisis directement dans votre expression de personnalisation, sans vérification effectuée par Journey Optimizer.
À lire absolument
- Les attributs contextuels transmis dans la requête ne peuvent pas dépasser 200 Ko et sont toujours considérés comme étant de type chaîne.
- La syntaxe
context.systemest réservée à l’utilisation interne d’Adobe et ne doit pas être utilisée pour transmettre des attributs contextuels. - Contrairement aux événements activés pour le profil, les données contextuelles transmises dans l’API REST sont utilisées pour une communication ponctuelle et ne sont pas stockées par rapport au profil. Au maximum, le profil est créé avec les détails de l’espace de noms, s’il a été détecté comme manquant.
- L’utilisation d’un grand nombre de données contextuelles importantes dans votre contenu peut avoir un impact sur les performances.
Tester et vérifier votre contenu
Une fois le contenu défini, cliquez sur le bouton Simuler le contenu pour prévisualiser et tester le contenu. Vous pouvez utiliser l’une des méthodes de simulation suivantes :
- Cliquez sur Simuler le contenu pour tester des variations de contenu avec des exemples de données d’entrée ou des données générées par l’IA.
- Cliquez sur Simuler le contenu puis sélectionnez Simuler le contenu (profils AEP) dans la liste déroulante pour prévisualiser le contenu avec des profils de test.
Découvrez comment prévisualiser et tester du contenu. Pour revenir à l’écran de création de campagne, cliquez sur la flèche pointant vers la gauche.
Étapes suivantes next
Une fois la configuration et le contenu de votre campagne prêts, vous pouvez définir l’audience de la campagne. En savoir plus
This section contains structured knowledge intended to support interpretation, retrieval, and question answering related to this topic.
For complete understanding, this information should be combined with the documentation on this page. Neither source is intended to stand alone; the page describes the feature, while this section provides additional context that helps disambiguate terminology, intent, applicability, and constraints.
- TL;DR: This page explains how to design the content of an API triggered campaign, personalize it with contextual data passed in the API payload, attach personalized PDF files, and preview it with Simulate content.
Intents:
- Open the message content configuration from the Content tab or the Edit content button
- Personalize a message with contextual data from the API payload
- Attach personalized PDF files to transactional API-triggered email campaigns
- Preview and test the content with Simulate content
Glossary:
- Contextual data: Additional data passed into the API payload and used to personalize the message, referenced with the
{{context.<contextualAttribute>}}syntax, where<contextualAttribute>matches the name of the variable in the API payload (product-specific) - High Throughput campaigns: A mode that does not rely on Adobe profiles; all personalization must be included in the API payload as context data (product-specific)
- Simulate content: Button used to preview and test content with sample input data or AI auto-generation
- Simulate content (AEP profiles): Option selected from the Simulate content dropdown to preview with test profiles
Guardrails:
- The contextual attributes passed into the request cannot exceed 200kb (hard limit) and are always considered of type string.
- The
context.systemsyntax is restricted to Adobe internal usage only and should not be used to pass contextual attributes. - Contextual data passed in the REST API is used for one-off communication and is not stored against profile. At maximum, a profile is created with the namespace details, if it was found missing.
- Using a large number or heavy contextual data in your content may impact performances.
- For now, no contextual attribute is available for use in the left rail menu. Attributes must be typed directly in the personalization expression, with no check performed by Journey Optimizer.
- A transactional API-triggered email campaign can include up to five PDF attachments in an email, including both static and personalized attachments.
Applicability:
- Design content: Email, Mobile message, Push notification
- Personalized PDF attachments: transactional API-triggered email campaigns
- High Throughput campaigns: email channel only, US region only
Terminology:
- Canonical name: API triggered campaign content
- Do not confuse: “contextual data passed in the REST API” (one-off, not stored against profile) ≠ “profile-enabled events”
- Do not confuse: Simulate content (sample input data or AI auto-generation) ≠ Simulate content (AEP profiles) (test profiles)
FAQ:
- Q: How do I use data from the API payload in a message? — Pass the data into the API payload and add it in the message with the personalization editor, using
{{context.<contextualAttribute>}}. - Q: Can contextual attributes be picked from the left rail menu? — No. No contextual attribute is available there; attributes must be typed directly in the personalization expression.
- Q: What is the size limit for contextual attributes? — They cannot exceed 200kb and are always considered of type string.
- Q: Is contextual data stored against the profile? — No. It is used for one-off communication and not stored against profile. At maximum, a profile is created with the namespace details, if it was found missing.
- Q: How many PDF attachments can an email include? — For transactional API-triggered email campaigns, up to five, static and personalized attachments included.
- Q: How do I preview content? — Click Simulate content to test with sample input data or AI auto-generation, or select Simulate content (AEP profiles) from the dropdown to preview with test profiles.
Examples:
- A customer wants to reset a password. A password reset URL is generated in a third-party tool, passed into the API payload, and added to the message with
{{context.<contextualAttribute>}}.
Related pages:
- Creating email content: Email (email/create-email.md)
- Creating mobile message content: Mobile message (mobile/create-mobile-message.md)
- Creating push notification content: Push notification (push/create-push.md)
- High Throughput campaigns: High Throughput campaigns (campaigns/api-triggered-high-throughput.md)
- Personalized PDF attachments: Learn how to attach personalized PDF files (email/pdf-attachments.md#personalized-attachments)
- Previewing and testing content: Learn how to preview and test content (content-management/preview-test.md)
- Next step, defining the audience: Learn more (campaigns/api-triggered-campaign-audience.md)