Übersicht zu Profile Query Language (PQL)
Profile Query Language (PQL) ist eine Experience Data Model (XDM)-konforme Abfragesprache, die die Definition und Ausführung von Segmentierungsabfragen für Real-Time Customer Profile-Daten unterstützt.
Dieses Handbuch bietet einen allgemeinen Überblick über PQL, einschließlich Formatierungsrichtlinien und PQL-Beispielausdrücken.
Formatierung von PQL-Abfragen
PQL-Abfragen haben die folgende Signatur:
({INPUT_PARAMETER_1}, {INPUT_PARAMETER_2}, ...) => {RESULT_TYPE}
Der Eingabeparameter kann ein einfaches Primitiv sein, z. B. ein boolescher Wert, eine Zeichenfolge oder ein komplexerer Typ wie ein Objekt, ein Array oder eine Zuordnung.
Es gibt drei verschiedene Möglichkeiten, auf Eingabeparameter innerhalb eines PQL-Ausdrucks zu verweisen:
Impliziter Verweis auf den ersten Parameter
Da sich der erste Parameter immer im Kontext befindet, kann im folgenden Beispiel ein direkter Eigenschaftsverweis (homeAddress) darauf erfolgen.
homeAddress.stateProvince = workAddress.stateProvince
Expliziter Verweis auf den ersten Parameter
Im folgenden Beispiel bezieht sich $1 auf den ersten Parameter. Daher verweist $2 auf den zweiten Parameter usw.
$1.homeAddress.stateProvince = $1.homeAddress.stateProvince
Verwendung benannter Variablen unter Verwendung der Lambda-Notation
Im folgenden Beispiel ist Profile ein Variablenname, der vom Abfrageautor ausgewählt werden kann.
(Profile) => Profile.homeAddress.stateProvince = Profile.workAddress.stateProvince
PQL-Literale
PQL unterstützt die folgenden Literaltypen:
"pizza", "jobs", "antidisestablishmentarianism"true, false-201, 0, 412-51.24, 3.14, 0.6942058date(year, month, day).date(2020, 3, 14)Hinweis: Sie können nicht direkt auf die Eigenschaften von Elementen in einem Array zugreifen. Wenn Sie also auf eine Eigenschaft in einem Array zugreifen müssen, wird
select X from array where X.item = ... als Methode unterstützt.PQL reserviert das Wort
xEvent, um auf ein Array von Erlebnisereignissen zu verweisen, die mit einem Profil verknüpft sind.[1, 4, 7], ["US", "CA"]Reservierte Wörter, die verwendet werden können, um Zeitstempel und Zeitintervallverweise zu bilden.
- now, today, yesterday, tomorrow
- this, last, next
- before, after, from
- millisecond(s), second(s), minute(s), hour(s), day(s), week(s), month(s), year(s), decade(s), century/centuries, millennium/millennia
X.timestamp occurs before today, X.timestamp occurs last month, X.timestamp occurs <= 3 days before nowPQL-Funktionen
In der folgenden Tabelle sind die verschiedenen Kategorien unterstützter PQL-Funktionen aufgeführt, einschließlich Links zu weiterer Dokumentation mit zusätzlichen Informationen.
Nächste Schritte
Da Sie nun wissen, wie Sie Profile Query Language (PQL) verwenden, können Sie damit Segment-Definitionen erstellen und ändern. Weiterführende Informationen zur Segmentierung finden Sie in der Segmentierungsübersicht.