In questa pagina: attiva la modalità Alta velocità per le campagne attivate da API in modo da poter inviare messaggi transazionali in tempo reale su larga scala (e-mail e push) fino a 5000 transazioni al secondo senza affidarsi ai profili.
La modalità High Throughput è progettata per le organizzazioni che necessitano di messaggi transazionali su vasta scala e in tempo reale (fino a 5000 transazioni al secondo). A differenza delle normali campagne attivate da API, le campagne a throughput elevato operano in modo indipendente dai profili di Adobe e richiedono un modello di configurazione diverso.
Questa pagina spiega come le campagne a throughput elevato differiscono dalle campagne standard attivate da API, dai requisiti di configurazione e da quando scegliere ogni modalità.
Guardrail e limitazioni guardrails
-
Accesso - Disponibile in tutte le aree geografiche, ad eccezione della Svizzera, per le organizzazioni con licenza del componente aggiuntivo Messaggistica transazionale ad alta velocità.
-
Canali: notifiche e-mail e push.
-
Personalization in campagne ad alta velocità:
- Tutte le personalizzazioni devono essere incluse nel payload API come dati contestuali. Scopri come personalizzare il contenuto utilizzando i dati contestuali
- La personalizzazione basata sul profilo è non supportata. Se si utilizzano variabili di profilo, si verificheranno errori di convalida.
-
Personalization nelle configurazioni dei canali con throughput elevato - Le configurazioni dei canali con throughput elevato non supportano la personalizzazione contestuale o basata su profili.
-
Risorse corrispondenti - Le campagne a throughput elevato, le configurazioni dei canali e i pool IP possono essere utilizzati solo tra loro. Le risorse con throughput standard e elevato non possono essere combinate.
-
Endpoint API - Le campagne a throughput elevato utilizzano un endpoint diverso dalle campagne standard attivate da API. Per ulteriori dettagli, vedere Eseguire una campagna attivata da API.
-
Esclusività campagna - Le campagne a velocità elevata non utilizzano i profili di Adobe. I messaggi vengono consegnati indipendentemente dal fatto che esista o meno un profilo.
Inoltre, non è possibile utilizzare una campagna sia per i casi di utilizzo abilitati che per quelli non abilitati per il profilo. Se ti servono entrambe, crea due campagne separate e assicurati che il sistema chiamante decida quale attivare in base al contesto.
-
Set di dati per il feedback e il tracciamento - I dati di feedback e tracciamento per le campagne con throughput elevato vengono memorizzati in set di dati dedicati che non sono abilitati per i profili. Di conseguenza, questi eventi non vengono uniti ai profili, anche se esiste un profilo corrispondente.
I set di dati utilizzati sono:
- Set di dati evento di feedback dei messaggi di AJO - Non profilo - utilizzato sia per le e-mail che per il feedback push.
- Set di dati evento esperienza tracciamento e-mail AJO - Non profilo - utilizzato solo per il tracciamento e-mail. Non è ancora disponibile un set di dati dedicato di tracciamento non di profilo per il push.
-
Allocazione throughput - Il throughput fornito con il componente aggiuntivo High Throughput è riservato esclusivamente alle campagne High Throughput. Non esiste alcuna condivisione della velocità effettiva tra le campagne standard e High throughput attivate da API.
-
Funzioni non supportate:
-
Esportazione messaggi e sottodomini dinamici non sono supportati per Alta velocità.
-
Allegati PDF personalizzati - Non supportati quando il traffico a velocità effettiva elevata viene instradato attraverso l’area secondaria. Ulteriori informazioni sugli allegati personalizzati di PDF
-
-
Notifiche push:
- Web push: le campagne Web push ad alta velocità vengono eseguite su un’infrastruttura condivisa e non beneficiano della capacità dedicata riservata per i dispositivi mobili push ad alta velocità.
- Dimensione payload — La dimensione massima del payload è 5 KB.
- Comportamento di Inserita nell’elenco Bloccati del messaggio di: quando un messaggio viene visualizzato su un inserisco nell’elenco Bloccati di consegna, il feedback viene mantenuto ma non viene generato alcun feedback di aggiornamento del profilo. Ciò significa che le risposte di inserisce nell’elenco Bloccati di Adobe Experience Platform non attivano gli aggiornamenti del profilo o l’annullamento della validità del token.
Scelta tra campagne standard e campagne a throughput elevato
Utilizza questa tabella per decidere quale tipo di campagna attivato da API è adatto al tuo caso d’uso:
In altre parole:
-
Scegli campagne attivate da API standard se:
- Non si dispone di un contratto per la velocità effettiva elevata.
- Il throughput richiesto è <500 TPS.
- È necessaria la personalizzazione basata sui profili Adobe.
- Desideri che i dati della campagna siano uniti ai profili per il targeting futuro.
- Desideri utilizzare un canale diverso da E-mail o Push.
-
Scegli Alta velocità campagne se:
- Hai bisogno di un throughput > 500 TPS.
- Non è necessario unire i profili.
- Puoi trasmettere tutte le personalizzazioni nel payload API.
- Desideri utilizzare il canale e-mail o push.
Configurare campagne attivate da API a throughput elevato configure-high-throughput
Una volta soddisfatti i prerequisiti, puoi impostare autonomamente un throughput elevato nell’interfaccia utente del prodotto per entrambi i canali:
- E-mail: crea un pool IP ad alta velocità dedicato, quindi una configurazione del canale e-mail ad alta velocità che lo utilizza. Ulteriori informazioni
- Push: crea una configurazione del canale push con throughput elevato. Ulteriori informazioni
Prerequisito prerequisite
Dopo aver acquistato il componente aggiuntivo Messaggistica transazionale ad alta velocità, contatta l’Assistenza clienti Adobe o il tuo rappresentante Adobe in modo che sia possibile completare l’attivazione del back-end richiesta .
Configurare campagne e-mail attivate da API a throughput elevato setup-guidelines
Per configurare le campagne e-mail a velocità elevata, segui i passaggi indicati di seguito.
Creare un pool IP dedicato create-ip-pool
Un throughput elevato richiede un pool IP dedicato perché è progettato per mantenere elevata disponibilità e prestazioni in due aree geografiche.
Quando si acquista il componente aggiuntivo High throughput, gli IP di invio vengono predisposti in un’area secondaria, oltre agli IP assegnati all’utente nell’area principale.
- Failover - Se l’area principale non è più disponibile, tutto il traffico a velocità elevata passa automaticamente all’area secondaria, in modo che i messaggi transazionali continuino a essere recapitati.
- Riscaldamento IP - Per assicurarsi che gli IP dell’area secondaria siano pronti quando necessario, parte del traffico ad alta velocità viene indirizzato continuamente all’area secondaria. In questo modo gli IP vengono mantenuti al caldo. L’invio da IP senza cronologia di invio potrebbe causare il rifiuto delle e-mail da parte dei provider di servizi Internet (ISP).
Creare il pool IP nel modo seguente.
-
Creare un pool IP. Scopri come
-
Selezionare l’opzione Abilita throughput elevato.
-
Seleziona uno o più IP dell’area secondaria per il pool IP dedicato. In questo modo è possibile garantire un’elevata disponibilità per il traffico a velocità elevata.
Il pool IP dedicato è ora pronto per essere utilizzato con configurazioni di canali ad alta velocità.
Creare una configurazione del canale e-mail a throughput elevato configuration-guidelines
-
Crea una configurazione del canale email. Scopri come
-
Seleziona il tipo di e-mail Transazionale nelle Impostazioni e-mail.
-
Abilita l’interruttore Crea come configurazione a throughput elevato.
-
Nella sezione Dettagli pool IP selezionare il pool IP ad alta velocità creato. Sono elencati solo i pool IP a throughput elevato.
-
Invia la configurazione del canale.
La configurazione del canale e-mail a throughput elevato è ora pronta per essere utilizzata in una campagna attivata da API a throughput elevato.
Configurare campagne push a throughput elevato setup-push
Come per l’e-mail, puoi impostare un throughput elevato per inviare messaggi push direttamente nell’interfaccia. A questo scopo, segui i passaggi riportati qui sotto.
-
Crea una configurazione del canale push. Scopri come
-
Abilita l’interruttore Crea come configurazione a throughput elevato.
-
Seleziona le piattaforme e gli ID app corrispondenti per la configurazione push.
note NOTE Quando l'opzione Alta velocità è abilitata, la personalizzazione dell'ID app push non è disponibile. -
Invia la configurazione del canale.
La configurazione del canale push ad alta velocità è ora pronta per essere utilizzata in una campagna attivata da API ad alta velocità.
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)