Show Menu
ARGOMENTI×

Panoramica della lingua query profilo (PQL)

PQL (Profile Query Language) è un linguaggio di query compatibile con Experience Data Model (XDM) progettato per supportare la definizione e l'esecuzione di query di segmentazione per i dati del profilo cliente in tempo reale.
Questa guida fornisce una panoramica generale del linguaggio PQL, con linee guida per la formattazione e con espressioni PQL di esempio.

Formattazione query PQL

Le query PQL hanno la firma seguente:
({INPUT_PARAMETER_1}, {INPUT_PARAMETER_2}, ...) => {RESULT_TYPE}

Il parametro di input può essere un semplice carattere primitivo, ad esempio un valore booleano o una stringa, oppure un tipo più complesso, ad esempio un oggetto, un array o una mappa.
Esistono tre modi diversi per fare riferimento ai parametri di input all'interno del corpo di un'espressione PQL:

Riferimento implicito al primo parametro

Nell'esempio seguente, poiché il primo parametro è sempre contestuale, è possibile farvi direttamente riferimento da una proprietà ( homeAddress ).
homeAddress.stateProvince = workAddress.stateProvince

Riferimento esplicito al primo parametro

Nell'esempio seguente, $1 si riferisce al primo parametro. Di conseguenza, $2 si riferiva al secondo parametro, ecc.
$1.homeAddress.stateProvince = $1.homeAddress.stateProvince

Utilizzo di variabili denominate, utilizzando la notazione lambda

Nell’esempio seguente Profile è riportato un nome di variabile, che può essere scelto dall’autore della query.
(Profile) => Profile.homeAddress.stateProvince = Profile.workAddress.stateProvince

Valori letterali PQL

PQL supporta i seguenti tipi letterali:
Letterale
Definizione
Esempio
Stringa
Un tipo di dati composto da caratteri racchiusi tra virgolette doppie.
"pizza" , "jobs" , "antidisestablishmentarianism"
Booleano
Tipo di dati vero o falso.
true , false
Intero
Tipo di dati che rappresenta un numero intero. Può essere positivo, negativo o zero.
-201 , 0 , 412
Doppio
Un tipo di dati che rappresenta qualsiasi numero reale. Può essere positivo, negativo o zero.
-51.24 , 3.14 , 0.6942058
Data
Tipo di dati che può essere utilizzato per creare date basate su anno, mese e giorno come parametri interi. È formattato come date(year, month, day)
date(2020, 3, 14)
Matrice
Tipo di dati composto da un gruppo di altri valori letterali. Utilizza parentesi quadre per raggruppare e virgole per delimitare valori diversi.
Nota: Non è possibile accedere direttamente alle proprietà degli elementi all'interno di una matrice. Pertanto, se è necessario accedere a una proprietà all'interno di un array, il metodo supportato è select X from array where X.item = ... .
PQL si riserva la parola xEvent per fare riferimento a una serie di eventi esperienza collegati a un profilo.
[1, 4, 7] , ["US", "CA"]
Riferimenti temporali relativi
Parole riservate che possono essere utilizzate per creare riferimenti di marca temporale e di intervallo di tempo.
  • oggi, oggi, ieri, domani
  • questo, ultimo, successivo
  • prima, dopo
  • millisecondi, secondi, minuti, ore, giorni, settimane, mesi, anni, decennio/i, secoli/i
X.timestamp occurs before today , X.timestamp occurs last month , X.timestamp occurs <= 3 days before now

Funzioni PQL

Nella tabella seguente sono illustrate le diverse categorie di funzioni PQL supportate, compresi i collegamenti verso ulteriori informazioni.
Categoria
Definizione
Booleano
Utilizzato per implementare l'algebra booleana in PQL. Ulteriori informazioni su queste funzioni sono reperibili nel documento sulle funzioni booleane.
Confronto
Utilizzato per confrontare tra diversi elementi PQL. Ulteriori informazioni su queste funzioni sono reperibili nel documento sulle funzioni di confronto.
Array, list e set
Utilizzato per interagire con array, elenchi e set. Ulteriori informazioni su queste funzioni si trovano nel documento Funzioni di array, elenco e set matrice, elenco e funzioni impostate.
Mappa
Utilizzato per interagire con le mappe. Ulteriori informazioni su queste funzioni sono reperibili nel documento sulle funzioni mappa.
Stringa
Utilizzato per interagire con le stringhe. Ulteriori informazioni su queste funzioni sono reperibili nel documento sulle funzioni stringa.
Aritmetica
Utilizzato per eseguire l'aritmetica di base sugli elementi PQL. Ulteriori informazioni su queste funzioni sono reperibili nel documento sulle funzioni aritmetiche
Aggregazione
Utilizzato per combinare i risultati di un array in un singolo risultato. Ulteriori informazioni sulle funzioni di aggregazione sono disponibili nel documento sulle funzioni di aggregazione.
Data e ora
Utilizzato insieme agli oggetti data, ora e data/ora. Ulteriori informazioni su queste funzioni sono reperibili nel documento sulle funzioni data/ora.
Filtro
Utilizzato per filtrare i dati all'interno di array. Ulteriori informazioni su queste funzioni sono reperibili nel documento sulle funzioni filtro.
Quantificatori logici
Utilizzato per asserire condizioni all'interno di un array. Ulteriori informazioni sono disponibili nel documento quantificatori logici.
Varie
Le funzioni che non rientrano in nessuna delle categorie di cui sopra si trovano nel documento delle funzioni varie.

Passaggi successivi

Ora che hai imparato a usare la lingua query profilo, puoi usare PQL per creare e modificare i segmenti. Per ulteriori informazioni sulla segmentazione, consulta la panoramica sulla segmentazione .