En esta página: Active el modo de alto rendimiento para campañas activadas por API de modo que pueda enviar mensajes transaccionales en tiempo real a gran escala (correo electrónico y push) a un máximo de 5000 transacciones por segundo sin depender de los perfiles.
El modo de alto rendimiento está diseñado para organizaciones que necesitan mensajes transaccionales en tiempo real a gran escala (hasta 5000 transacciones por segundo). A diferencia de las campañas activadas por API normales, las campañas de alto rendimiento funcionan de forma independiente de los perfiles de Adobe y requieren un modelo de configuración diferente.
Esta página explica cómo las campañas de alto rendimiento difieren de las campañas estándar activadas por API, los requisitos de configuración y cuándo elegir cada modo.
Protecciones y limitaciones guardrails
-
Acceso: disponible en todas las regiones, excepto en Suiza, para organizaciones con licencia del complemento de mensajería transaccional de alto rendimiento.
-
Canales: notificaciones push y por correo electrónico.
-
Personalization en campañas de alto rendimiento:
- Toda personalización debe incluirse en la carga útil de la API como datos contextuales. Aprenda a personalizar el contenido mediante datos contextuales
- Se admite la personalización basada en perfiles no. Si se utilizan variables de perfil, se producirán errores de validación.
-
Personalization en configuraciones de canal de alto rendimiento: las configuraciones de canal de alto rendimiento no admiten la personalización contextual o basada en perfiles.
-
Recursos coincidentes: las campañas de alto rendimiento, las configuraciones de canal y los grupos de IP solo se pueden usar entre sí. Los recursos de rendimiento estándar y alto no se pueden mezclar.
-
Extremo de API: las campañas de alto rendimiento utilizan un extremo diferente que las campañas estándar activadas por API. Para obtener más información, consulte Ejecutar una campaña desencadenada por API.
-
Exclusividad de la campaña: las campañas de alto rendimiento no utilizan perfiles de Adobe. Los mensajes se envían independientemente de si existe o no un perfil.
Además, una campaña no se puede usar en casos de uso con y sin perfil. Si necesita ambas, cree dos campañas independientes y asegúrese de que el sistema de llamada decida cuál almacenar en déclencheur en función del contexto.
-
Conjuntos de datos para comentarios y seguimiento: los datos de comentarios y seguimiento de las campañas de alto rendimiento se almacenan en conjuntos de datos dedicados que no están habilitados para perfiles. Como resultado, estos eventos no se vinculan a perfiles, aunque exista un perfil coincidente.
Los conjuntos de datos utilizados son:
- Conjunto de datos de evento de comentarios de mensajes de AJO - Sin perfil — se usa para los comentarios de correo electrónico y push.
- Conjunto de datos de evento de experiencia de seguimiento de correo electrónico de AJO - Sin perfil - se usa solo para el seguimiento de correo electrónico. Todavía no está disponible un conjunto de datos de seguimiento dedicado que no sea de perfil para push.
-
Asignación de rendimiento: el rendimiento aprovisionado en el complemento de alto rendimiento está reservado exclusivamente para las campañas de alto rendimiento. No se comparte el rendimiento entre las campañas activadas por la API de rendimiento estándar y alto.
-
Características no admitidas:
-
Exportación de mensajes y subdominios dinámicos no son compatibles con Alto rendimiento.
-
Archivos adjuntos personalizados de PDF: no se admiten cuando el tráfico de alto rendimiento se enruta a través de la región secundaria. Más información sobre los archivos adjuntos personalizados de PDF
-
-
Notificaciones push:
- Inserción web: las campañas push web de alto rendimiento se ejecutan en una infraestructura compartida y no se benefician de la capacidad dedicada reservada para la inserción móvil de alto rendimiento.
- Tamaño de carga útil — El tamaño máximo de carga útil es 5 KB.
- Comportamiento de la Lista de bloqueados de la: cuando un mensaje llega a una lista de bloqueados de la misma, se conservan los comentarios de la entrega, pero no se producen comentarios sobre la actualización del perfil. Esto significa que las respuestas de lista de bloqueados de la no almacenan en déclencheur las actualizaciones de perfil ni la invalidación de tokens en Adobe Experience Platform.
Elección entre campañas de rendimiento estándar y campañas de alto rendimiento
Utilice esta tabla para decidir qué tipo de campaña activada por API se adapta a su caso de uso:
En otras palabras:
-
Elija campañas estándar activadas por API si:
- No tiene contratado un alto rendimiento.
- Sus necesidades de rendimiento son <500 TPS.
- Necesita una personalización basada en Perfiles de Adobe.
- Desea vincular los datos de campaña a los perfiles para una futura segmentación.
- Desea utilizar otro canal que no sea Correo electrónico o Push.
-
Elija Alto rendimiento campañas si:
- Necesita rendimiento > 500 TPS.
- No es necesario vincular perfiles.
- Puede pasar toda la personalización en la carga útil de la API.
- Desea utilizar el canal de correo electrónico o push.
Configuración de campañas activadas por API de alto rendimiento configure-high-throughput
Una vez que se cumpla el requisito previo, puede configurar el Alto rendimiento usted mismo en la interfaz de usuario del producto para ambos canales:
- Correo electrónico: cree un grupo de IP de alto rendimiento dedicado y, a continuación, una configuración de canal de correo electrónico de alto rendimiento que lo utilice. Más información
- Push: cree una configuración de canal push de alto rendimiento. Más información
Requisito previo prerequisite
Después de comprar el complemento Mensajería transaccional de alto rendimiento, póngase en contacto con el Servicio de atención al cliente de Adobe o con su representante de Adobe para que se complete la activación back-end necesaria .
Configuración de campañas de correo electrónico activadas por API de alto rendimiento setup-guidelines
Para configurar campañas de correo electrónico de alto rendimiento, siga los pasos a continuación.
Crear un grupo de IP dedicado create-ip-pool
El alto rendimiento requiere un grupo de IP dedicado, ya que está diseñado para mantener una alta disponibilidad y rendimiento en dos regiones.
Al adquirir el complemento Alto rendimiento, las direcciones IP de envío se aprovisionan en una región secundaria, además de las direcciones IP asignadas a usted en su región principal.
- Conmutación por error: si la región principal deja de estar disponible, todo el tráfico de alto rendimiento cambiará automáticamente a la región secundaria para que se sigan enviando los mensajes transaccionales.
- Calentamiento de IP: para asegurarse de que las direcciones IP de la región secundaria estén listas cuando sea necesario, parte del tráfico de alto rendimiento se enruta a través de la región secundaria de forma continua. Esto mantiene calientes estas IP. El envío desde direcciones IP sin historial de envío podría hacer que los proveedores de servicio de Internet (ISP) rechazaran sus correos electrónicos.
Cree el grupo de IP como se indica a continuación.
-
Cree un grupo de IP. Descubra cómo
-
Seleccione la opción Habilitar alto rendimiento.
-
Seleccione una o varias direcciones IP de región secundarias para el grupo de IP dedicadas. Esto garantiza una alta disponibilidad para su tráfico de alto rendimiento.
El grupo de IP dedicado ya está listo para su uso con configuraciones de canal de alto rendimiento.
Crear una configuración de canal de correo electrónico de alto rendimiento configuration-guidelines
-
Crear una configuración de canal email. Descubra cómo
-
Seleccione el tipo de correo electrónico Transaccional en Configuración de correo electrónico.
-
Habilite la opción Crear como configuración de alto rendimiento.
-
En la sección detalles del grupo de IP, seleccione el grupo de IP de alto rendimiento que creó. Solo se enumeran los grupos de IP de alto rendimiento.
-
Envíe la configuración de canal.
La configuración del canal de correo electrónico de alto rendimiento ya está lista para su uso en una campaña activada por la API de alto rendimiento.
Configuración de campañas push de alto rendimiento setup-push
Al igual que con el correo electrónico, puede configurar un alto rendimiento para la notificación automática, directamente en la interfaz. Para ello, siga los pasos que aparecen a continuación.
-
Crear una configuración de canal push. Descubra cómo
-
Habilite la opción Crear como configuración de alto rendimiento.
-
Seleccione las plataformas y los ID de aplicación correspondientes para la configuración push.
note NOTE Cuando la opción Alto rendimiento está habilitada, la personalización del ID de la aplicación push no está disponible. -
Envíe la configuración de canal.
La configuración del canal push de alto rendimiento ya está lista para su uso en una campaña activada por la API de alto rendimiento.
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)