Show Menu
SUJETS×

Présentation du langage PQL (Profil Requête Language)

Le langage PQL (Profil Requête Language) est un langage de requête compatible XDM (Experience Data Model) conçu pour prendre en charge la définition et l’exécution de requêtes de segmentation pour les données de Profil client en temps réel.
Ce guide présente un aperçu général de PQL, qui couvre les lignes directrices de formatage et fournit des exemples d’expressions PQL.

Mise en forme des requêtes PQL

Les requêtes PQL ont la signature suivante :
({INPUT_PARAMETER_1}, {INPUT_PARAMETER_2}, ...) => {RESULT_TYPE}

Le paramètre d’entrée peut être une primitive simple, telle qu’une valeur booléenne ou une chaîne, ou un type plus complexe, tel qu’un objet, un tableau ou une carte.
Il existe trois façons différentes de faire référence aux paramètres d’entrée dans le corps d’une expression PQL :

Référence implicite au premier paramètre

Dans l’exemple ci-dessous, puisque le premier paramètre est toujours en contexte, une référence de propriété ( homeAddress ) peut être directement associée à celui-ci.
homeAddress.stateProvince = workAddress.stateProvince

Référence explicite au premier paramètre

Dans l’exemple ci-dessous, $1 fait référence au premier paramètre. Par conséquent, $2 se reporter au deuxième paramètre, etc.
$1.homeAddress.stateProvince = $1.homeAddress.stateProvince

Utilisation de variables nommées, à l’aide de la notation lambda

Dans l'exemple ci-dessous, Profile est un nom de variable, qui peut être choisi par l'auteur de la requête.
(Profile) => Profile.homeAddress.stateProvince = Profile.workAddress.stateProvince

Littéraux PQL

PQL prend en charge les types littéraux suivants :
Littéral
Définition
Exemple
Chaîne
Type de données composé de caractères entourés de guillemets de doublon.
"pizza" , "jobs" , "antidisestablishmentarianism"
Booléen
Type de données vrai ou faux.
true , false
Entier
Type de données représentant un nombre entier. Il peut être positif, négatif ou nul.
-201 , 0 , 412
Double
Type de données représentant n’importe quel nombre réel. Il peut être positif, négatif ou nul.
-51.24 , 3.14 , 0.6942058
Date
Type de données qui peut être utilisé pour créer des dates basées sur l’année, le mois et le jour sous forme de paramètres entiers. It is formatted as date(year, month, day)
date(2020, 3, 14)
Tableau
Type de données composé en tant que groupe d’autres valeurs littérales. Elle utilise des crochets pour regrouper et des virgules pour délimiter les valeurs.
Remarque : Vous ne pouvez pas accéder directement aux propriétés des éléments d'un tableau. Ainsi, si vous devez accéder à une propriété dans un tableau, la méthode prise en charge est select X from array where X.item = ... .
PQL se réserve le mot xEvent pour faire référence à un ensemble de événements d'expérience liés à un profil.
[1, 4, 7] , ["US", "CA"]
Références temporelles relatives
Mots réservés pouvant être utilisés pour former des références d’horodatage et d’intervalle de temps.
  • maintenant, aujourd'hui, hier, demain
  • this, last, next
  • avant, après, de
  • milliseconde(s), deuxième(s), minute(s), heure(s), jour(s), semaine(s), mois, année(s), décennie(s), siècle/siècles, millénaire/millénaire
X.timestamp occurs before today , X.timestamp occurs last month , X.timestamp occurs <= 3 days before now

Fonctions PQL

Le tableau suivant présente les différentes catégories des fonctions PQL prises en charge, y compris les liens vers d’autres documents pour plus d’informations.
Catégorie
Définition
Booléen
Utilisé pour implémenter l’algèbre booléenne dans PQL. Vous trouverez plus d'informations sur ces fonctions dans le document des fonctions booléennes.
Comparaison
Utilisé pour comparer différents éléments PQL. Pour plus d'informations sur ces fonctions, consultez le document des fonctions de comparaison.
Tableau, liste et ensemble
Utilisé pour interagir avec des tableaux, des listes et des ensembles. Vous trouverez plus d'informations sur ces fonctions dans le document Fonctions de tableau, de liste et de définition de la baie, de la liste et des fonctions de définition.
Carte
Utilisé pour interagir avec les cartes. Vous trouverez plus d'informations sur ces fonctions dans le document des fonctions de carte.
Chaîne
Utilisé pour interagir avec des chaînes. Vous trouverez plus d'informations sur ces fonctions dans le document des fonctions de chaîne.
Arithmétique
Utilisé pour effectuer des opérations arithmétiques de base sur des éléments PQL. Vous trouverez plus d'informations sur ces fonctions dans le document des fonctions arithmétiques
Agrégation
Utilisé pour combiner les résultats d'un tableau en un résultat unique. Vous trouverez plus d'informations sur les fonctions d'agrégation dans le document des fonctions d' agrégation.
Date et heure
Utilisé conjointement avec les objets Date, Heure et Date-Time. Vous trouverez plus d'informations sur ces fonctions dans le document des fonctions date/heure.
Filtrer
Utilisé pour filtrer les données dans les tableaux. Vous trouverez plus d'informations sur ces fonctions dans le document des fonctions de filtrage.
Quantificateurs logiques
Utilisé pour insérer des conditions dans un tableau. Vous trouverez plus d'informations dans le document des quantificateurs logiques.
Divers
Les fonctions qui ne correspondent à aucune des catégories ci-dessus se trouvent dans le document des fonctions diverses.

Étapes suivantes

Maintenant que vous avez appris à utiliser le langage de Requête de Profil, vous pouvez utiliser PQL lors de la création et de la modification de segments. Pour plus d’informations sur la segmentation, consultez la présentation de la segmentation.