DocumentazioneExperience PlatformGuida al servizio di segmentazione

Profile Query Language Panoramica di (PQL)

Last update: Thu Jul 13 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

Creato per:

  • User

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:

Letterale
Definizione
Esempio
Stringa
Tipo di dati costituito da caratteri racchiusi tra virgolette doppie.
"pizza", "jobs", "antidisestablishmentarianism"
Booleano
Tipo di dati true o false.
true, false
Intero
Tipo di dati che rappresenta un numero intero. Può essere positivo, negativo o zero.
-201, 0, 412
Doppio
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 parametri di anno, mese e giorno come valori interi. È formattato come date(year, month, day)
date(2020, 3, 14)
Array
Tipo di dati composto da un gruppo di altri valori letterali. Utilizza parentesi quadre per raggruppare e virgole per delimitare tra valori diversi.
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"]
Riferimenti temporali relativi

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.

Categoria
Definizione
Booleano
Utilizzato per implementare l’algebra booleana in PQL. Ulteriori informazioni su queste funzioni sono disponibili nella documento di funzioni booleane.
Confronto
Utilizzato per confrontare tra diversi elementi PQL. Ulteriori informazioni su queste funzioni sono disponibili nella documento sulle funzioni di confronto.
Array, elenco e set
Utilizzato per interagire con array, elenchi e set. Ulteriori informazioni su queste funzioni sono disponibili nella documento sulle funzioni array, list e set.
Mappa
Utilizzato per interagire con le mappe. Ulteriori informazioni su queste funzioni sono disponibili nella documento funzioni mappa.
Stringa
Utilizzato per interagire con le stringhe. Ulteriori informazioni su queste funzioni sono disponibili nella documento funzioni stringa.
Oggetto
Utilizzato per interagire con gli oggetti. Ulteriori informazioni su queste funzioni sono disponibili nella documento funzioni oggetto.
Aritmetica
Utilizzato per eseguire operazioni aritmetiche di base sugli elementi PQL. Ulteriori informazioni su queste funzioni sono disponibili nella documento funzioni aritmetiche
Aggregazione
Utilizzato per combinare i risultati di un array in un singolo risultato. Ulteriori informazioni sulle funzioni di aggregazione sono disponibili nella documento funzioni di aggregazione.
Data e ora
Utilizzato insieme a oggetti data, ora e datetime. Ulteriori informazioni su queste funzioni sono disponibili nella documento funzioni data/ora.
Filtro
Utilizzato per filtrare i dati all’interno di array. Ulteriori informazioni su queste funzioni sono disponibili nella documento funzioni filtro.
Quantificatori logici
Utilizzato per affermare le condizioni all’interno di un array. Ulteriori informazioni sono disponibili nella sezione documento quantificatori logici.
Varie
Le funzioni che non rientrano in nessuna delle categorie precedenti sono disponibili nella documento funzioni varie.

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.

recommendation-more-help
770bc05d-534a-48a7-9f07-017ec1e14871