Funciones functions

Las funciones son los componentes básicos de las expresiones de recorrido dinámico en Adobe Journey Optimizer. Permiten transformar, calcular, validar y manipular datos en tiempo real para crear experiencias del cliente personalizadas. Con más de 60 funciones organizadas en categorías intuitivas, puede crear condiciones sofisticadas, realizar cálculos complejos y tomar decisiones basadas en datos en cada paso del recorrido del cliente.

Explicación de las funciones

Las funciones de las expresiones de recorrido siguen un patrón de sintaxis coherente:

<function name>(<expression as param 1>, <expression as param 2>, … ,<expression as param N>)

Características clave:

  • Varias firmas: una función puede tener diferentes firmas (diferentes conjuntos de parámetros ordenados) para dar cabida a varios casos de uso
  • Devoluciones específicas del tipo: Cada función tiene un tipo devuelto específico (cadena, entero, booleano, fecha, lista, etc.)
  • Parámetros cero a N: las funciones pueden aceptar expresiones 0-N como parámetros ordenados, lo que proporciona flexibilidad en el uso

¿Por qué utilizar funciones?

Las funciones le permiten lo siguiente:

  • Crear condiciones dinámicas: rutas de recorrido de ramas basadas en la evaluación de datos en tiempo real
  • Personalizar a escala: adapte el contenido y las experiencias con datos de clientes y perspectivas de comportamiento
  • Automatizar decisiones: cree una lógica inteligente sin intervención manual
  • Transformar datos: convierta, aplique formato y manipule tipos de datos para garantizar la compatibilidad
  • Realizar cálculos: ejecutar operaciones matemáticas y análisis estadístico
  • Validar entradas: compruebe la calidad y la integridad de los datos antes de realizar acciones

Funciones por categoría

Examine las funciones organizadas según su propósito principal para encontrar rápidamente la herramienta adecuada para sus necesidades.

Adobe Experience Platform aep-functions

Segmentación y direccionamiento de audiencias

Evalúe la pertenencia a audiencias para crear rutas de recorrido personalizadas basadas en segmentos de clientes definidos en Adobe Experience Platform.

Función
Descripción
inAudience
Comprobar si un individuo pertenece a una audiencia específica

Ver → de detalles de función de Adobe Experience Platform

Funciones de agregación aggregation-functions

Cálculos estadísticos y Resumen de Datos

Realice cálculos en conjuntos de valores para obtener perspectivas como promedios, recuentos, sumas y valores mínimo/máximo. Esencial para la toma de decisiones basada en datos.

Función
Descripción
avg
Calcular valor promedio
count
Recuento de elementos no nulos
countOnlyNull
Contar solo valores nulos
countWithNull
Contar todos los elementos, incluidos los valores nulos
distinctCount
Contar valores únicos no nulos
distinctCountWithNull
Contar valores únicos, incluidos valores nulos
max
Buscar valor máximo
min
Buscar valor mínimo
sum
Calcular suma total

Ver todas las funciones de agregación →

Funciones de conversión conversion-functions

Transformación de tipo de datos

Convierta datos entre diferentes tipos (cadena, entero, decimal, booleano, fecha, duración) para garantizar la compatibilidad entre operaciones y fuentes de datos.

Función
Descripción
toBool
Convertir en booleano
toDateOnly
Convertir solo a fecha (sin hora)
toDateTime
Convertir a fecha con hora
toDateTimeOnly
Convertir a fecha y hora sin zona horaria
toDecimal
Convertir en número decimal
toDuration
Convertir a duración
toInteger
Convertir en entero
toString
Convertir en cadena

Ver todas las funciones de conversión →

Funciones de fecha date-functions

Manipulación de fecha y hora

Trabaje con fechas, horas y zonas horarias para crear condiciones basadas en el tiempo, programar acciones y realizar cálculos temporales.

Función
Descripción
currentTimeInMillis
Obtener el tiempo actual en milisegundos
dateDiff
Calcular la diferencia entre dos fechas o fecha-hora
inLastDays
Comprobar si la fecha está dentro de los últimos N días
inLastHours
Comprobar si la fecha está dentro de las últimas N horas
inLastMonths
Comprobar si la fecha está dentro de los últimos N meses
inLastYears
Comprobar si la fecha está dentro de los últimos N años
inNextDays
Comprobar si la fecha está dentro de los próximos N días
inNextHours
Comprobar si la fecha está dentro de las próximas N horas
inNextMonths
Comprobar si la fecha está dentro de los próximos N meses
inNextYears
Comprobar si la fecha está dentro de los próximos N años
now
Obtener fecha y hora actuales
nowWithDelta
Obtener la hora actual con desplazamiento
setHours
Establecer horas específicas en fecha-hora
setDays
Establecer días específicos en fecha-hora
updateTimeZone
Actualizar zona horaria de fecha y hora

Ver todas las funciones de fecha →

Funciones de lista list-functions

Manipulación y análisis de colecciones

Filtre, ordene, transforme y analice matrices y listas para trabajar con estructuras de datos complejas y realizar operaciones de conjunto como intersección, unión y diferencia.

Función
Descripción
differenceLists
Obtener elementos de una lista que no están presentes en otra
distinct
Obtener valores únicos (excluye valores nulos)
distinctWithNull
Obtener valores únicos (incluye valores nulos)
filtro
Filtrar lista según ciertos criterios
getListItem
Obtener elemento en un índice específico
in
Comprobar si el valor existe en la lista
intersección
Búsqueda de elementos comunes entre listas
límite
Limitar el número de elementos devueltos
listSize
Obtener el tamaño de la lista
mergeLists
Combinación de dos listas, con o sin deduplicación
serializeList
Convertir lista en cadena
sort
Ordenar elementos de lista

Ver todas las funciones de la lista →

Funciones matemáticas math-functions

Operaciones matemáticas

Realizar cálculos numéricos y transformaciones para el procesamiento de datos y la lógica empresarial.

Función
Descripción
random
Generar número aleatorio (0-1)
round
Redondear al entero más cercano

Ver todas las funciones matemáticas →

Funciones de cadena string-functions

Manipulación y validación de texto

Procese, transforme, busque y valide datos de texto para la creación de contenido dinámico y la lógica condicional.

Función
Descripción
concat
Concatenar cadenas
contain
Comprobar si la cadena contiene una subcadena
containIgnoreCase
La comprobación contiene (sin distinción de mayúsculas)
endWith
Comprobar si la cadena termina con el sufijo
endWithIgnoreCase
La comprobación termina por (sin distinción de mayúsculas y minúsculas)
equalIgnoreCase
Comparar cadenas (sin distinción de mayúsculas y minúsculas)
indexOf
Buscar la primera posición de ocurrencia
isEmpty
Comprobar si la cadena está vacía
isNotEmpty
Comprobar si la cadena no está vacía
lastIndexOf
Buscar la última posición de ocurrencia
length
Obtener longitud de cadena
lower
Convertir a minúsculas
matchRegExp
Coincidir expresión regular
notEqualIgnoreCase
Comprobación no igual a (sin distinción de mayúsculas y minúsculas)
replace
Reemplazar la primera ocurrencia
replaceAll
Reemplazar todas las ocurrencias
split
Dividir cadena en matriz
startWith
Comprobar si la cadena comienza con un prefijo
startWithIgnoreCase
La comprobación empieza por (sin distinción de mayúsculas y minúsculas)
substr
Extraer subcadena
trim
Eliminar espacios iniciales y finales
upper
Convertir a mayúsculas
uuid
Generar UUID

Ver todas las funciones de cadena →

Próximos pasos

Ahora que comprende las funciones disponibles, explore:

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 is a categorized reference of all 60+ built-in functions available in the Journey advanced expression editor, covering aggregation, conversion, date/time, list, math, string, and Adobe Experience Platform audience functions.

Intents:

  • Identify the right function for a task by browsing the categorized function tables
  • Transform data types between string, integer, decimal, boolean, date, and duration using conversion functions
  • Perform date-based filtering with functions like inLastDays, inNextHours, nowWithDelta, and dateDiff
  • Manipulate and validate string values using functions like contain, replace, split, and trim
  • Perform statistical calculations on collections using aggregation functions like count, avg, sum, and distinctCount
  • Check audience membership in journey conditions using the inAudience function

Glossary:

  • Aggregation functions: Functions that compute a single value (count, sum, average, min, max) from a collection of values (product-specific)
  • Conversion functions: Functions that cast a value from one data type to another (e.g. toString, toDateTime, toDuration) (product-specific)
  • Date functions: Functions for working with date, time, and timezone values in journey expressions (product-specific)
  • List functions: Functions for filtering, sorting, and analyzing array/collection data (product-specific)
  • inAudience: A function that checks whether a profile belongs to a specified Adobe Experience Platform audience segment (product-specific)

Guardrails:

  • Functions follow a consistent syntax: functionName(param1, param2, ...)
  • A function may have multiple signatures (different parameter sets) to handle different use cases
  • Each function has a fixed return type — ensure the return type matches what the expression context expects
  • The functions available in the Journey expression editor differ from those in the personalization editor

Terminology:

  • Canonical name: Functions — Acronym: none — variants: built-in functions, expression functions
  • Synonyms: “aggregation functions” = “statistical functions”; “conversion functions” = “type casting functions”
  • Do not confuse: journey expression functions ≠ personalization editor functions (different sets)

FAQ:

  • Q: How many functions are available in the Journey expression editor? — Over 60 functions organized across categories including aggregation, conversion, date, list, math, string, and Adobe Experience Platform.
  • Q: How do I check if a profile belongs to an audience in a journey condition? — Use the inAudience function with the audience identifier.
  • Q: What function should I use to get the current date and time offset by a number of days? — Use nowWithDelta(N, "days") to get a dateTime offset from the current time.
  • Q: How can I calculate the difference between two dates? — Use the dateDiff function. Both parameters must be the same type: dateOnly parameters return the difference in days, while dateTimeOnly and dateTime parameters return the difference in milliseconds.
  • Q: Can a function return different types depending on how it is called? — A function has a specific return type per signature, but a single function name can have multiple signatures with different parameter sets and return types.
  • Q: What is the difference between count and countWithNull?count counts only non-null elements; countWithNull counts all elements including nulls.
recommendation-more-help
journey-optimizer-help