Função inAudience inAudience
A função inAudience é uma função Adobe Experience Platform que permite verificar se um indivíduo em sua jornada pertence a um público-alvo específico. Essa função avançada permite criar caminhos de jornada personalizados com base na associação ao público, permitindo segmentação e direcionamento sofisticados nas experiências do cliente.
Use a função inAudience quando precisar:
- Caminhos de jornada de ramificação com base na associação do público-alvo. Saiba mais
- Aplicar lógica condicional que depende de um perfil pertencer a um segmento específico
- Direcione grupos específicos de clientes com experiências personalizadas
- Avaliar a participação do público-alvo em tempo real nas condições de jornada
- Combinar várias verificações de público-alvo para criar regras complexas de direcionamento
A função avalia a associação de público-alvo em tempo real e retorna um valor booleano, tornando-a ideal para nós de decisão e expressões condicionais. Os públicos são definidos e gerenciados no Adobe Experience Platform (saiba mais sobre o trabalho com públicos no Journey Optimizer), e o editor de expressão fornece sugestões de preenchimento automático para ajudar você a referenciá-los com precisão.
Status do público-alvo:
Os públicos-alvo podem ter dois status de participação:
- Realizado: o indivíduo se qualifica para a definição de público-alvo e é um membro ativo
- Encerrado: o indivíduo saiu do público-alvo e não se qualifica mais
Apenas indivíduos com o status Realizado serão considerados membros ativos do público-alvo. Quando a função retorna true, ela confirma que o indivíduo tem o status realizado; quando retorna false, ela indica o status encerrado. Para obter mais informações sobre a avaliação de público, consulte a documentação do Serviço de Segmentação.
inAudience(<parameter>)| table 0-row-3 1-row-3 | ||
|---|---|---|
| Parâmetro | Descrição | Tipo |
| Público-alvo | O nome do público | <string> |
Restrições importantes:
- O nome do público-alvo deve ser uma constante de sequência
- Ele não pode ser uma referência de campo ou uma expressão
- Você pode recuperar até 100 públicos-alvo em uma única jornada
inAudience(<string>)
Retorna um valor booleano:
-
true: O indivíduo é um membro da audiência (status realizado) -
false: O indivíduo não é membro da audiência (status de saída)
inAudience("men over 50")
Retorna true se o indivíduo na instância do jornada fizer parte do público-alvo da Adobe Experience Platform chamado “homens acima de 50”, caso contrário false.
Casos de uso prático:
| code language-none |
|---|
|
Medidas de proteção e limitações guardrails
Ao usar a função inAudience em suas jornadas, esteja ciente das seguintes medidas de proteção e limitações:
Limite de recuperação de público-alvo:
- Você pode recuperar até 100 públicos-alvo em uma única jornada
- O editor de expressão fornece uma lista de públicos-alvo disponíveis preenchida automaticamente para ajudar você a referenciá-los corretamente
Restrições de parâmetro:
- O nome do público-alvo deve ser uma constante de sequência
- Não há suporte para referências e expressões de campo como parâmetros
Alterações no nome do público-alvo:
- Alterar o nome de um público-alvo existente no Adobe Experience Platform não atualiza automaticamente nenhuma referência a esse público-alvo nas expressões de jornada
- Se o nó de condição usar
inAudience('oldAudienceName'), você deverá editar manualmente a expressão para usar o novo nome - Se o nome do público-alvo não for atualizado, a condição de jornada será interrompida e poderá resultar em um comportamento de jornada incorreto
Considerações sobre a política de mesclagem:
- Ao usar vários públicos com a função
inAudience, inconsistências com políticas de mesclagem podem causar erros ou alertas - Consulte Propriedades da Jornada para obter mais informações sobre o comportamento da política de mesclagem
Tempo de propagação:
Ao usar inAudience() em um nó de condição, o tempo de avaliação de associação de segmento varia dependendo de onde a condição aparece na jornada:
- Em uma jornada de Leitura de Público-alvo, antes de uma atividade de Espera: o Journey Optimizer lê a partir da projeção em lote do perfil. Os dados nesta projeção são atualizados em 2 horas após a assimilação. Os públicos-alvo que dependem de condições baseadas no dia ou baseadas no tempo podem enfrentar atraso adicional. Adicione uma breve atividade de espera no início da jornada ou permita o tempo de buffer para garantir que a associação de segmento mais recente seja refletida.
- Em uma jornada de evento unitária ou após uma atividade Wait: a associação de segmento é lida a partir da projeção de streaming (unitária). Normalmente, os dados estão disponíveis em 15 minutos. Para obter mais detalhes, consulte a documentação de assimilação de streaming do Adobe Experience Platform.
Tópicos relacionados
Saiba mais sobre como usar públicos-alvo na Adobe Journey Optimizer:
- Sobre públicos-alvo - Entenda como os públicos-alvo funcionam no Adobe Experience Platform e no Journey Optimizer, inclusive como criá-los e gerenciá-los
- Atividade Ler público-alvo - Use públicos-alvo para acionar a entrada de jornada e fazer com que todos os membros do público-alvo insiram uma jornada
- Eventos de qualificação de público-alvo - Ouça as entradas e saídas do perfil dos públicos-alvo para acionar ações de jornada em tempo real
- Uso de públicos-alvo em condições - Crie caminhos de jornada condicionais com base na associação de público-alvo usando a atividade Otimize
- Propriedades da Jornada - Políticas de mesclagem - Entenda como as políticas de mesclagem funcionam ao usar vários públicos com a função inAudience
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 documents the
inAudiencefunction, which checks in real-time whether a journey profile belongs to a named Adobe Experience Platform audience and returns a boolean used in journey conditions.
Intents:
- Branch a journey path based on whether a profile is a member of a specific audience using
inAudience - Combine multiple
inAudiencechecks with AND/OR logic to create complex targeting conditions - Verify that a profile has not entered a specific audience using a negation check (
inAudience("...") == false) - Understand the propagation timing differences between Read Audience journeys and unitary event journeys
- Identify and fix broken audience references caused by audience renames in Adobe Experience Platform
Glossary:
- Realized: Audience participation status indicating the individual currently qualifies for the audience definition and is an active member (product-specific)
- Exited: Audience participation status indicating the individual has left the audience and no longer qualifies (product-specific)
- Merge policy: A rule in Adobe Experience Platform that determines how profile data from multiple datasets is combined when evaluating audience membership (product-specific)
- Batch projection: The profile data store refreshed on a schedule (within 2 hours after ingestion) used by Read Audience journeys (product-specific)
- Streaming projection: The real-time profile data store (typically available within 15 minutes) used in unitary event journeys and after Wait activities (product-specific)
Guardrails:
- A single journey can retrieve up to 100 audiences
- The audience name parameter must be a string constant; field references and dynamic expressions are not supported
- Renaming an audience in Adobe Experience Platform does not automatically update
inAudiencereferences in journey expressions — manual updates are required - Inconsistent merge policies across multiple audiences used in the same journey can cause errors or alerts
Terminology:
- Canonical name: inAudience — Acronym: none — variants: inSegment (legacy name)
- Synonyms: “inAudience” = “audience membership check function”
- Do not confuse: “Realized” (active member) ≠ “Exited” (no longer a member)
- Do not confuse: “inAudience” (current function) ≠ “inSegment” (deprecated legacy function)
FAQ:
- Q: What does
inAudiencereturn when a profile has exited the audience? — It returnsfalse; only profiles with “Realized” status are considered active members and returntrue. - Q: How many audiences can I check in a single journey? — Up to 100 audiences can be retrieved within a single journey.
- Q: What happens if I rename an audience in Adobe Experience Platform after using it in a journey? — The journey expression is not updated automatically; you must manually edit the
inAudiencecall to use the new audience name, otherwise the condition will break. - Q: How quickly is audience membership available after a profile update in a Read Audience journey? — In a Read Audience journey before a Wait activity, data is read from the batch projection refreshed within 2 hours after ingestion.
- Q: Can I pass a profile attribute as the audience name parameter? — No, the audience name must be a string constant; field references and expressions are not supported.