Trabalhar com o editor de expressão avançado about-the-advanced-expression-editor
Use o editor de expressão avançado do Jornada para criar expressões avançadas em várias telas da interface. Por exemplo, você pode criar expressões ao configurar e usar jornadas e ao definir uma condição de fonte de dados.
Ele também está disponível sempre que for necessário definir parâmetros de ação que exijam manipulações de dados específicos. Você pode usar os dados provenientes dos eventos ou informações adicionais recuperadas da fonte de dados. Em uma jornada, a lista exibida de campos de evento é contextual e varia de acordo com os eventos adicionados na jornada.
O editor de expressão avançado oferece um conjunto de funções e operadores integrados, permitindo manipular valores e definir uma expressão que se ajuste especificamente às suas necessidades. O editor de expressão avançado também permite definir os valores do parâmetro de fonte de dados externa, manipular campos de mapa e coleções.
Acessar o editor de expressão avançado accessing-the-advanced-expression-editor
O editor avançado de expressões pode ser usado para:
- criar condições avançadas em fontes de dados e informações do evento
- definir atividades de espera personalizadas
- definir mapeamento de parâmetros de ação
Quando possível, você pode alternar entre os dois modos usando o botão Modo avançado / Modo simples. O modo simples é descrito aqui.
-
As condições podem ser definidas no editor de expressão simples ou avançado. Eles sempre retornam um tipo booleano.
-
Parâmetros de ações podem ser definidos selecionando campos ou por meio do editor de expressão avançado. Eles retornam um tipo de dados específico de acordo com a expressão.
Você pode acessar o editor de expressão avançado de diferentes maneiras:
-
Ao criar uma condição de fonte de dados, você pode acessar o editor avançado clicando em Modo avançado.
-
Ao criar um temporizador personalizado, o editor avançado será exibido diretamente.
-
Ao mapear o parâmetro de ação, clique em Modo avançado.
Conheça a interface discovering-the-interface
Nesta tela você pode escrever manualmente a expressão.
Na parte esquerda da tela são exibidos os campos e as funções disponíveis:
-
Eventos: escolha um dos campos recebidos do evento de entrada. A lista exibida de campos de evento é contextual e varia de acordo com os eventos adicionados na jornada. Leia mais
note caution CAUTION Não há suporte para criar expressões usando eventos de experiência. Abordagens alternativas e práticas recomendadas para criar expressões/lógica com eventos de experiência são referenciadas aqui -
Públicos-alvo: se você tiver descartado um evento de Qualificação de público-alvo, escolha o público-alvo que deseja usar na expressão. Leia mais
-
Fontes de dados: escolha na lista de campos disponíveis nos grupos de campos de suas fontes de dados. Leia mais
-
Propriedades da Jornada: esta seção reagrupa os campos técnicos relacionados à jornada de um determinado perfil. Leia mais
-
Funções: escolha entre uma lista de funções integradas que permitem fazer uma filtragem complexa. As funções são organizadas por categorias. Leia mais
Um mecanismo de autopreenchimento exibe sugestões contextuais.
Um mecanismo de validação de sintaxe verifica a integridade do código. Erros são exibidos na parte superior do editor.
Necessidade de parâmetros ao criar condições com o editor de expressão avançado
Se você selecionar um campo de uma fonte externa de dados que requer um parâmetro para ser chamado (consulte esta página), uma nova guia aparecerá à direita para permitir a especificação desse parâmetro. O valor do parâmetro pode vir dos eventos posicionados na jornada ou na fonte de dados do Experience Platform (e não de outras fontes de dados externas). Por exemplo, em uma fonte de dados relacionada ao clima, um parâmetro frequentemente usado será “cidade”. Como resultado, você deve selecionar onde deseja obter o parâmetro cidade. As funções também podem ser aplicadas aos parâmetros para executar alterações de formato ou concatenações.
Para casos de uso mais complexos, caso queira incluir os parâmetros da fonte de dados na expressão principal, é possível definir os valores usando a palavra-chave “params”. Consulte esta página.
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 introduces the Journey advanced expression editor — its access points, interface panels, and capabilities for building complex conditions, custom wait timers, and action parameter mappings using events, data sources, functions, and operators.
Intents:
- Access the advanced expression editor from a data source condition, custom wait activity, or action parameter mapping
- Build advanced boolean conditions using event fields, data source fields, audience membership, and journey properties
- Switch between simple mode and advanced mode when configuring conditions
- Reference external data source parameters directly within the main expression using the
paramskeyword - Use AI-powered expression generation to create expressions from natural language prompts
Glossary:
- Advanced expression editor: The Journey Optimizer code editor for writing complex expressions; distinct from the simpler point-and-click condition editor (product-specific)
- Simple mode: A point-and-click condition editor; less flexible than the advanced editor but easier for non-developers (product-specific)
- Journey properties: Technical fields about the journey instance (ID, version, errors, current node) accessible in the expression editor (product-specific)
- Generate expressions with AI: An AI-powered capability (public beta) inside the advanced editor that generates expressions from plain language prompts (product-specific)
Guardrails:
- Creating expressions using experience events directly is not supported — use alternative approaches such as computed attributes
- Conditions always return a boolean type regardless of editor mode
- Expressions must not contain hidden or non-printable characters, and should use single-line format to avoid parsing errors
- External data source parameter values can only come from journey events or the Experience Platform data source — not from other external data sources
- The advanced expression editor functions differ from those in the personalization editor
Terminology:
- Canonical name: Advanced Expression Editor — Acronym: none — variants: advanced editor, expression editor
- Synonyms: “Advanced mode” = “advanced expression editor”
- Do not confuse: advanced expression editor (journey conditions/actions) ≠ personalization editor (message content personalization)
FAQ:
- Q: When must I use the advanced expression editor instead of the simple mode? — Use the advanced editor when you need to query collections, use functions, reference journey properties, or build multi-condition logic that the simple editor cannot express.
- Q: How do I pass a parameter to an external data source in the expression? — Use the
paramskeyword in the expression syntax, e.g.#{DataSource.fieldGroup.field, params: {paramName: value}}. - Q: What does the autocompletion mechanism do? — It displays contextual field and function suggestions as you type, helping you build valid expressions faster.
- Q: Where is Generate expressions with AI accessed? — Via the AI control inside the advanced expression editor; it is currently in public beta.
- Q: Do conditions in the advanced editor return a different type than in simple mode? — No; conditions always return a boolean in both modes.