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
Esta seção contém conhecimento estruturado destinado a oferecer suporte à interpretação, recuperação e resposta a perguntas relacionadas a este tópico.
Para uma compreensão completa, essas informações devem ser combinadas com a documentação desta página. Nenhuma das origens deve ser independente; a página descreve o recurso, enquanto esta seção fornece um contexto adicional que ajuda a desfazer a ambiguidade da terminologia, intenção, aplicabilidade e restrições.
- TL;DR: esta página documenta a função
inAudience, que verifica em tempo real se um perfil de jornada pertence a um público-alvo nomeado do Adobe Experience Platform e retorna um valor booleano usado em condições de jornada.
Intenções:
- Ramifique um caminho de jornada com base no fato de um perfil ser membro de um público-alvo específico usando
inAudience - Combinar várias verificações
inAudiencecom a lógica AND/OR para criar condições complexas de direcionamento - Verificar se um perfil não inseriu um público-alvo específico usando uma verificação de negação (
inAudience("...") == false) - Entenda as diferenças de tempo de propagação entre as jornadas Ler público-alvo e as jornadas de eventos unitários
- Identificar e corrigir referências de público corrompidas causadas por renomeações de público no Adobe Experience Platform
Glossário:
- Realizado: status de participação de público indicando o indivíduo atualmente qualificado para a definição de público-alvo e que é um membro ativo (específico do produto)
- Encerrado: status de participação de público indicando que o indivíduo deixou o público e não se qualifica mais (específico do produto)
- Política de mesclagem: uma regra no Adobe Experience Platform que determina como os dados do perfil de vários conjuntos de dados são combinados ao avaliar a associação de público-alvo (específico do produto)
- Projeção de lote: o armazenamento de dados do perfil foi atualizado de acordo com uma agenda (dentro de 2 horas após a assimilação) usada pela opção Ler jornadas de público-alvo (específico do produto)
- Projeção de streaming: o armazenamento de dados do perfil em tempo real (normalmente disponível em 15 minutos) usado em jornadas de evento unitárias e após atividades Wait (específico do produto)
Medidas de Proteção:
- Uma única jornada pode recuperar até 100 públicos-alvo
- O parâmetro de nome de público deve ser uma constante de cadeia de caracteres; não há suporte para referências de campo e expressões dinâmicas
- Renomear um público no Adobe Experience Platform não atualiza automaticamente as referências
inAudiencenas expressões do jornada. São necessárias atualizações manuais - Políticas de mesclagem inconsistentes em vários públicos usados na mesma jornada podem causar erros ou alertas
Terminologia:
- Nome canônico: inAudience — Acrônimo: none — variantes: inSegment (nome herdado)
- Sinônimos: “inAudience” = “função de verificação de associação de público”
- Não confundir: “Realizado” (membro ativo) ≠ “Saindo” (não é mais um membro)
- Não confunda: “inAudience” (função atual) ≠ “inSegment” (função herdada obsoleta)
Perguntas frequentes:
- P: O que
inAudienceretorna quando um perfil sai do público-alvo? — Retornafalse; somente perfis com status “Realizado” são considerados membros ativos e retornamtrue. - P: quantos públicos-alvo posso verificar em uma única jornada? — É possível recuperar até 100 públicos-alvo em uma única jornada.
- P: O que acontece se eu renomear um público no Adobe Experience Platform depois de usá-lo em uma jornada? — A expressão de jornada não é atualizada automaticamente; você deve editar manualmente a chamada
inAudiencepara usar o novo nome de público-alvo, caso contrário, a condição será interrompida. - P: Com que rapidez a associação de público-alvo fica disponível após uma atualização de perfil em uma jornada de Leitura de Público-alvo? — Em uma jornada Read Audience antes de uma atividade Wait, os dados são lidos na projeção de lote atualizada dentro de 2 horas após a assimilação.
- P: Posso passar um atributo de perfil como o parâmetro de nome de público-alvo? — Não, o nome do público-alvo deve ser uma constante de sequência; referências de campo e expressões não são compatíveis.