DocumentatieExperience PlatformGids voor Segmentation Service

Overzicht van Profile Query Language (PQL)

Last update: Tue Jul 16 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Onderwerpen:

Gemaakt voor:

  • Gebruiker

Profile Query Language (PQL) is een Experience Data Model (XDM) compatibele querytaal die is ontworpen om de definitie en uitvoering van segmenteringsquery's voor Real-Time Customer Profile -gegevens te ondersteunen.

Deze handleiding biedt een algemeen overzicht van PQL, met opmaakrichtlijnen en voorbeelden van PQL-expressies.

PQL-queryopmaak

PQL-query's hebben de volgende handtekening:

({INPUT_PARAMETER_1}, {INPUT_PARAMETER_2}, ...) => {RESULT_TYPE}

De invoerparameter kan een eenvoudige primitieve parameter zijn, zoals een booleaanse tekenreeks of een complexer type, zoals een object, array of kaart.

Er zijn drie verschillende manieren om naar invoerparameters binnen de hoofdtekst van een PQL-expressie te verwijzen:

Impliciete verwijzing naar de eerste parameter

In het onderstaande voorbeeld, aangezien de eerste parameter altijd in context is, kan een bezitsverwijzing (homeAddress) direct aan het worden gemaakt.

homeAddress.stateProvince = workAddress.stateProvince

Expliciete verwijzing naar de eerste parameter

In het onderstaande voorbeeld verwijst $1 naar de eerste parameter. Als gevolg hiervan verwijst $2 bijvoorbeeld naar de tweede parameter.

$1.homeAddress.stateProvince = $1.homeAddress.stateProvince

Gebruik van benoemde variabelen met de lambda-notatie

In het onderstaande voorbeeld is Profile een variabelenaam die door de auteur van de query kan worden gekozen.

(Profile) => Profile.homeAddress.stateProvince = Profile.workAddress.stateProvince

PQL literals

PQL biedt ondersteuning voor de volgende letterlijke typen:

Letterlijk
Definitie
Voorbeeld
String
Een gegevenstype dat bestaat uit tekens die worden omringd door dubbele aanhalingstekens.
"pizza", "jobs", "antidisestablishmentarianism"
Boolean
Een gegevenstype dat waar of onwaar is.
true, false
Geheel
Een gegevenstype dat een geheel getal vertegenwoordigt. Het kan positief, negatief, of nul zijn.
-201, 0, 412
Dubbel
A data type representing any real number. Het kan positief, negatief, of nul zijn.
-51.24, 3.14, 0.6942058
Datum
Een gegevenstype dat kan worden gebruikt om datums te maken op basis van het jaar, de maand en de dag als parameters van gehele getallen. Het is opgemaakt als date(year, month, day)
date(2020, 3, 14)
Array
Een gegevenstype dat is samengesteld als een groep andere letterlijke waarden. Er worden vierkante haakjes gebruikt om te groeperen en komma's om te scheiden tussen verschillende waarden.
Nota: u kunt tot eigenschappen van punten binnen een serie direct toegang hebben. Dus als u toegang moet krijgen tot een eigenschap binnen een array, is de ondersteunde methode select X from array where X.item = ... .
PQL behoudt zich het woord xEvent voor om te verwijzen naar een array van ervaringsgebeurtenissen die aan een profiel zijn gekoppeld.
[1, 4, 7], ["US", "CA"]
Relatieve tijdverwijzingen

Gereserveerde woorden die kunnen worden gebruikt om tijdstempel en tijdinterval verwijzingen te vormen.

  • nu, vandaag, gisteren, morgen
  • dit, laatste, volgende
  • voor, na, van
  • millisecond(en), seconde(n), minuut(n), uur, dag(en), week(en), maand(en), jaar(en), decennium(en), eeuw/eeuwen, millennium/millennium
X.timestamp occurs before today, X.timestamp occurs last month, X.timestamp occurs <= 3 days before now

PQL-functies

In de volgende tabel worden de verschillende categorieën ondersteunde PQL-functies beschreven, waaronder koppelingen naar verdere documentatie voor meer informatie.

Categorie
Definitie
Boolean
Wordt gebruikt om Booleaanse algebra te implementeren in PQL. Meer informatie over deze functies kan in het worden gevonden booleaanse functiedocument.
Vergelijking
Wordt gebruikt om verschillende PQL-elementen te vergelijken. Meer informatie over deze functies kan in het document van vergelijkingsfuncties worden gevonden.
Array, list en set
Wordt gebruikt voor interactie met arrays, lijsten en sets. Meer informatie over deze functies kan in de serie worden gevonden, lijst, en reeks functies document.
Kaart
Wordt gebruikt voor interactie met kaarten. Meer informatie over deze functies kan in het document van kaartfuncties worden gevonden.
String
Wordt gebruikt voor interactie met tekenreeksen. Meer informatie over deze functies kan in het document van de koordfuncties worden gevonden.
Object
Wordt gebruikt voor interactie met objecten. Meer informatie over deze functies kan in het document van objecten functiesworden gevonden.
Rekenkundig
Wordt gebruikt voor het uitvoeren van rekenkundige basisbewerkingen op PQL-elementen. Meer informatie over deze functies kan in het rekenkundige functiedocumentworden gevonden
Samenvoeging
Wordt gebruikt om resultaten van een array te combineren in een enkel resultaat. Meer informatie over samenvoegingsfuncties kan in het document van de samenvoegingsfuncties worden gevonden.
Datum en tijd
Wordt gebruikt in combinatie met datum-, tijd- en datetime-objecten. Meer informatie over deze functies kan in het datum/tijdfunctiedocumentworden gevonden.
Filter
Wordt gebruikt om gegevens binnen arrays te filteren. Meer informatie over deze functies kan in het document van de filterfuncties worden gevonden.
Logische kwantoren
Wordt gebruikt om voorwaarden binnen een array te bevestigen. Meer informatie kan in het logische kwantoren documentworden gevonden.
Overige
De functies die niet in om het even welke bovengenoemde categorieën passen kunnen in het diverse functiedocumentworden gevonden.

Volgende stappen

Nu u hebt geleerd hoe u Profile Query Language kunt gebruiken, kunt u PQL gebruiken bij het maken en wijzigen van segmentdefinities. Voor meer informatie over segmentatie, gelieve het segmentatieoverzichtte lezen.

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