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.

Sintaxe
inAudience(<parameter>)
Parâmetros
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
Assinatura e tipo retornado

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)

Exemplos

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
// Simple audience check in a condition
inAudience("Premium Customers") == true

// Multiple audience evaluation
inAudience("High Value Customers") == true AND inAudience("Active Last 30 Days") == true

// Negation check
inAudience("Unsubscribed") == false

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:

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 documents the inAudience function, 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 inAudience checks 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 inAudience references 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 inAudience return when a profile has exited the audience? — It returns false; only profiles with “Realized” status are considered active members and return true.
  • 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 inAudience call 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.
recommendation-more-help
journey-optimizer-help