Trabajo con el editor de expresiones avanzado about-the-advanced-expression-editor
Utilice el editor de expresiones avanzadas de Recorrido para crear expresiones avanzadas en varias pantallas de la interfaz. Por ejemplo, se pueden generar expresiones al configurar y utilizar recorridos y al definir una condición de fuente de datos.
También está disponible cada vez que necesite definir parámetros de acción que requieran manipulaciones de datos específicas. Puede aprovechar los datos procedentes de los eventos o la información adicional recuperada del origen de datos. En un viaje, la lista mostrada de los campos de evento es contextual y varía según los eventos agregados en el recorrido.
El editor de expresiones avanzadas oferta un conjunto de funciones y operadores integrados que le permiten manipular valores, y definir una expresión que se ajuste específicamente a sus necesidades. El editor de expresiones avanzadas también permite definir los valores del parámetro de fuente de datos externo, y manipular los campos y colecciones de mapas.
Acceso al editor de expresiones avanzadas accessing-the-advanced-expression-editor
El editor de expresiones avanzadas se puede utilizar para lo siguiente:
- crear condiciones avanzadas en fuentes de datos e información de evento
- definir actividades de espera personalizadas
- definir asignación de parámetros de acción
Si es posible, puede cambiar entre los dos modos con el botón Modo avanzado / Modo simple. El modo simple se describe aquí.
-
Las condiciones se pueden definir en el editor de expresiones simples o avanzadas. Siempre devuelven un tipo booleano.
-
Los parámetros de acción se pueden definir seleccionando campos o mediante el editor de expresiones avanzadas. Devuelven un tipo de datos específico según su expresión.
Puede acceder al editor de expresiones avanzadas de diferentes maneras:
-
Al crear una condición de fuente de datos, puede acceder al editor avanzado haciendo clic en Modo avanzado.
-
Al crear un temporizador personalizado, se mostrará directamente el editor avanzado.
-
Cuando asigne un parámetro de acción, haga clic en Modo avanzado.
Descubra la interfaz discovering-the-interface
Esta pantalla le permite escribir manualmente su expresión.
En la parte izquierda de la pantalla se muestran los campos y las funciones disponibles:
-
Eventos: elija uno de los campos recibidos del evento entrante. La lista mostrada de los campos de evento es contextual y varía según los eventos agregados en el recorrido. Más información
note caution CAUTION No se admite la creación de expresiones mediante eventos de experiencia. Se hace referencia a enfoques alternativos y prácticas recomendadas para crear expresiones/lógica con eventos de experiencia aquí -
Audiencias: si ha eliminado un evento de calificación de audiencias, elija la audiencia que desee utilizar en la expresión. Más información
-
Fuentes de datos: elija entre la lista de campos disponibles en los grupos de campos de las fuentes de datos. Más información
-
propiedades de Recorrido: esta sección reagrupa los campos técnicos relacionados con el recorrido de un perfil determinado. Más información
-
Funciones: elija entre una lista de funciones integradas que permitan realizar filtros complejos. Las funciones están organizadas por categorías. Más información
Un mecanismo de finalización automática muestra sugerencias contextuales.
Un mecanismo de validación de sintaxis comprueba la integridad del código. Los errores se muestran en la parte superior del editor.
Necesidad de parámetros al crear condiciones con el editor de expresiones avanzadas
Si selecciona un campo de un origen de datos externo que requiere que se llame a un parámetro (consulte esta página), aparecerá una nueva pestaña a la derecha que le permitirá especificar este parámetro. El valor del parámetro puede proceder de los eventos colocados en el recorrido o en la fuente de datos de Experience Platform (y no de otras fuentes de datos externas). Por ejemplo, en una fuente de datos relacionada con el tiempo, un parámetro utilizado frecuentemente será “city” (ciudad). Como resultado, debe seleccionar dónde desea obtener este parámetro de ciudad. Las funciones también se pueden aplicar a parámetros para realizar cambios de formato o concatenaciones.
Para casos de uso más complejos, si desea incluir los parámetros del origen de datos en la expresión principal, puede definir sus valores con la palabra clave “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.