Trabalhar com eventos de jornada about-events

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.

IMPORTANT
  • 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ê:

Tarefa
Função
Projetar e criar o esquema XDM
Engenheiro de dados
Configurar o ponto de extremidade de transmissão
Engenheiro de dados
Configurar eventos unitários e comerciais (Administração > Eventos)
Engenheiro de dados ou administrador
Usar eventos em uma jornada
Profissional de Jornada
Configurar eventos de qualificação de público (selecionado na tela)
Profissional de Jornada

Você pode configurar três tipos de eventos: Eventos unitários, Eventos comerciais e Eventos de qualificação de público-alvo.

➡️ Conheça este recurso no vídeo

➡️ Conheça este recurso no vídeo

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.

NOTE
As jornadas unitárias incluem uma proteção de reentrada: a reentrada do perfil é bloqueada por padrão por 5 minutos após o acionamento da jornada. Por exemplo, se um evento acionar uma jornada em 12:01 para um perfil e outra chegar em 12:03, a jornada não será reiniciada para esse perfil.

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.

NOTE
Os eventos de qualificação de público-alvo não estão configurados em Administration > Events — eles são selecionados diretamente na tela de jornada como a primeira etapa de uma jornada.

Principais tipos de evento event-comparison

Evento unitário
Evento comercial
Evento de qualificação de público
Vinculado a um perfil?
Sim — acionado pela ação de um indivíduo específico.
Não — acionado por uma ocorrência externa não vinculada a uma pessoa.
Sim — acionado quando um perfil entra ou sai de um público-alvo.
Comportamento da entrada
Um perfil entra na jornada em tempo real.
Vários perfis são inseridos por meio de uma etapa automática Ler público.
Um perfil é inserido quando a associação de público-alvo é alterada.
Casos de uso típicos
Recuperação de abandono de carrinho, envio de formulário, logon no aplicativo, marco de fidelidade.
Cancelamento de voo, alerta de reposição de estoque, últimas notícias, evento meteorológico.
Reengajamento de clientes obsoletos, alterações no nível de fidelidade, fluxos de integração do VIP.
Como ele inicia a jornada
Entrada baseada em eventos — nenhum público-alvo necessário.
Evento comercial + Público-alvo de leitura automático (adicionado pelo Journey Optimizer).
O perfil entra ou sai de um público-alvo definido.
Vários por jornada?
Sim — você pode ouvir vários eventos unitários nas etapas do jornada.
Não — somente um evento comercial por jornada, colocado no início.
Sim — pode ser combinado com outras atividades.
Tipo de ID do evento
Baseado em regras ou gerado pelo sistema.
Sempre com base em regras.
Nenhuma ID de evento — com base na avaliação da associação de público-alvo.
Configurado na Administração?
Sim
Sim
Não — selecionado diretamente na tela de jornada.
NOTE
Uma jornada pode conter apenas um evento comercial, que deve ser a primeira atividade. O Journey Optimizer adiciona automaticamente uma atividade Read Audience após ela para definir quais perfis recebem a jornada acionada por esse evento.

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.

NOTE
Somente eventos transmitidos podem acionar jornadas. O seguinte não pode ser usado para disparar uma jornada:
  • 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)
Se não for possível obter eventos transmitidos, crie um público-alvo com base nesses eventos e use uma atividade Ler público-alvo. Para usar eventos somente para segmentação, habilite o conjunto de dados para Perfil de cliente em tempo real.

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:

Tipo de evento
Padrão de jornada
Evento unitário
Jornada em tempo real e em um único perfil — acionada imediatamente quando uma pessoa atua
Evento comercial
Jornada de transmissão — segmenta muitos perfis por meio de uma etapa automática Ler público
Evento de qualificação de público
Jornada acionada por segmento — acionada quando um perfil entra ou sai de um público-alvo
  • 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 _id e timestamp. 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.

CAUTION
Os eventos comerciais não podem ser usados na mesma jornada que os eventos unitários ou as atividades de qualificação de público.

Restrições principais key-constraints

Use este resumo para planejar sua implementação antes de configurar os eventos.

Restrição
Detalhes
Limite de taxa de transferência
5.000 eventos por segundo por organização, em todas as sandboxes (jornadas unitárias e de leitura de público)
Bloco de reentrada
Reentrada de perfil bloqueada por 5 minutos após o acionamento de uma jornada unitária
Eventos comerciais por jornada
Máximo de 1, deve ser a primeira etapa
Combinação de negócios + unitário em uma jornada
Incompatível
Eventos em lote
Não é possível acionar jornadas — em vez disso, use uma atividade Ler público
Qualificação de público-alvo — Administração
Não configurado em Administração > Eventos — selecionado diretamente na tela de jornada
Editar um evento ao vivo
Só é possível alterar o nome, a descrição ou adicionar campos de carga

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.

NOTE
Exceto para eventos de espera e retomada, todos os outros tipos de evento também contam para a cota quando usados em jornadas com base em públicos-alvo de leitura.

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

TIP
Se sua jornada não estiver acionando, verifique se o esquema de evento tem o Perfil de Cliente em Tempo Real habilitado e se os eventos são transmitidos - os eventos assimilados em lote não podem acionar jornadas.

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.

recommendation-more-help
journey-optimizer-help