Sur cette page : Activez le mode à débit élevé pour les campagnes déclenchées par l’API afin de pouvoir envoyer des messages transactionnels en temps réel à très grande échelle (e-mail et push) jusqu’à 5 000 transactions par seconde sans dépendre des profils.
Le mode à débit élevé est conçu pour les organisations qui ont besoin de messages transactionnels en temps réel à très grande échelle (jusqu’à 5 000 transactions par seconde). Contrairement aux campagnes standard déclenchées par API, les campagnes à débit élevé fonctionnent indépendamment des profils Adobe et nécessitent un modèle de configuration différent.
Cette page explique en quoi les campagnes à débit élevé diffèrent des campagnes standard déclenchées par l’API, les exigences de configuration et le moment où choisir chaque mode.
Mécanismes de sécurisation et limitations guardrails
-
Accès - Disponible dans toutes les régions, à l’exception de la Suisse, pour les organisations disposant d’une licence avec le module complémentaire de messagerie transactionnelle à haut débit.
-
Canaux : e-mail et notifications push.
-
Personalization dans les campagnes à haut débit :
- Toutes les personnalisations doivent être incluses dans la payload de l’API en tant que données contextuelles. Découvrez comment personnaliser du contenu à l’aide de données contextuelles.
- La personnalisation basée sur les profils n’est pas prise en charge. Si des variables de profil sont utilisées, des erreurs de validation se produisent.
-
Personalization dans les configurations de canal à débit élevé - Les configurations de canal à débit élevé ne prennent pas en charge la personnalisation contextuelle ou basée sur les profils.
-
Ressources correspondantes - Les campagnes à débit élevé, les configurations de canal et les pools d’adresses IP ne peuvent être utilisés qu’entre eux. Les ressources standard et à débit élevé ne peuvent pas être mélangées.
-
Point d’entrée de l’API - Les campagnes à débit élevé utilisent un point d’entrée différent des campagnes déclenchées par l’API standard. Pour plus d’informations, voir Exécuter une campagne déclenchée par API.
-
Exclusivité de la campagne - Les campagnes à débit élevé n’utilisent pas les profils Adobe. Les messages sont diffusés qu’un profil existe ou non.
De plus, une campagne ne peut pas être utilisée à la fois pour les cas d’utilisation avec ou sans profil. Si vous avez besoin des deux, créez deux campagnes distinctes et assurez-vous que le système d’appel décide laquelle déclencher en fonction du contexte.
-
Jeux de données pour les commentaires et le suivi - Les données de commentaire et de suivi pour les campagnes à débit élevé sont stockées dans des jeux de données dédiés qui ne sont pas activés pour les profils. Par conséquent, ces événements ne sont pas associés à des profils, même s’il existe un profil correspondant.
Les jeux de données utilisés sont les suivants :
- Jeu de données d’événements de feedback de messages AJO – Hors profil – Utilisé pour le feedback d’e-mail et de notification push
- Jeu de données d’événement d’expérience de suivi d’e-mails AJO – Hors profil – Utilisé pour le suivi des e-mails. Un jeu de données de suivi dédié non lié aux profils pour les notifications push n’est pas encore disponible.
-
Affectation de débit - Le débit fourni sous le module complémentaire de débit élevé est exclusivement réservé aux campagnes à débit élevé. Il n’existe aucun partage du débit entre les campagnes standard et à débit élevé déclenchées par l’API.
-
Fonctionnalités non prises en charge :
-
Exportation de messages et sous-domaines dynamiques ne sont pas pris en charge pour un débit élevé.
-
Pièces jointes PDF personnalisées - Non pris en charge lorsque le trafic à débit élevé est acheminé via la région secondaire. En savoir plus sur les pièces jointes PDF personnalisées
-
-
Notifications push :
- Web push — Les campagnes Web push à haut débit s’exécutent sur une infrastructure partagée et ne bénéficient pas de la capacité dédiée réservée aux notifications push mobiles à haut débit.
- Taille de la payload – La taille maximale de la payload est de 5 Ko.
- Comportement de liste bloquée – Lorsqu’un message se retrouve sur une liste bloquée, le feedback sur la diffusion est conservé, mais aucun feedback sur la mise à jour du profil n’est généré. Cela signifie que les réponses de liste bloquée ne déclenchent pas de mises à jour de profil ou d’invalidation de jeton dans Adobe Experience Platform.
Choisir entre des campagnes standard ou à débit élevé
Utilisez ce tableau pour déterminer le type de campagne déclenché par l’API adapté à votre cas d’utilisation :
En d’autres termes :
-
Choisissez les campagnes standard déclenchées par API si :
- Vous n’avez pas de contrat de débit élevé.
- Le débit dont vous avez besoin est < 500 TPS.
- Vous avez besoin d’une personnalisation basée sur les profils Adobe.
- Vous souhaitez que les données de campagne soient rattachées aux profils pour un ciblage futur.
- Vous souhaitez utiliser un autre canal qu’E-mail ou Notification push.
-
Choisissez les campagnes à débit élevé si :
- Vous avez besoin d’un débit > 500 TPS.
- Vous n’avez pas besoin de rattacher les données aux profils.
- Vous pouvez transmettre toute la personnalisation dans la payload de l’API.
- Vous souhaitez utiliser le canal E-mail ou Notification push.
Configuration de campagnes déclenchées par l’API à haut débit configure-high-throughput
Une fois la condition préalable remplie, vous pouvez configurer un débit élevé dans l’interface utilisateur du produit pour les deux canaux :
- E-mail : créez un pool d’adresses IP à haut débit dédié, puis une configuration de canal e-mail à haut débit qui l’utilise. En savoir plus
- Push : permet de créer une configuration de canal push à haut débit. En savoir plus
Prérequis prerequisite
Après l’achat du module complémentaire Messages transactionnels à haut débit, contactez l’assistance clientèle d’Adobe ou votre représentant Adobe afin que l’activation back-end requise puisse être effectuée.
Configurer des campagnes par e-mail déclenchées par l’API à haut débit setup-guidelines
Pour configurer des campagnes par e-mail à débit élevé, procédez comme suit.
Création d’un groupe d’adresses IP dédié create-ip-pool
Un débit élevé nécessite un pool d’adresses IP dédié, car il est conçu pour maintenir une disponibilité et des performances élevées dans deux régions.
Lorsque vous achetez le module complémentaire à débit élevé, les adresses IP d’envoi sont configurées dans une région secondaire, en plus des adresses IP qui vous sont allouées dans votre région principale.
- Basculement - Si la région principale devient indisponible, tout le trafic à haut débit passe automatiquement à la région secondaire, de sorte que vos messages transactionnels continuent à être diffusés.
- Préchauffage d’IP - Pour vous assurer que les adresses IP de la région secondaire sont prêtes si nécessaire, une partie de votre trafic à haut débit est acheminé régulièrement via la région secondaire. Cela permet de conserver ces adresses IP au chaud. L’envoi d’emails à partir d’adresses IP sans historique d’envoi peut entraîner le rejet de vos emails par les fournisseurs d’accès internet (FAI).
Créez le groupe d’adresses IP comme suit.
-
Créez un pool d’adresses IP. Voici comment procéder
-
Sélectionnez l’option Activer le débit élevé.
-
Sélectionnez une ou plusieurs adresses IP de la région secondaire pour le groupe d’adresses IP dédié. Cela garantit une haute disponibilité pour votre trafic à débit élevé.
Le groupe d’adresses IP dédié est maintenant prêt à être utilisé avec les configurations de canal à haut débit.
Créer une configuration de canal e-mail à haut débit configuration-guidelines
-
Créez une configuration de canal e-mail. Voici comment procéder
-
Sélectionnez le type d’e-mail transactionnel dans le champ Paramètres d’e-mail.
-
Activez le bouton (bascule) Créer en tant que configuration à débit élevé.
-
Dans la section Détails du groupe d’adresses IP, sélectionnez le groupe d’adresses IP à haut débit que vous avez créé. Seuls les pools d’adresses IP à haut débit sont répertoriés.
-
Envoyez la configuration du canal.
Votre configuration de canal e-mail à haut débit est maintenant prête à être utilisée dans une campagne déclenchée par l’API à haut débit.
Configurer des campagnes push à haut débit setup-push
Comme pour les e-mails, vous pouvez configurer un débit élevé pour les notifications push vous-même, directement dans l’interface. Pour ce faire, procédez comme suit :
-
Créez une configuration de canal push. Voici comment procéder
-
Activez le bouton (bascule) Créer en tant que configuration à débit élevé.
{width="80%"}
-
Sélectionnez la ou les plateformes et le ou les identifiants d’application correspondants pour votre configuration push.
note NOTE Lorsque le bouton Haut débit est activé, la personnalisation de l’ID de l’application push n’est pas disponible. -
Envoyez la configuration du canal.
Votre configuration de canal push à haut débit est maintenant prête à être utilisée dans une campagne déclenchée par l’API à haut débit.
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 High throughput mode for API triggered campaigns differs from standard API triggered campaigns, its guardrails and setup requirements, and when to choose each mode for very large-scale, real-time transactional messages (email and push) without relying on profiles.
Intents:
- Decide between a standard API triggered campaign and a High throughput campaign
- Know the guardrails and limitations of High throughput campaigns
- Set up High throughput campaigns: a dedicated IP pool and a channel configuration for email, a channel configuration for push
- Know how to personalize a High throughput campaign (contextual data only)
- Know which datasets store feedback and tracking data for High throughput campaigns
Glossary:
- High throughput mode (also written High Throughput): A mode of API triggered campaigns designed for very large-scale, real-time transactional messaging, which operates independently of Adobe Profiles (product-specific)
- Standard API triggered campaign: An API triggered campaign that is not in High throughput mode
- High Throughput transactional messaging add-on: The add-on that organizations must be licensed with to use High throughput campaigns (product-specific)
- Contextual data: Personalization data passed in the API payload
- AJO Message Feedback Event Dataset - Non Profile: Dataset used for both email and push feedback of High throughput campaigns
- AJO Email Tracking Experience Event Dataset - Non Profile: Dataset used for email tracking only of High throughput campaigns
Guardrails:
- Throughput: High throughput campaigns support up to 5000 transactions per second; standard API triggered campaigns support up to 500 transactions per second.
- Channels: Email and push notifications for High throughput campaigns.
- Personalization: all personalization must be included in the API payload as contextual data. Profile-based personalization is not supported, and validation errors occur if profile variables are used.
- Channel configurations that use profile-based personalization cannot be used with High throughput campaigns. Only channel configurations without profile personalization can be used.
- High throughput campaigns use a different API endpoint than standard API triggered campaigns.
- High throughput campaigns do not use Adobe Profiles. Messages are delivered whether or not a profile exists.
- A campaign cannot be used for both profile-enabled and non-profile use cases. If you need both, create two separate campaigns, and make the calling system decide which one to trigger based on the context.
- Feedback and tracking data for High throughput campaigns are stored in dedicated datasets that are not enabled for profiles, so these events are not stitched to profiles, even if a matching profile exists. A dedicated non-profile tracking dataset for push is not yet available.
- The throughput provisioned under the High Throughput add-on is exclusively reserved for High throughput campaigns. There is no sharing of throughput between standard and High throughput API triggered campaigns.
- Personalized PDF attachments are not supported when a High throughput campaign fails over to another region.
- Web push: High Throughput web push campaigns run on shared infrastructure and do not benefit from the dedicated capacity reserved for High Throughput mobile push.
- Push payload size: the maximum payload size is 5 KB (hard limit).
- Denylist behavior for push: when a message hits a denylist, delivery feedback is retained but no profile-update feedback is produced, so denylist responses do not trigger profile updates or token invalidation in Adobe Experience Platform.
- High throughput channel configurations (and, for email, IP pools) can only be used with High throughput API triggered campaigns, and not with standard transactional messaging using API triggered campaigns or journeys.
- The type of a channel configuration or IP pool cannot be changed after creation: a standard resource cannot be converted to High throughput, and vice versa.
- Push App id personalization is not available in High throughput push channel configurations.
- When creating a High throughput API triggered campaign, only High throughput channel configurations are available for selection.
Prerequisites and permissions:
- The organization must be licensed with the High Throughput transactional messaging add-on.
- A one-time backend activation after purchasing the add-on, requested through Adobe Customer Care or your Adobe representative (not needed for each channel configuration).
- Email: a new dedicated High throughput IP pool, and a new email channel configuration with the Create as a High throughput configuration toggle enabled that uses this IP pool.
- Push: a new push channel configuration with the Create as a High throughput configuration toggle enabled, with the platform(s) and App id(s) selected. No IP pool is needed.
Applicability:
- Access: available across all regions except Switzerland.
- Applies to API triggered campaigns, in High throughput mode.
Terminology:
- Canonical name: High throughput mode — variants: High Throughput mode, High throughput campaigns
- Acronym: TPS — transactions per second (used on the page body)
- Do not confuse: “Standard API triggered campaign” (included in the base offering, standard entitlement and message packs, standard infrastructure, uptime 99,9%) ≠ “High throughput campaign” (requires the High Throughput transactional messaging add-on, separate tiered message volumes, enhanced infrastructure, uptime 99,99%); both have a health check API
FAQ:
- Q: When should I choose a standard API triggered campaign? — When you do not have High Throughput contracted, your throughput needs are under 500 TPS, you require personalization based on Adobe Profiles, you want campaign data stitched to profiles for future targeting, or you want to use another channel than Email or Push.
- Q: When should I choose a High throughput campaign? — When you need throughput over 500 TPS, you do not require profile stitching, you can pass all personalization in the API payload, and you want to use the Email or Push channel.
- Q: Can a High throughput campaign use profile attributes for personalization? — No. Profile-based personalization is not supported, and validation errors occur if profile variables are used. Pass all personalization as contextual data in the API payload.
- Q: Can one campaign serve both profile-enabled and non-profile use cases? — No. Create two separate campaigns, and make the calling system decide which one to trigger.
- Q: Is throughput shared between standard and High throughput campaigns? — No. The throughput provisioned under the High Throughput add-on is exclusively reserved for High throughput campaigns.
- Q: How do I set up High throughput campaigns? — Both email and push can be self-configured in the UI. For email, create a dedicated High throughput IP pool, then create a channel configuration with the Create as a High throughput configuration toggle enabled and select that IP pool. For push, create a push channel configuration with the toggle enabled and select the platform(s) and App id(s); no IP pool is needed. App id personalization is not available for High throughput push.
Related pages:
- Personalizing content with contextual data: Learn how to personalize content using contextual data (campaigns/api-triggered-campaign-content.md#contextual)
- Endpoint used by High throughput campaigns: Execute an API triggered campaign (campaigns/trigger-campaigns.md#trigger)
- Channel configurations with profile-based personalization: profile-based personalization (email/surface-personalization.md)
- Personalized PDF attachments: Learn more about personalized PDF attachments (email/pdf-attachments.md#personalized-attachments)
- Create IP pools: Learn how to create IP pools (configuration/ip-pools.md)
- Set up channel configurations: Learn how to set up channel configurations (configuration/channel-surfaces.md)
- Set up push channel configurations: Learn how to create a push channel configuration (push/push-configuration.md#message-preset)
- Push App id personalization: Learn about push App id personalization (push/push-configuration.md#app-id-personalization)
Personas:
- developer: Can pass all personalization for High throughput campaigns as contextual data in the API payload. Can call a different API endpoint than the one used for standard API triggered campaigns. Can use the AJO Message Feedback Event Dataset - Non Profile and the AJO Email Tracking Experience Event Dataset - Non Profile for feedback and tracking. The page states that profile variables cause validation errors, and push payload size is limited to 5 KB. Where: “Guardrails & limitations”.
Onboarding:
- Level: Experienced
- First minimal step: Create a new IP pool.
- Success check: The page states a Health check API is available for the High Throughput Campaign.
- Next: Learn how to personalize content using contextual data: Edit the API triggered campaign content (campaigns/api-triggered-campaign-content.md); Learn how to set up channel configurations: Set up channel configurations (configuration/channel-surfaces.md)