Nesta página: saiba como usar e configurar eventos de Qualificação de público-alvo para acionar a entrada ou a progressão da jornada quando os perfis se qualificarem para um público-alvo do Adobe Experience Platform ou saírem dele.
Sobre eventos de qualificação de público-alvo about-segment-qualification
Esta atividade escuta as entradas e saídas dos perfis em Adobe Experience Platform públicos-alvo. Ele pode fazer com que indivíduos entrem em uma jornada ou avancem. Para saber mais sobre a criação de públicos-alvo, consulte esta seção.
Digamos que você tenha um público-alvo de “cliente prata”. Com essa atividade, você pode fazer com que todos os novos clientes Silver insiram uma jornada e enviem a eles uma série de mensagens personalizadas.
Esse tipo de evento pode ser posicionado como a primeira etapa ou posteriormente na jornada.
➡️ Conheça este recurso no vídeo
Configure a atividade configure-segment-qualification
Para configurar a atividade Qualificação de público-alvo, siga estas etapas:
-
Expanda a categoria Eventos e solte uma atividade Qualificação de público-alvo na tela.
-
Adicione um Rótulo à atividade. Esta etapa é opcional.
-
Clique no campo Público-alvo e selecione os públicos-alvo que deseja aproveitar.
note NOTE Você pode personalizar as colunas exibidas na lista e classificá-las. 
Depois que o público-alvo é adicionado, o botão Copiar permite copiar seu nome e ID:
{"name":"Loyalty membership","id":"8597c5dc-70e3-4b05-8fb9-7e938f5c07a3"}
note tip TIP Para identificar o método de avaliação de um público antes de usá-lo, abra o menu Públicos-alvo, selecione o público-alvo e verifique o campo Método de avaliação — Streaming, Batch ou Edge. Você também pode adicionar a coluna Método de avaliação à lista de públicos-alvo nesta atividade. O método de avaliação afeta o tempo de entrada e quais práticas recomendadas se aplicam — consulte Públicos-alvo em lote e Públicos-alvo transmitidos. -
No campo Comportamento, escolha se você deseja escutar entradas de público-alvo, saídas ou ambas.
note NOTE Enter e Exit correspondem aos status de participação de público Realized e Exited de Adobe Experience Platform.
Consulte a documentação do Serviço de segmentação. -
Selecione um namespace. Isso só será necessário se o evento for posicionado como a primeira etapa da jornada. Por padrão, o campo é pré-preenchido com o último namespace usado.
note NOTE Você só pode selecionar um namespace de identidade com base em pessoas.
Os namespaces da tabela de pesquisa (por exemplo, ProductID para uma pesquisa de Produto) não estão disponíveis na lista suspensa Namespace.
A carga contém as seguintes informações de contexto, que podem ser usadas em condições e ações:
- o comportamento (entrada, saída)
- o carimbo de data e hora da qualificação
- a id do público-alvo
Ao usar o editor de expressão em uma condição ou ação que segue uma atividade de Qualificação de público-alvo, você tem acesso ao nó Qualificação de público-alvo. Você pode escolher entre o Último horário de qualificação e o status (entre ou saia).
Consulte Condições.
Uma nova jornada que inclui um evento de Qualificação de público-alvo se torna operacional dez minutos após a sua publicação. Este intervalo corresponde ao intervalo de atualização do cache do serviço dedicado. Aguarde dez minutos antes de usar esta jornada.
Tempo de qualificação de público-alvo e modelo de estado timing-and-state-model
Use a seguinte sequência ao diagnosticar a qualificação do público-alvo:
- Associação existente: Perfis que já estão no público-alvo com a associação
Realizednão geram um novo evento de entrada simplesmente porque a jornada foi publicada. Somente uma alteração de associação qualificada subsequente pode acionar a atividade. - Comportamento no meio da jornada: quando a atividade não é o primeiro nó, ela começa a escutar quando o perfil atinge esse nó. Um perfil qualificado antes de chegar ao nó não entra automaticamente nesse caminho, a menos que um novo evento de qualificação seja recebido após o início do listening.
- Disponibilidade de lote: públicos-alvo em lote ou públicos-alvo de fluxo que dependem de dados assimilados em lote podem ficar prontos aproximadamente duas horas após a conclusão da segmentação. Use Ler público-alvo para casos de uso baseados em lote e consulte as diretrizes de migração de público-alvo em lote.
- Tempo limite da atividade de Qualificação de público-alvo: a contagem regressiva do tempo limite começa quando o perfil atinge a atividade de Qualificação de público-alvo, não quando ocorre a próxima avaliação de público. Para um público-alvo em lote, o sinal de qualificação pode chegar somente após o trabalho diário de segmentação e a propagação subsequente serem concluídos. Se o sinal chegar após o tempo limite da atividade, o perfil seguirá o caminho de tempo limite.
- Tempo limite de jornada global: Esse é um limite separado que começa quando o perfil entra na jornada. Se o perfil atingir o tempo limite global, ele sairá e não poderá mais avançar nessa versão do jornada. Um sinal de qualificação recebido após essa saída não retoma a instância de jornada expirada.
Ao solucionar problemas, verifique a associação do público-alvo, a entrada e a progressão da jornada e a propagação de dados separadamente.
Práticas recomendadas best-practices-segments
A atividade Qualificação de público-alvo permite a entrada imediata em jornadas para indivíduos qualificados ou desqualificados de um público-alvo Adobe Experience Platform.
A velocidade de recepção dessas informações é alta. As medidas mostram 10.000 eventos recebidos por segundo. Planeje picos de entrada, evite-os quando possível e prepare sua jornada para lidar com eles. Saiba mais sobre taxas de processamento e limites de taxa de transferência da jornada nesta seção.
Públicos em lote batch-speed-segment-qualification
Para públicos-alvo em lote, migre o padrão de entrada para uma jornada Ler público-alvo. O público-alvo de leitura suporta o processamento agendado. Para jornadas configuradas com recorrência diária, a opção Acionador após avaliação de público-alvo em lote aguarda resultados de segmentação atualizados em vez de usar a Qualificação de público-alvo como um acionador em lote.
Ao usar a Qualificação de público-alvo para um público-alvo em lote, observe que um pico de entrada ocorre no momento do cálculo diário. O tamanho do pico depende de quantos indivíduos entram ou saem do público a cada dia.
Além disso, se o público-alvo do lote for recém-criado e usado imediatamente em uma jornada, o primeiro lote de cálculo poderá gerar muitas entradas. Planeje para este pico.
Tempo das atualizações de associação do segmento timing-segment-membership
Ao usar instantâneos em lote em uma jornada, qualquer nova associação de segmento pode ser refletida somente em instantâneos subsequentes. Se adições de segmento imediatas ou no mesmo dia forem essenciais, considere a segmentação por transmissão ou verifique se as atualizações de segmento são capturadas pelo próximo instantâneo.
Públicos transmitidos streamed-speed-segment-qualification
Ao usar a Qualificação de público-alvo para públicos-alvo transmitidos, há menos risco de grandes picos de entrada e saída, pois a avaliação é contínua. Se a definição de público-alvo qualificar muitos clientes de uma só vez, ainda poderá ocorrer um pico.
Evite usar eventos abertos e enviados com segmentação por transmissão. Em vez disso, use sinais reais de atividade do usuário, como cliques, compras ou dados de beacon. Para lógica de frequência ou supressão, use regras de negócios em vez de enviar eventos. Saiba mais
Consulte a Adobe Experience Platform documentação de segmentação por transmissão.
Por que nem todos os perfis qualificados podem entrar na jornada streaming-entry-caveats
Ao usar públicos-alvo de transmissão com a atividade Qualificação do público-alvo, nem todos os perfis que se qualificam para o público-alvo necessariamente entrarão na jornada. Esse comportamento pode ocorrer pelos seguintes motivos:
-
Perfis que já estão no público-alvo: somente os perfis que se qualificaram recentemente para o público-alvo após a publicação da jornada acionarão a entrada. Os perfis que já estão no público-alvo antes da publicação não serão inseridos. Da mesma forma, quando um segmento de transmissão usa uma condição baseada em tempo (por exemplo, “evento nas próximas 8 horas”), os perfis que já atenderam a essa condição antes da criação do segmento não são avaliados retroativamente — somente os perfis cujos dados são alterados após a ativação do segmento são avaliados em relação à condição.
-
Tempo de ativação de Jornada: quando você publica uma jornada, a atividade Qualificação de Público leva até 10 minutos para se tornar ativa e começar a escutar entradas e saídas de perfil. Saiba mais sobre a ativação de jornada.
-
Saídas rápidas do público-alvo: se um perfil se qualificar para o público-alvo, mas sair antes que a entrada de jornada seja acionada, esse perfil não poderá entrar na jornada.
-
Tempo entre qualificação e processamento de jornada: devido à natureza distribuída de Adobe Experience Platform, pode haver lacunas de tempo. Um perfil pode ser qualificado antes que a jornada processe o evento de qualificação.
Recomendações:
-
Depois de publicar uma jornada, aguarde pelo menos 10 minutos antes de enviar eventos ou dados que acionarão a qualificação do perfil. Isso garante que a jornada esteja totalmente ativada e pronta para processar as entradas.
-
Para casos de uso críticos nos quais você precisa garantir que todos os perfis qualificados sejam inseridos, considere usar uma atividade Ler público-alvo. Ele processa todos os perfis em um público-alvo em um momento específico.
-
Monitore a taxa de entrada e a taxa de transferência da sua jornada para entender os padrões de fluxo do perfil.
-
Se os perfis não estiverem entrando como esperado, consulte o guia de solução de problemas para obter etapas de diagnóstico adicionais.
Se os perfis não estiverem entrando na jornada como esperado, verifique se o público-alvo usa um método de avaliação compatível e se o namespace de identidade selecionado está presente no perfil. Verifique a associação do público-alvo e os detalhes de execução da jornada para identificar onde a qualificação ou a entrada está falhando.
Perguntas frequentes faq
Uma jornada pode salvar sua população atual como um público-alvo reutilizável?
Não. A qualificação de público-alvo fornece sinais de alteração de associação e contexto de jornada; ela não salva os perfis que atualmente fluem por uma jornada como um novo público-alvo reutilizável nem exporta a população de jornadas atual. Você pode continuar a lógica na mesma jornada, usar uma ação Atualizar Perfil para gravar um atributo de perfil que um público-alvo posterior possa usar, ou usar uma ação personalizada ou processo externo para manter o estado. Use uma jornada separada somente depois que o estado tiver sido modelado em um perfil suportado ou atributo de evento.
A segmentação sequencial pode unir dois eventos com uma ID de correlação compartilhada?
A segmentação sequencial define a ordem do evento e as condições do evento. Não suponha que ele execute uma associação geral de campo a campo entre dois registros de evento, como Event 1.correlationId = Event 2.correlationId entre um SMS de saída e um SMS de entrada posterior.
Para uma ação de mensagem com suporte enviada anteriormente na mesma jornada, use um Evento de reação quando o sinal de engajamento necessário estiver disponível. Os eventos de reação não são um mecanismo geral de correlação entre jornadas, e retornos de chamada de terceiros ou provedores personalizados podem não fornecer o sinal exigido pelo evento de reação. Para correlação de terceiros ou de provedores personalizados, modele o relacionamento upstream ou emita um evento compatível contendo o contexto de correlação e, em seguida, use o perfil resultante ou os dados do evento na jornada.
Como evitar sobrecargas overloads-speed-segment-qualification
Estas são algumas das práticas recomendadas para evitar sobrecarga de sistemas aproveitados no jornada (fontes de dados, ações personalizadas, atividades de ação de canal):
-
Não use um público em lote imediatamente após sua criação em uma atividade Qualificação de público-alvo. Isso evita o primeiro pico de cálculo. Um aviso amarelo será exibido na tela de jornada se você estiver prestes a usar um público que nunca foi calculado.
-
Coloque uma regra de limitação para fontes de dados e ações usadas em jornadas para evitar sobrecarga. Saiba mais em documentação do Journey Orchestration. Observe que a regra de limitação não tem repetição. Se você precisar tentar novamente, use um caminho alternativo na jornada marcando a caixa Adicionar um caminho alternativo em caso de tempo limite ou erro em condições ou ações.
-
Antes de usar o público em uma jornada de produção, avalie o volume de indivíduos qualificados para esse público diariamente. Para fazer isso, verifique o menu Público-alvo, abra o público-alvo e examine o gráfico Perfis ao longo do tempo.
Saiba mais sobre limites de taxa de entrada e taxa de transferência em esta seção.
Medidas de proteção e limitações audience-qualification-guardrails
Siga as medidas de proteção e recomendações abaixo para criar jornadas de qualificação de público-alvo. Saiba quais atividades contam para o limite de Qualificação de Público-Alvo da sandbox. Consulte também Práticas recomendadas de qualificação de público-alvo.
-
As jornadas de qualificação de público-alvo são projetadas principalmente para funcionar com públicos de transmissão. Essa combinação garante uma melhor experiência em tempo real. É altamente recomendável usar streaming audiences na atividade de qualificação de público-alvo.
No entanto, se você quiser usar atributos baseados em assimilação em lote no público-alvo de transmissão ou um público em lote para uma jornada de qualificação de público-alvo, considere o período para avaliação/ativação de público-alvo. Um público-alvo ou público-alvo de transmissão em lote que usa atributos assimilados em lote fica pronto para uso na atividade Qualificação de público-alvo aproximadamente 2 horas após a conclusão do trabalho de segmentação. Esse trabalho é executado uma vez por dia, no horário definido pelo administrador da organização da Adobe.
-
Adobe Experience Platform públicos-alvo são calculados uma vez por dia (batch públicos-alvo) ou em tempo real (para públicos-alvo transmitidos, usando a opção Públicos-alvo de Alta Frequência de Adobe Experience Platform).
- Se o público-alvo selecionado for transmitido, os indivíduos que pertencem a esse público-alvo potencialmente entram na jornada em tempo real.
- Se o público-alvo for em lote, as pessoas recém-qualificadas para esse público-alvo potencialmente entrarão na jornada quando o cálculo do público for executado em Adobe Experience Platform.
Como prática recomendada, use a transmissão de públicos-alvo em uma atividade Qualificação de público-alvo. Para casos de uso em lote, use uma atividade Ler público.
note NOTE Devido à natureza em lote de públicos-alvo criados usando fluxos de trabalho de composição e uploads personalizados, esses públicos-alvo não podem ser direcionados em uma atividade de "Qualificação de público-alvo". Somente públicos-alvo criados usando definições de segmento podem ser aproveitados nessa atividade. -
Grupos de campos de evento de experiência não podem ser usados em jornadas que comecem com uma atividade Ler público, Qualificação de público ou Evento comercial.
-
Ao usar uma atividade Qualificação de público-alvo em uma jornada, essa atividade pode levar até 10 minutos para ficar ativa e ouvir os perfis que entram ou saem do público-alvo.
Vídeo tutorial video
Entenda os casos de uso aplicáveis às jornadas de qualificação de público-alvo neste vídeo. Saiba como criar uma jornada com Qualificação de público-alvo 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 explains how to configure and use the Audience Qualification event activity in Journey Optimizer to trigger or advance profiles in a journey when they enter or exit an Adobe Experience Platform audience.
Intents:
- Configure an Audience Qualification event activity to trigger journey entry on audience membership changes
- Select the correct behavior (entrance, exit, or both) for an Audience Qualification activity
- Apply best practices to avoid overloading systems when using batch or streaming audiences
- Understand why some qualified profiles may not enter the journey and how to mitigate this
- Use the AudienceQualification node payload in downstream conditions and actions
Glossary:
- Audience Qualification event: A journey event activity that listens for profile entrances into or exits from an Adobe Experience Platform audience and triggers journey progression (product-specific)
- Behaviour (Enter/Exit): The setting that controls whether the journey reacts to profiles joining (“Realized”), leaving (“Exited”), or both states of an audience (product-specific)
- Streaming audience: An audience evaluated continuously in real time using the High Frequency Audiences option; recommended for Audience Qualification activities (product-specific)
- Batch audience: An audience recalculated once per day; introduces a daily peak of profile entries and requires a 2-hour readiness window after segmentation job completion (product-specific)
- AudienceQualification node: The context node available in the expression editor after an Audience Qualification activity, exposing last qualification time and status (product-specific)
- Edge-to-Hub propagation: The process by which a streaming segment membership evaluated at the Edge is synced to Hub before the journey can act on it; typically takes 15–30 minutes (product-specific)
Guardrails:
- A new Audience Qualification journey takes up to 10 minutes to become active after publishing
- Batch or streaming audiences using batch-ingested attributes become ready approximately 2 hours after the segmentation job completes
- Only audiences created using segment definitions can be used; composition workflow or custom upload audiences are not supported
- Experience event field groups cannot be used in journeys starting with Audience Qualification
- Only people-based identity namespaces are available for the namespace field; lookup table namespaces are not supported
- Profiles already in the audience before journey publication will not retroactively enter the journey
- Edge-to-Hub propagation for streaming segments typically takes 15–30 minutes
Terminology:
- Canonical name: Audience Qualification event — Acronym: none — variants: segment qualification, audience qualification activity
- Synonyms: “Enter” = “Realized” ; “Exit” = “Exited”
- Do not confuse: “Audience Qualification” ≠ “Read Audience” (Audience Qualification reacts to real-time membership changes; Read Audience processes all members at a scheduled time)
FAQ:
- Q: When does a newly published Audience Qualification journey start processing entries? — It takes up to 10 minutes after publication for the activity to become active and start listening for profile entries and exits.
- Q: Why are profiles not entering my Audience Qualification journey? — Common causes include: profiles were already in the audience before publishing, the 10-minute activation window has not elapsed, or the Edge-to-Hub propagation (15–30 min) for streaming segments has not completed yet.
- Q: Can I use a batch audience in an Audience Qualification activity? — Yes, but it is not recommended. Batch audiences generate a daily entry peak and are not suited for real-time use cases; use a Read Audience activity instead for batch scenarios.
- Q: What data is available in the AudienceQualification payload? — The payload includes the behavior (entrance or exit), the timestamp of qualification, and the audience ID.
- Q: Can I use audiences created from composition workflows in an Audience Qualification activity? — No, only audiences created using segment definitions are supported in this activity.