Fonctions functions

Les fonctions sont les blocs fondateurs des expressions de parcours dynamique dans Adobe Journey Optimizer. Elles permettent de transformer, calculer, valider et manipuler des données en temps réel pour créer des expériences clientèle personnalisées. Avec plus de 60 fonctions organisées en catégories intuitives, vous pouvez créer des conditions sophistiquées, effectuer des calculs complexes et prendre des décisions basées sur les données à chaque étape du parcours clientèle.

Comprendre les fonctions

Les fonctions des expressions de parcours suivent un modèle de syntaxe cohérent :

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

Caractéristiques principales :

  • Signatures multiples : une fonction peut avoir différentes signatures (différents ensembles de paramètres ordonnés) pour s’adapter à divers cas d’utilisation.
  • Renvois spécifiques au type : chaque fonction a un type renvoyé spécifique (chaîne, entier, booléen, date, liste, etc.).
  • Paramètres zéro à N : les fonctions peuvent accepter des expressions 0 à N en tant que paramètres ordonnés, ce qui assure une certaine flexibilité quant à leur utilisation.

Pourquoi utiliser les fonctions ?

Les fonctions permettent d’effectuer les opérations suivantes :

  • Créer des conditions dynamiques - Divisez des chemins de parcours sur la base d’une évaluation des données en temps réel.
  • Personnaliser à grande échelle - Personnalisez le contenu et les expériences à l’aide des données clientèle et des informations comportementales.
  • Automatiser les décisions - Créez une logique intelligente sans intervention manuelle.
  • Transformer les données - Convertissez, mettez en forme et manipulez les types de données pour garantir leur compatibilité.
  • Effectuer des calculs - Exécutez des opérations mathématiques et des analyses statistiques.
  • Valider les entrées - Vérifiez la qualité et l’exhaustivité des données avant d’effectuer une action.

Fonctions par catégorie

Parcourez les fonctions organisées selon leur objectif principal afin de trouver rapidement l’outil adapté à vos besoins.

Adobe Experience Platform aep-functions

Segmentation d’audience et ciblage

Évaluez l’appartenance à une audience pour créer des chemins de parcours personnalisés en fonction des segments de clientèle définis dans Adobe Experience Platform.

Fonction
Description
inAudience
Vérifie si un individu appartient à une audience spécifique.

Affiche des détails de la fonction Adobe Experience Platform →

Fonctions d’agrégation aggregation-functions

Calculs statistiques et synthèse des données

Effectuez des calculs sur des ensembles de valeurs afin d’obtenir des informations telles que des moyennes, des nombres, des sommes et des valeurs minimum et maximum. Essentiel pour la prise de décision axée sur les données.

Fonction
Description
avg
Calcule la valeur moyenne.
count
Compte les éléments non nuls.
countOnlyNull
Compte uniquement les valeurs nulles.
countWithNull
Compte tous les éléments, y compris les nuls.
distinctCount
Compte les valeurs uniques non nulles.
distinctCountWithNull
Compte les valeurs uniques, y compris les nulles.
max
Trouve la valeur maximale
min
Trouve la valeur minimale
sum
Calcule la somme totale

Affiche toutes les fonctions d’agrégation →

Fonctions de conversion conversion-functions

Transformation du type de données

Convertissez des données entre différents types (chaîne, entier, décimal, booléen, date, durée) pour garantir la compatibilité entre les opérations et les sources de données.

Fonction
Description
toBool
Convertit en booléen
toDateOnly
Convertit en date uniquement (pas d’heure)
toDateTime
Convertit en date avec heure
toDateTimeOnly
Convertit en date-heure sans fuseau horaire
toDecimal
Convertit en nombre décimal
toDuration
Convertit en durée
toInteger
Convertit en entier
toString
Convertit en chaîne

Affiche toutes les fonctions de conversion →

Fonctions de date date-functions

Manipulation de date et d’heure

Utilisez les dates, heures et fuseaux horaires pour créer des conditions temporelles, planifier des actions et effectuer des calculs temporels.

Fonction
Description
currentTimeInMillis
Obtient l’heure actuelle en millisecondes
inLastDays
Vérifie si la date est comprise dans les N derniers jours
inLastHours
Vérifie si la date est comprise dans les N dernières heures
inLastMonths
Vérifiee si la date est comprise dans les N derniers mois
inLastYears
Vérifie si la date est comprise dans les N dernières années
inNextDays
Vérifie si la date est comprise dans les N prochains jours
inNextHours
Vérifie si la date est comprise dans les N prochaines heures
inNextMonths
Vérifie si la date est comprise dans les N prochains mois
inNextYears
Vérifie si la date est comprise dans les N prochaines années
now
Obtient la date et l’heure actuelles
nowWithDelta
Obtient l’heure actuelle avec décalage
setHours
Définit des heures spécifiques dans date-heure
setDays
Définit des jours spécifiques dans date-heure
updateTimeZone
Met à jour le fuseau horaire de date-heure

Affiche toutes les fonctions de date →

Fonctions de liste list-functions

Manipulation et analyse des collections

Filtrez, triez, transformez et analysez des tableaux et des listes pour travailler avec des structures de données complexes et effectuer des opérations sur des ensembles.

Fonction
Description
distinct
Obtient des valeurs uniques (à l’exclusion des valeurs nulles)
distinctWithNull
Obtient des valeurs uniques (y compris les valeurs nulles)
filter
Filtre la liste en fonction de critères
getListItem
Obtient un élément à un index spécifique
in
Vérifie si la valeur existe dans la liste
intersect
Recherche des éléments communs entre les listes
limit
Limite le nombre d’éléments renvoyés
listSize
Obtient la taille de la liste
serializeList
Convertit la liste en chaîne
sort
Trie des éléments de liste

Affiche toutes les fonctions de liste →

Fonctions mathématiques math-functions

Opérations mathématiques

Effectuez des calculs numériques et des transformations pour le traitement des données et la logique métier.

Fonction
Description
random
Génère un nombre aléatoire (0-1)
round
Arrondit à l’entier le plus proche

Affiche toutes les fonctions mathématiques →

Fonctions de chaîne string-functions

Manipulation et validation de texte

Traitez, transformez, recherchez et validez des données de texte pour la création de contenu dynamique et la logique conditionnelle.

Fonction
Description
concat
Concatène des chaînes
contain
Vérifie si la chaîne contient une sous-chaîne
containIgnoreCase
Vérifie si contient (non-respect de la casse)
endWith
Vérifie si la chaîne se termine par le suffixe
endWithIgnoreCase
Vérifie si se termine par (non-respect de la casse)
equalIgnoreCase
Comparer les chaînes (non-respect de la casse)
indexOf
Rechercher la position de la première occurrence
isEmpty
Vérifie si la chaîne est vide
isNotEmpty
Vérifie que la chaîne n’est pas vide
lastIndexOf
Recherche la position de la dernière occurrence
length
Obtient la longueur de chaîne
lower
Convertit en minuscules
matchRegExp
Fait correspondre une expression régulière
notEqualIgnoreCase
Vérifie l’inégalité (non-respect de la casse)
replace
Remplace la première occurrence
replaceAll
Remplace toutes les occurrences
split
Partage une chaîne en tableau
startWith
Vérifie si la chaîne commence par le préfixe
startWithIgnoreCase
Vérifie si commence par (non-respect de la casse)
substr
Extrait la sous-chaîne
trim
Supprime les espaces de début et de fin
upper
Convertit en majuscules
uuid
Génère l’UUID

Affiche toutes les fonctions de chaîne →

Étapes suivantes

Maintenant que vous comprenez les fonctions disponibles, découvrez ce qui suit :

  • Éditeur d’expression avancé : découvrez comment créer des expressions complexes à l’aide de l’éditeur avancé.
  • Syntaxe des expressions : maîtrisez des règles de syntaxe pour écrire des expressions de parcours.
  • Opérateurs : découvrez les opérateurs que vous pouvez utiliser avec les fonctions pour créer une logique.
  • Références de champ : découvrez comment référencer des champs de données dans vos expressions.
Référence des connaissances sur l’IA

Cette section contient des connaissances structurées destinées à soutenir l’interprétation, la récupération et la réponse aux questions liées à ce sujet.

Pour une compréhension totale, ces informations doivent être combinées avec la documentation de cette page. Aucune des sources n’est conçue pour être autonome. La page décrit la fonctionnalité, tandis que cette section fournit un contexte supplémentaire qui permet de clarifier la terminologie, l’intention, l’applicabilité et les contraintes.

  • TL;DR: Cette page est une référence catégorisée de plus de 60 fonctions intégrées disponibles dans l’éditeur d’expression avancé de Parcours, couvrant l’agrégation, la conversion, la date/heure, la liste, les mathématiques, la chaîne et les fonctions d’audience Adobe Experience Platform.

Intentions:

  • Identifiez la fonction appropriée pour une tâche en parcourant les tableaux de fonctions catégorisés
  • Transformer les types de données entre chaîne, entier, décimal, booléen, date et durée à l’aide de fonctions de conversion
  • Filtrage basé sur la date avec des fonctions telles que inLastDays, inNextHours et nowWithDelta
  • Manipulez et validez les valeurs de chaîne à l’aide de fonctions telles que contain, replace, split et trim
  • Effectuer des calculs statistiques sur des collections à l’aide de fonctions d’agrégation telles que count, avg, sum et distinctCount
  • Vérifiez l’appartenance à une audience dans des conditions de parcours à l’aide de la fonction inAudience

Glossaire:

  • Fonctions d’agrégation : fonctions qui calculent une seule valeur (nombre, somme, moyenne, min, max) à partir d’une collection de valeurs (spécifique au produit)
  • Fonctions de conversion : fonctions qui convertissent une valeur d’un type de données en un autre (par exemple, toString, toDateTime, toDuration) (spécifique au produit)
  • Fonctions de date : fonctions permettant d’utiliser les valeurs de date, d’heure et de fuseau horaire dans les expressions de parcours (spécifiques au produit)
  • Fonctions de liste : fonctions de filtrage, de tri et d’analyse des de données de tableau/collection (spécifiques au produit)
  • inAudience : fonction qui vérifie si un profil appartient à un de segment d’audience Adobe Experience Platform spécifié (spécifique au produit)

Mécanismes de sécurisation :

  • Les fonctions suivent une syntaxe cohérente : functionName(param1, param2, ...)
  • Une fonction peut avoir plusieurs signatures (différents jeux de paramètres) pour gérer différents cas d’utilisation
  • Chaque fonction possède un type de retour fixe — assurez-vous que le type de retour correspond à ce que le contexte d’expression attend
  • Les fonctions disponibles dans l’éditeur d’expression de Parcours diffèrent de celles de l’éditeur de personnalisation

Terminologie:

  • Nom canonique : Fonctions — Acronyme : none — variantes : fonctions intégrées, fonctions d’expression
  • Synonymes : « fonctions d’agrégation » = « fonctions statistiques »; « fonctions de conversion » = « fonctions de conversion de type »
  • À ne pas confondre : fonctions d’expression de parcours ≠ fonctions d’éditeur de personnalisation (ensembles différents)

FAQ:

  • Q : Combien de fonctions sont disponibles dans l’éditeur d’expression de Parcours ? — Plus de 60 fonctions organisées en catégories, y compris l’agrégation, la conversion, la date, la liste, les mathématiques, la chaîne et Adobe Experience Platform.
  • Q : Comment puis-je vérifier si un profil appartient à une audience dans une condition de parcours ? — Utilisez la fonction inAudience avec l’identifiant de l’audience.
  • Q : Quelle fonction dois-je utiliser pour obtenir la date et l’heure actuelles décalées d’un certain nombre de jours ? — Utilisez nowWithDelta(N, "days") pour obtenir un décalage dateTime par rapport à l’heure actuelle.
  • Q : Une fonction peut-elle renvoyer différents types selon la manière dont elle est appelée ? — Une fonction possède un type de retour spécifique par signature, mais un nom de fonction unique peut posséder plusieurs signatures avec différents jeux de paramètres et types de retour.
  • Q : Quelle est la différence entre count et countWithNull ?count compte uniquement les éléments non nuls ; countWithNull compte tous les éléments, y compris les nulls.
recommendation-more-help
journey-optimizer-help