Ativar modo de alta taxa de transferência para campanhas acionadas por API high-throughput

Nesta página: ative o modo de alta taxa de transferência para campanhas acionadas por API para enviar mensagens transacionais em tempo real em grande escala (email e push) em até 5.000 transações por segundo sem depender de perfis.

O modo de alta taxa de transferência foi projetado para organizações que precisam de mensagens transacionais em tempo real de grande escala (até 5.000 transações por segundo). Diferentemente de campanhas acionadas por API comuns, as campanhas de alta taxa de transferência operam independentemente dos perfis do Adobe e exigem um modelo de configuração diferente.

Esta página explica como as campanhas com alta taxa de transferência diferem das campanhas acionadas por API padrão, dos requisitos de configuração e de quando escolher cada modo.

Medidas de proteção e limitações guardrails

  • Acesso - Disponível em todas as regiões, exceto na Suíça para organizações licenciadas com o complemento de mensagens transacionais de alta taxa de transferência.

  • Canais: notificações por email e por push.

  • Personalization em campanhas de alta taxa de transferência:

  • Personalization em configurações de canal de alta taxa de transferência - As configurações de canal de alta taxa de transferência não oferecem suporte à personalização contextual ou baseada em perfil.

  • Recursos correspondentes - Campanhas de alta taxa de transferência, configurações de canal e pools de IP só podem ser usados entre si. Os recursos padrão e de alta taxa de transferência não podem ser misturados.

  • Ponto de extremidade de API - As campanhas de alta taxa de transferência usam um ponto de extremidade diferente das campanhas acionadas por API padrão. Para obter detalhes, consulte Executar uma campanha acionada por API.

  • Exclusividade da campanha - Campanhas de alta taxa de transferência não usam Perfis do Adobe. As mensagens são entregues independentemente de um perfil existir ou não.

    Além disso, uma campanha não pode ser usada para casos de uso habilitados para perfil e não perfis. Se precisar de ambos, crie duas campanhas separadas e verifique se o sistema de chamada decide qual delas acionar com base no contexto.

  • Conjuntos de dados para feedback e rastreamento - Os dados de feedback e rastreamento para campanhas de alta taxa de transferência são armazenados em conjuntos de dados dedicados que não estão habilitados para perfis. Como resultado, esses eventos não são compilados em perfis, mesmo se um perfil correspondente existir.

    Os conjuntos de dados usados são:

    • Conjunto de Dados de Eventos de Comentários de Mensagens do AJO - Não Perfil — usado para comentários de email e push.
    • Conjunto de Dados de Evento de Experiência de Acompanhamento de Email do AJO - Não Perfil — usado apenas para rastreamento de email. Um conjunto de dados de rastreamento não relacionado a perfis para push ainda não está disponível.
  • Alocação de taxa de transferência - A taxa de transferência provisionada no complemento High throughput é reservada exclusivamente para campanhas High throughput. Não há compartilhamento de taxa de transferência entre campanhas padrão e campanhas acionadas por API de alta taxa de transferência.

  • Recursos sem suporte:

  • Notificações por push:

    • Push da Web — Campanhas de push da Web de alta taxa de transferência são executadas em infraestrutura compartilhada e não se beneficiam da capacidade dedicada reservada para push móvel de alta taxa de transferência.
    • Tamanho da carga — O tamanho máximo da carga é 5 KB.
    • comportamento de Inclui na lista de bloqueios — Quando uma mensagem atinge uma inclui na lista de bloqueios de, o feedback de entrega é retido, mas não é produzido nenhum feedback de atualização de perfil. Isso significa que as respostas de inclui na lista de bloqueios do não acionam atualizações de perfil ou invalidação de token no Adobe Experience Platform.

Escolha entre campanhas com taxa de transferência padrão vs. alta

Use esta tabela para decidir qual tipo de campanha acionada por API se adapta ao seu caso de uso:

Recurso/Requisito
Campanha padrão acionada por API
Campanha com alta taxa de transferência
Disponibilidade
Incluído na oferta base
Exige add-on de mensagens transacionais de alta taxa de transferência.
Taxa de transferência
Até 500 transações por segundo
Até 5.000 transações por segundo
Canais
Email, Mensagem para dispositivo móvel, Push
Email, Push
Personalização
Perfil + contextual na carga da API
Contextual somente na carga da API
Compilação e perfil
Existe ou é criado com eventos compilados no perfil
Nenhum perfil
Volume da mensagem
Pacotes de mensagens e direitos padrão
Separar volumes de mensagens em camadas
Infraestrutura
Standard
Aprimorado
Tempo de atividade
99,9%
99,99%
API de verificação de integridade
Sim
Sim

Em outras palavras:

  • Escolha campanhas acionadas por API padrão se:

    • Você não contratou a opção Alto rendimento.
    • Suas necessidades de throughput são <500 TPS.
    • Você precisa de personalização com base nos perfis do Adobe.
    • Você deseja que os dados da campanha sejam compilados com perfis para direcionamento futuro.
    • Você deseja usar outro canal diferente de Email ou Push.
  • Escolha campanhas de Alta taxa de transferência se:

    • Você precisa de throughput >500 TPS.
    • Você não precisa de compilação de perfil.
    • Você pode transmitir toda a personalização na carga da API.
    • Você deseja usar o canal de email ou push.

Configurar campanhas acionadas por API de alta taxa de transferência configure-high-throughput

Depois que o pré-requisito for atendido, você poderá configurar a opção Alta taxa de transferência na interface do usuário do produto para ambos os canais:

  • Email: crie um pool de IPs dedicado de alta taxa de transferência e, em seguida, uma configuração de canal de email de alta taxa de transferência que o utilize. Saiba mais
  • Push: criar uma configuração de canal de push de alta taxa de transferência. Saiba mais
CAUTION
As configurações de canal de alta taxa de transferência (e, para email, pools de IP) só podem ser usadas com campanhas acionadas por API de alta taxa de transferência. Seu tipo não pode ser alterado após a criação: um recurso padrão não pode ser convertido para Alta taxa de transferência e vice-versa.

Pré-requisito prerequisite

Depois de comprar o complemento Mensagens transacionais de alta taxa de transferência, entre em contato com o Atendimento ao Cliente da Adobe ou com o seu representante da Adobe para que a ativação de back-end necessária possa ser concluída.

NOTE
Você só precisa fazer isso uma vez, não para cada configuração de canal.

Configurar campanhas de email acionadas por API de alta taxa de transferência setup-guidelines

Para configurar campanhas de email de alta taxa de transferência, siga as etapas abaixo.

Criar um pool de IP dedicado create-ip-pool

Alto throughput requer um pool de IP dedicado porque ele foi criado para manter a alta disponibilidade e o desempenho em duas regiões.

Ao comprar o complemento High throughput, os IPs de envio são provisionados em uma região secundária, além dos IPs alocados a você na região primária.

  • Failover - Se a região primária se tornar indisponível, todo o tráfego de Alta taxa de transferência será alternado automaticamente para a região secundária, de modo que suas mensagens transacionais continuem sendo entregues.
  • Aquecimento de IP - Para garantir que os IPs da região secundária estejam prontos quando necessário, parte do seu tráfego de Alta taxa de transferência é roteada pela região secundária de forma contínua. Isso mantém esses IPs aquecidos. O envio de IPs sem histórico de envio pode fazer com que os provedores de serviços de Internet (ISPs) rejeitem seus emails.

Crie o pool de IP da seguinte maneira.

  1. Crie um pool de IPs. Saiba como

  2. Selecione a opção Habilitar alta taxa de transferência.

  3. Selecione um ou mais IPs de região secundária para o pool de IPs dedicado. Isso garante alta disponibilidade para seu tráfego de alto throughput.

    Tela de criação do pool de IP com a opção Habilitar alta taxa de transferência selecionada

O pool de IP dedicado agora está pronto para uso com configurações de canal de alta taxa de transferência.

Criar uma configuração de canal de email de alta taxa de transferência configuration-guidelines

  1. Crie uma configuração de canal de email. Saiba como

  2. Selecione o tipo de email Transacional nas Configurações de email.

  3. Habilite a opção Criar como configuração de alta taxa de transferência.

    Configuração de canal de email de alta taxa de transferência

  4. Na seção Detalhes do pool de IPs, selecione o pool de IPs de alta taxa de transferência que você criou. Somente pools de IP de alta taxa de transferência são listados.

  5. Envie a configuração do canal.

Sua configuração de canal de email de alta taxa de transferência agora está pronta para uso em uma campanha acionada por API de alta taxa de transferência.

NOTE
Ao criar uma campanha de email acionada pela API de alta taxa de transferência, somente as configurações de canal de alta taxa de transferência estarão disponíveis para seleção.

Configurar campanhas por push de alta taxa de transferência setup-push

Assim como no email, você pode configurar a Alta taxa de transferência para enviar a si mesmo, diretamente na interface do. Para isso, siga as etapas abaixo.

  1. Criar uma configuração de canal de push. Saiba como

  2. Habilite a opção Criar como configuração de alta taxa de transferência.

    Configuração de canal de push de alta taxa de transferência {width="80%"}

  3. Selecione as plataformas e as IDs do aplicativo correspondentes para a configuração de push.

    note
    NOTE
    Quando a opção Alta taxa de transferência está habilitada, a personalização da ID do Aplicativo de push não está disponível.
  4. Envie a configuração do canal.

Sua configuração de canal de push de alta taxa de transferência agora está pronta para uso em uma campanha acionada por API de alta taxa de transferência.

NOTE
Ao criar uma campanha de push acionada por API de alta taxa de transferência, somente as configurações de canal de alta taxa de transferência estarão disponíveis para seleção.
AI Knowledge Reference

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)
recommendation-more-help
journey-optimizer-help