Funzioni functions

Le funzioni sono gli elementi costitutivi delle espressioni di percorso dinamico in Adobe Journey Optimizer. Consentono di trasformare, calcolare, convalidare e manipolare i dati in tempo reale per creare esperienze cliente personalizzate. Con oltre 60 funzioni organizzate in categorie intuitive, puoi creare condizioni sofisticate, eseguire calcoli complessi e prendere decisioni basate sui dati in ogni fase del percorso del cliente.

Informazioni sulle funzioni

Le funzioni nelle espressioni di percorso seguono un pattern di sintassi coerente:

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

Caratteristiche chiave:

  • Firme multiple: una funzione può avere firme diverse (set diversi di parametri ordinati) per soddisfare vari casi d’uso
  • Restituzioni specifiche per tipo: ogni funzione ha un tipo restituito specifico (stringa, numero intero, booleano, data, elenco, ecc.)
  • Parametri da zero a N: le funzioni possono accettare espressioni 0-N come parametri ordinati, fornendo flessibilità nel modo in cui utilizzarle

Perché utilizzare le funzioni?

Le funzioni consentono di:

  • Creazione di condizioni dinamiche - Percorsi di percorso di diramazione basati sulla valutazione dei dati in tempo reale
  • Personalizzazione su larga scala - Personalizzazione di contenuti ed esperienze tramite dati sui clienti e informazioni sul comportamento
  • Automatizzare le decisioni - Creare una logica intelligente senza intervento manuale
  • Trasforma dati - Converti, formatta e modifica tipi di dati per garantire la compatibilità
  • Eseguire calcoli - Eseguire operazioni matematiche e analisi statistiche
  • Convalida input - Verifica la qualità e la completezza dei dati prima di intraprendere azioni

Funzioni per categoria

Sfoglia le funzioni organizzate in base al loro scopo principale per trovare rapidamente lo strumento giusto per le tue esigenze.

Adobe Experience Platform aep-functions

Segmentazione del pubblico e targeting

Valuta l’iscrizione al pubblico per creare percorsi di percorso personalizzati in base ai segmenti di clienti definiti in Adobe Experience Platform.

Funzione
Descrizione
inAudience
Verifica se un singolo appartiene a un pubblico specifico

Visualizza → dettagli funzione Adobe Experience Platform

Funzioni di aggregazione aggregation-functions

Calcoli statistici e riepilogo dei dati

Esegui calcoli su insiemi di valori per derivare informazioni approfondite quali medie, conteggi, somme e valori min/max. Essenziale per un processo decisionale basato sui dati.

Funzione
Descrizione
avg
Calcola valore medio
count
Numero di elementi non nulli
countOnlyNull
Conta solo valori Null
countWithNull
Conteggio di tutti gli elementi inclusi i valori Null
distinctCount
Conteggio valori univoci non nulli
distinctCountWithNull
Conta valori univoci inclusi i valori Null
max
Trova valore massimo
min
Trova valore minimo
sum
Calcola somma totale

Visualizza tutte le funzioni di aggregazione →

Funzioni di conversione conversion-functions

Trasformazione tipo dati

Converti i dati tra tipi diversi (stringa, numero intero, decimale, booleano, data, durata) per garantire la compatibilità tra le operazioni e le origini dati.

Funzione
Descrizione
toBool
Converti in booleano
toDateOnly
Converti solo in data (nessuna ora)
toDateTime
Converti in data con ora
toDateTimeOnly
Converti in data e ora senza fuso orario
toDecimal
Converti in numero decimale
toDuration
Converti in durata
toInteger
Converti in numero intero
toString
Converti in stringa

Visualizza tutte le funzioni di conversione →

Funzioni data date-functions

Manipolazione di data e ora

Utilizza date, ore e fusi orari per creare condizioni basate sul tempo, pianificare azioni ed eseguire calcoli temporali.

Funzione
Descrizione
currentTimeInMillis
Ottieni ora corrente in millisecondi
dateDiff
Calcola la differenza tra due date o date-ore
inLastDays
Controlla se la data rientra negli ultimi N giorni
inLastHours
Controlla se la data rientra nelle ultime N ore
inLastMonths
Controlla se la data rientra negli ultimi N mesi
inLastYears
Controlla se la data rientra negli ultimi N anni
inNextDays
Controlla se la data rientra nei N giorni successivi
inNextHours
Controlla se la data rientra nelle N ore successive
inNextMonths
Controlla se la data rientra nei successivi N mesi
inNextYears
Controlla se la data rientra nei prossimi N anni
now
Ottieni data/ora corrente
nowWithDelta
Ottieni ora corrente con offset
setHours
Imposta ore specifiche in data/ora
setDays
Imposta giorni specifici in data/ora
updateTimeZone
Aggiorna il fuso orario di data e ora

Visualizza tutte le funzioni data →

Funzioni elenco list-functions

Analisi e manipolazione della raccolta

Filtrare, ordinare, trasformare e analizzare array ed elenchi per lavorare con strutture di dati complesse ed eseguire operazioni quali intersezione, unione e differenza.

Funzione
Descrizione
elenchi differenze
Ottieni elementi in un elenco non presenti in un altro
distinct
Ottieni valori univoci (esclusi i valori Null)
distinctWithNull
Ottieni valori univoci (include valori Null)
filtro
Filtra elenco in base a criteri
getListItem
Ottieni elemento in un indice specifico
in
Controlla se il valore esiste nell’elenco
intersezione
Trovare elementi comuni tra gli elenchi
limite
Limita il numero di elementi restituiti
listSize
Ottieni dimensione elenco
mergeLists
Combinare due elenchi, con o senza deduplicazione
serializeList
Converti elenco in stringa
sort
Ordinare gli elementi dell’elenco

Visualizza tutte le funzioni elenco →

Funzioni matematiche math-functions

Operazioni matematiche

Eseguire calcoli numerici e trasformazioni per l’elaborazione dei dati e la logica di business.

Funzione
Descrizione
random
Genera numero casuale (0-1)
round
Arrotonda al numero intero più vicino

Visualizza tutte le funzioni matematiche →

Funzioni stringa string-functions

Modifica e convalida del testo

Elabora, trasforma, cerca e convalida i dati di testo per la creazione di contenuti dinamici e la logica condizionale.

Funzione
Descrizione
concat
Concatenare stringhe
contain
Controlla se la stringa contiene sottostringa
containIgnoreCase
Seleziona contiene (senza distinzione maiuscole/minuscole)
endWith
Controlla se la stringa termina con il suffisso
endWithIgnoreCase
Seleziona termina con (senza distinzione maiuscole/minuscole)
equalIgnoreCase
Confrontare le stringhe (senza distinzione maiuscole/minuscole)
indexOf
Trova prima posizione occorrenza
isEmpty
Controlla se la stringa è vuota
isNotEmpty
Controlla se la stringa non è vuota
lastIndexOf
Trova ultima posizione occorrenza
length
Ottieni lunghezza stringa
Lower
Converti in minuscolo
matchRegExp
Corrispondenza espressione regolare
notEqualIgnoreCase
Seleziona diverso da (senza distinzione maiuscole/minuscole)
replace
Sostituisci prima occorrenza
replaceAll
Sostituisci tutte le occorrenze
split
Dividi stringa in matrice
startWith
Controlla se la stringa inizia con il prefisso
startWithIgnoreCase
Seleziona inizia con (senza distinzione maiuscole/minuscole)
substr
Estrai sottostringa
trim
Rimuovi spazi iniziali/finali
upper
Converti in maiuscolo
uuid
Genera UUID

Visualizza tutte le funzioni stringa →

Passaggi successivi

Ora che conosci le funzioni disponibili, scopri:

  • Editor espressioni avanzate - Scopri come creare espressioni complesse utilizzando l’editor avanzato
  • Sintassi espressione - Eseguire il master delle regole di sintassi per la scrittura di espressioni di percorso
  • Operatori - Individua gli operatori che puoi utilizzare con le funzioni per generare la logica
  • Riferimenti campo - Comprendere come fare riferimento ai campi dati nelle espressioni
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