Nesta página: Entenda os três tipos de eventos, seus requisitos de esquema, as principais restrições e como escolher o correto para seu caso de uso.
Use eventos para acionar jornadas individualmente, fornecendo mensagens em tempo real a cada usuário ao entrarem na jornada. Na configuração do evento, configure os eventos esperados nas jornadas. Você pode usar vários eventos (em diferentes etapas de uma jornada), e várias jornadas podem usar o mesmo evento.
A configuração do evento é obrigatória e deve ser executada por um engenheiro de dados.
-
Antes de configurar os eventos, verifique se você tem: a função de Administrador do Journey Optimizer ou Engenheiro de Dados, um esquema XDM com o Perfil de Cliente em Tempo Real habilitado, um ponto de extremidade de transmissão ativo e acesso à sandbox correta.
-
Para obter os requisitos e as limitações do evento (transmissão, Serviço de consulta, assimilação em lote), consulte medidas de proteção de Jornada - Eventos.
Quem faz o quê:
Você pode configurar três tipos de eventos: Eventos unitários, Eventos comerciais e Eventos de qualificação de público-alvo.
Eventos unitários unitary-events
Unitário eventos estão vinculados a uma pessoa. Elas estão relacionadas ao comportamento de uma pessoa (por exemplo, uma pessoa comprou um produto, visitou uma loja, saiu de um site etc.) ou um acontecimento ligado a uma pessoa (por exemplo, uma pessoa atingiu 10.000 pontos no programa de fidelidade). É o que o Journey Optimizer considera nas jornadas para orquestrar as melhores ações futuras. Os eventos unitários podem ser baseados em regras ou gerados pelo sistema. Saiba como criar um evento unitário.
Requisito de esquema: um esquema XDM ExperienceEvent com uma identidade principal baseada em pessoa e Perfil de Cliente em Tempo Real habilitado.
Exemplo: um cliente adiciona itens ao carrinho e fecha o navegador. Um evento abandonado no carrinho é acionado, o perfil entra na jornada em tempo real e recebe um email de recuperação uma hora depois.
Eventos de negócios business-events
Os eventos de Negócios não estão vinculados a um perfil específico. Por exemplo, pode ser um alerta de notícias, uma atualização esportiva, uma alteração ou cancelamento de voo, uma atualização de inventário, eventos meteorológicos etc. Embora esses eventos não sejam específicos de um perfil, eles podem ser de interesse para qualquer número de perfis: indivíduos inscritos em tópicos de notícias específicos, passageiros em um voo, compradores interessados em um produto indisponível, etc. Os eventos comerciais sempre se baseiam em regras. Quando você solta um evento comercial em uma jornada, ele adiciona automaticamente uma atividade Ler público-alvo, logo em seguida. Saiba como criar um evento comercial.
Requisito de esquema: um esquema XDM de série temporal com uma identidade primária que não seja de pessoa e os campos _id e timestamp preenchidos. Planeje um atraso na exportação de público de 15 minutos a até uma hora.
Exemplo: uma companhia aérea cancela um voo. Um evento comercial é disparado, Journey Optimizer lê o público dos passageiros afetados e envia a cada um uma notificação de reagendamento.
Eventos de qualificação de público-alvo audience-qualification-events
Um evento de qualificação de público-alvo é acionado quando um perfil entra ou sai de um público-alvo. Por exemplo, um cliente que ultrapassa um limite de gastos de fidelidade entra no público-alvo da camada Gold — essa qualificação aciona a jornada desse perfil em tempo real (para públicos de transmissão) ou na próxima avaliação em lote. Diferentemente dos eventos unitários, a qualificação de público-alvo permite criar uma lógica de acionamento complexa usando o poder total das definições de público-alvo, sem exigir alterações de implementação para enviar um novo evento. Saiba mais sobre eventos de qualificação de público.
Requisito de esquema: Nenhum esquema adicional necessário — o evento depende de definições de público-alvo existentes já incorporadas no Adobe Experience Platform.
Exemplo: o gasto de fidelidade de um cliente ultrapassa o limite da camada Ouro. Seu perfil se qualifica para o público-alvo Gold, a jornada é acionada automaticamente e envia uma recompensa de boas-vindas.
Principais tipos de evento event-comparison
Tipo de ID do evento event-id-type
Para eventos de negócios, o tipo de ID de evento sempre é baseado em regras.
Para eventos unitários, há dois tipos de ID de evento:
-
Eventos baseados em regras: esse tipo de evento não gera uma eventID. Usando o editor de expressões simples, basta definir uma regra que será usada pelo sistema para identificar os eventos relevantes que acionarão suas jornadas. Essa regra pode ser baseada em qualquer campo disponível na carga do evento, por exemplo, o local do perfil ou o número de itens adicionados ao carrinho do perfil.
note caution CAUTION Uma regra de limite é definida para eventos baseados em regras. Limita o número de eventos qualificados que uma jornada pode processar para 5.000 por segundo em uma determinada organização. Corresponde aos SLAs do Journey Optimizer. Consulte seu licenciamento da Journey Optimizer e a Descrição do Produto da Journey Optimizer. -
Eventos gerados pelo sistema: esses eventos exigem uma eventID. Esse campo eventID é gerado automaticamente ao criar o evento. O sistema que envia o evento não deve gerar uma ID, mas sim passar a disponível na pré-visualização de carga.
- Eventos assimilados em lote
- Eventos inseridos via Serviço de consulta
- Eventos de conjuntos de dados internos Journey Optimizer (Feedback de Mensagem, Rastreamento de Email e similares)
Como escolher choose-event-type
Use os critérios a seguir para selecionar o tipo de evento correto para sua jornada — a pergunta principal é: você está acionando uma ação para uma pessoa específica ou transmitindo para muitos perfis? Saiba mais sobre os tipos de jornada.
Cada tipo de evento mapeia para um padrão de jornada específico:
-
Escolha um evento unitário quando o acionador estiver vinculado a um indivíduo específico, por exemplo, uma compra, um envio de formulário ou um marco de fidelidade. Os eventos unitários exigem uma identidade principal baseada em pessoas no esquema e iniciam a jornada imediatamente para esse perfil. Saiba como configurar um evento unitário.
-
Escolha um evento comercial quando o gatilho for uma ocorrência global — por exemplo, um reabastecimento de produto, uma queda de preço ou um cancelamento de voo — e você quiser transmitir para um conjunto de perfis relacionados a esse sinal. Os eventos comerciais devem ser a primeira etapa na jornada e direcionar perfis automaticamente por meio de uma atividade Ler público. Eles exigem um esquema de série temporal com uma identidade primária que não seja de pessoas e os campos
_idetimestamp. Planeje um atraso na exportação de público de 15 minutos a até uma hora. Saiba como configurar um evento comercial. -
Escolha um evento de qualificação de público-alvo quando o acionador for um perfil entrando ou saindo de um público-alvo, e você precisar de uma lógica de segmentação mais complexa do que um único evento pode fornecer — por exemplo, reengajar clientes que acabaram de atingir um limite de gastos ou acionar um fluxo de integração quando um membro do VIP sair do nível de fidelidade. Saiba mais sobre eventos de qualificação de público-alvo.
Restrições principais key-constraints
Use este resumo para planejar sua implementação antes de configurar os eventos.
Como os eventos chegam à Journey Optimizer data-cycle
Os eventos devem ser enviados para Journey Optimizer como chamadas POST por meio de APIs de assimilação de streaming do Adobe Experience Platform. A carga deve seguir a formatação XDM e o esquema de evento deve ter o Perfil de Cliente em Tempo Real habilitado.
Os modos de transmissão autenticados e não autenticados são compatíveis. Eventos e eventos assimilados em lote de conjuntos de dados internos Journey Optimizer (feedback de mensagem, rastreamento de email e similares) não podem ser usados para acionar jornadas — use uma atividade Ler público nesses casos de uso.
Limites de taxa de transferência de eventos event-throughput
A Adobe Journey Optimizer impõe limites de taxa de transferência separados por tipo de evento, em nível de organização, em todas as sandboxes:
- Eventos unitários: 5.000 eventos por segundo
- Ler eventos de jornada baseados em público-alvo: 5.000 eventos por segundo
Esses limites se aplicam a todos os eventos usados no jornada ativo, que inclui as jornadas Live, Dry run, Closed e Paused. Quando um limite é atingido, novos eventos são enfileirados e processados a 5.000 por segundo até que a fila seja esgotada.
Para obter mais detalhes sobre as taxas de processamento da jornada e como diferentes tipos de jornada afetam a taxa de transferência, saiba mais sobre as taxas de processamento da jornada.
Os seguintes tipos de eventos são contados para essas cotas:
-
Eventos Unitários Externos: Inclui eventos com base em regras e gerados pelo sistema. Se o mesmo evento bruto se qualificar para várias definições de regra, cada regra correspondente contará como um evento separado na cota.
-
Eventos de qualificação de público-alvo: se o mesmo público-alvo de streaming for usado em várias jornadas, cada uso será contado separadamente. Por exemplo, usar o mesmo público-alvo em uma atividade de qualificação de público-alvo em duas jornadas resulta na contagem de dois eventos.
-
Eventos de Reação: eventos acionados por reações de perfil (email aberto, email clicado, etc.) em uma jornada.
-
Eventos comerciais: eventos não vinculados a um perfil específico, mas a um evento comercial.
-
Eventos do Analytics: se a integração com o Adobe Analytics para acionar o jornada tiver sido habilitada, esses eventos também serão incluídos.
-
Retomar Eventos: evento técnico disparado quando um perfil é retomado de uma jornada pausada. Saiba mais sobre retomada de jornadas pausadas.
-
Eventos de Conclusão do Nó de Espera: quando um perfil sai de um nó de espera, um evento técnico é gerado para retomar a jornada.
Atualizar e deletar um evento update-event
Para evitar a quebra de jornadas existentes, ao editar um evento usado em uma jornada do Rascunho, do Ao Vivo ou do Fechado, você só poderá alterar o nome, a descrição ou adicionar campos de carga.
Não é possível excluir nenhum evento usado nas jornadas do Live, Rascunho ou Fechadas. Para excluir um evento usado, você deve interromper as jornadas que o utilizam e/ou removê-lo das jornadas de rascunho onde é usado. Você pode verificar o campo Usado em. Ele exibe o número de jornadas que usam esse evento específico. Você pode clicar no botão Exibir jornadas para exibir a lista de jornadas correspondentes.
Perguntas frequentes faq
Posso usar o mesmo evento em várias jornadas?
Sim — várias jornadas podem ouvir o mesmo evento simultaneamente.
É possível combinar um evento comercial e um evento unitário na mesma jornada?
Não — eventos comerciais não podem ser usados na mesma jornada que eventos unitários ou atividades de qualificação de público-alvo.
Preciso configurar algo para os eventos de qualificação de público-alvo?
Não — os eventos de qualificação de público-alvo não estão configurados em Administração > Eventos. Selecione o público diretamente na tela de jornada como a primeira etapa.
Posso usar dados assimilados em lote para acionar uma jornada?
Não — somente eventos transmitidos podem acionar jornadas. Para dados em lote, crie um público-alvo e use uma atividade Ler público-alvo.
Minha jornada não está sendo acionada. O que devo verificar?
- Verifique se o esquema de evento tem o Perfil de Cliente em Tempo Real habilitado.
- Confirme se os eventos são transmitidos — os eventos assimilados em lote não podem acionar jornadas.
- Para eventos baseados em regras, verifique se a condição da regra corresponde aos campos de carga útil de entrada.
- Verifique se a jornada está no status Live e se o perfil atende a alguma condição de entrada.
Próximas etapas next-steps
Vídeos tutoriais video
Saiba como configurar um evento, especificar o ponto final de transmissão e a carga útil de um evento.
Entenda os casos de uso aplicáveis a eventos de negócios. Saiba como criar uma jornada usando um evento de negócios e quais práticas recomendadas devem ser aplicadas.
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 describes the three journey event types (unitary, business, and audience qualification), their schema requirements and key constraints, how to choose the right one, throughput limits, and how events reach Journey Optimizer.
Intents:
- Understand the differences between unitary, business, and audience qualification events
- Choose the right event type for a use case based on whether you target one person or many profiles
- Learn the schema requirements and entry behavior for each event type
- Understand event ID types and which events can trigger journeys
- Plan for throughput limits and reentrance behavior before configuring events
- Know what can be changed or deleted on an event used in a journey
Glossary:
- Unitary event: An event linked to a person, based on their behavior, which can be rule-based or system generated and starts a real-time single-profile journey (product-specific)
- Business event: An event not linked to a specific profile, always rule-based, that automatically adds a Read Audience activity and broadcasts to many profiles (product-specific)
- Audience qualification event: An event triggered when a profile enters or exits an audience, selected directly on the journey canvas rather than in Administration (product-specific)
- Read Audience activity: The activity automatically added after a business event to define which profiles receive the journey (product-specific)
- Rule-based event: A unitary or business event that does not generate an eventID and instead defines a rule used to identify relevant events (product-specific)
- System-generated event: A unitary event that requires an eventID, automatically generated when the event is created (product-specific)
Guardrails:
- Event configuration is mandatory and must be performed by a Data engineer; prerequisites are the Journey Optimizer Administrator or Data Engineer role, an XDM schema with Real-Time Customer Profile enabled, an active streaming endpoint, and access to the correct sandbox.
- Throughput is limited to 5,000 events per second per organization, across all sandboxes, for unitary events and for Read Audience based journey events (hard limit); when a limit is reached, new events are queued and processed at 5,000 per second until the queue is drained.
- A capping rule limits rule-based events to 5,000 qualified events per second for a given Organization, corresponding to Journey Optimizer SLAs.
- Throughput limits apply to all events used in active journeys, which includes Live, Dry run, Closed, and Paused journeys.
- Profile reentrance is blocked by default for 5 minutes after a unitary journey triggers.
- A journey can contain only one business event, which must be the first step; business events cannot be used in the same journey as unitary events or audience qualification activities.
- Only streamed events can trigger journeys; events ingested in batch, inserted via Query Service, or from internal Journey Optimizer datasets cannot, and a Read Audience activity should be used instead.
- Unitary events require an XDM ExperienceEvent schema with a person-based primary identity and Real-Time Customer Profile enabled; business events require a time-series schema with a non-person primary identity and populated
_idandtimestampfields, with an audience export delay of 15 minutes to up to one hour. - When editing an event used in a Draft, Live, or Closed journey, you can only change the name, the description, or add payload fields; events used in Live, Draft, or Closed journeys cannot be deleted.
Terminology:
- Canonical name: Journey event — Acronym: n/a — variants: event, journey trigger event
- Do not confuse: “Unitary event” (linked to a specific person) ≠ “Business event” (external occurrence not tied to one person) ≠ “Audience qualification event” (triggered when a profile enters or exits an audience)
- Do not confuse: “Rule-based” (defines a rule, no eventID generated) ≠ “System-generated” (requires an automatically generated eventID)
FAQ:
- Q: Can I use the same event in multiple journeys? — Yes, several journeys can listen to the same event simultaneously.
- Q: Can I combine a business event and a unitary event in the same journey? — No, business events cannot be used in the same journey as unitary events or audience qualification activities.
- Q: Do I need to configure anything for audience qualification events? — No, they are not configured in Administration > Events; the audience is selected directly on the journey canvas as the first step.
- Q: Can I use batch-ingested data to trigger a journey? — No, only streamed events can trigger journeys; for batch data, build an audience and use a Read Audience activity instead.
- Q: What is the throughput limit for events? — 5,000 events per second per organization, across all sandboxes, for unitary events and for Read Audience based journey events.
- Q: My journey is not triggering — what should I check? — Verify the event schema has Real-Time Customer Profile enabled, confirm events are streamed, check that rule-based conditions match the incoming payload, and confirm the journey is in Live status with the profile meeting any entry conditions.