Profile Query Language Panoramica di (PQL)
Profile Query Language (PQL) è un Experience Data Model (XDM) compatibile con il linguaggio di query progettato per supportare la definizione e l’esecuzione di query di segmentazione per Real-Time Customer Profile dati.
Questa guida fornisce una panoramica generale di PQL, illustrando le linee guida per la formattazione e fornendo espressioni PQL di esempio.
Formattazione query PQL
Le query PQL hanno la seguente firma:
({INPUT_PARAMETER_1}, {INPUT_PARAMETER_2}, ...) => {RESULT_TYPE}
Il parametro di input può essere un semplice valore primitivo, ad esempio booleano o 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 nel contesto, un riferimento di proprietà (homeAddress
) possono essere apportate direttamente a esso.
homeAddress.stateProvince = workAddress.stateProvince
Riferimento esplicito al primo parametro
Nell’esempio seguente, $1
fa riferimento al primo parametro. Di conseguenza, $2
si riferisce al secondo parametro, ecc.
$1.homeAddress.stateProvince = $1.homeAddress.stateProvince
Utilizzo di variabili denominate, utilizzando la notazione lambda
Nell’esempio seguente, Profile
è un nome di variabile che può essere scelto dall’autore della query.
(Profile) => Profile.homeAddress.stateProvince = Profile.workAddress.stateProvince
PQL letterali
PQL supporta i seguenti tipi letterali:
"pizza"
, "jobs"
, "antidisestablishmentarianism"
true
, false
-201
, 0
, 412
-51.24
, 3.14
, 0.6942058
date(year, month, day)
date(2020, 3, 14)
Nota: Non è possibile accedere direttamente alle proprietà degli elementi all'interno di un array. Pertanto, se devi accedere a una proprietà all’interno di un array, il metodo supportato è
select X from array where X.item = ...
.PQL riserva la parola
xEvent
per fare riferimento a un array di eventi esperienza collegati a un profilo.[1, 4, 7]
, ["US", "CA"]
Parole riservate che possono essere utilizzate per creare riferimenti a marche temporali e intervalli di tempo.
- oggi, ieri, domani
- questo, ultimo, prossimo
- prima, dopo, da
- millisecondo/i, secondo/i, minuto/i, ora/i, giorno/i, settimana/e, mese/i, anno/i, decennio/i, secolo/secoli, millennio/millenni
X.timestamp occurs before today
, X.timestamp occurs last month
, X.timestamp occurs <= 3 days before now
Funzioni PQL
La tabella seguente illustra le diverse categorie di funzioni PQL supportate, inclusi i collegamenti a ulteriore documentazione per ulteriori informazioni.
Passaggi successivi
Ora che hai imparato a utilizzare Profile Query Language, è possibile utilizzare PQL durante la creazione e la modifica delle definizioni dei segmenti. Per ulteriori informazioni sulla segmentazione, consulta panoramica sulla segmentazione.