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
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.

Función
Descripción
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
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:

Referencia de conocimientos de AI

Esta sección contiene conocimientos estructurados destinados a apoyar la interpretación, la recuperación y la respuesta a preguntas relacionadas con este tema.

Para una comprensión completa, esta información debe combinarse con la documentación de esta página. Ninguna de las fuentes pretende ser independiente; la página describe la función, mientras que esta sección proporciona contexto adicional que ayuda a desambiguar la terminología, la intención, la aplicabilidad y las restricciones.

  • TL;DR: Esta página es una referencia por categorías de las más de 60 funciones integradas disponibles en el editor de expresiones avanzadas de Recorrido, que cubren las funciones de agregación, conversión, fecha/hora, lista, matemáticas, cadena y audiencia de Adobe Experience Platform.

Intenciones:

  • Identificar la función correcta para una tarea explorando las tablas de funciones clasificadas
  • Transforme tipos de datos entre cadena, entero, decimal, booleano, fecha y duración mediante funciones de conversión
  • Realizar filtrado basado en fecha con funciones como inLastDays, inNextHours y nowWithDelta
  • Manipular y validar valores de cadena mediante funciones como contain, replace, split y trim
  • Realizar cálculos estadísticos sobre las colecciones mediante funciones de agregación como count, avg, sum y distinctCount
  • Comprobar la pertenencia a audiencias en condiciones de recorrido mediante la función inAudience

Glosario:

  • Funciones de agregación: Funciones que calculan un solo valor (recuento, suma, promedio, mínimo, máximo) a partir de una colección de valores (específicos del producto)
  • Funciones de conversión: funciones que convierten un valor de un tipo de datos a otro (por ejemplo, toString, toDateTime, toDuration) (específico del producto)
  • Funciones de fecha: funciones para trabajar con valores de fecha, hora y zona horaria en expresiones de recorrido (específicas del producto)
  • Funciones de lista: funciones para filtrar, ordenar y analizar datos de matriz/colección (específicos del producto)
  • inAudience: una función que comprueba si un perfil pertenece a un segmento de audiencia de Adobe Experience Platform especificado (específico del producto)

Protecciones:

  • Las funciones siguen una sintaxis coherente: functionName(param1, param2, ...)
  • Una función puede tener varias firmas (diferentes conjuntos de parámetros) para gestionar diferentes casos de uso
  • Cada función tiene un tipo de valor devuelto fijo: asegúrese de que el tipo de valor devuelto coincida con lo que espera el contexto de la expresión
  • Las funciones disponibles en el editor de expresiones de Recorrido difieren de las del editor de personalización

Terminología:

  • Nombre canónico: Functions — Acrónimo: none — variantes: funciones integradas, funciones de expresión
  • Sinónimos: “funciones de agregación” = “funciones estadísticas”; “funciones de conversión” = “funciones de conversión de tipo”
  • No confunda: funciones de expresión de recorrido ≠ funciones del editor de personalización (conjuntos diferentes)

PREGUNTAS MÁS FRECUENTES:

  • Q: ¿Cuántas funciones están disponibles en el editor de expresiones de Recorrido? — Más de 60 funciones organizadas en diferentes categorías, incluidas agregación, conversión, fecha, lista, matemáticas, cadena y Adobe Experience Platform.
  • Q: ¿Cómo puedo comprobar si un perfil pertenece a una audiencia en una condición de recorrido? — Utilice la función inAudience con el identificador de audiencia.
  • Q: ¿Qué función debo usar para compensar la fecha y hora actuales con un número de días? — Use nowWithDelta(N, "days") para obtener un desplazamiento de dateTime con respecto a la hora actual.
  • Q: ¿Puede una función devolver tipos diferentes dependiendo de cómo se llame? — Una función tiene un tipo de valor devuelto específico por firma, pero un solo nombre de función puede tener varias firmas con diferentes conjuntos de parámetros y tipos de valor devuelto.
  • Q: ¿Cuál es la diferencia entre count y countWithNull?count solo cuenta elementos no nulos; countWithNull cuenta todos los elementos, incluidos los valores nulos.
recommendation-more-help
journey-optimizer-help