Información general sobre Profile Query Language (PQL)
Profile Query Language (PQL) es un lenguaje de consulta compatible con Experience Data Model (XDM) diseñado para admitir la definición y ejecución de consultas de segmentación para datos de Real-Time Customer Profile.
Esta guía proporciona información general sobre PQL, e incluye directrices de formato y expresiones PQL de ejemplo.
Formato de consulta PQL
Las consultas de PQL tienen la siguiente firma:
({INPUT_PARAMETER_1}, {INPUT_PARAMETER_2}, ...) => {RESULT_TYPE}
El parámetro de entrada puede ser un primitivo simple, como un booleano o una cadena, o un tipo más complejo, como un objeto, una matriz o un mapa.
Existen tres formas diferentes de hacer referencia a los parámetros de entrada dentro del cuerpo de una expresión PQL:
Referencia implícita al primer parámetro
En el ejemplo siguiente, dado que el primer parámetro siempre está en contexto, se puede hacer una referencia de propiedad (homeAddress) directamente a él.
homeAddress.stateProvince = workAddress.stateProvince
Referencia explícita al primer parámetro
En el ejemplo siguiente, $1 hace referencia al primer parámetro. Como resultado, $2 haría referencia al segundo parámetro, etc.
$1.homeAddress.stateProvince = $1.homeAddress.stateProvince
Uso de variables con nombre, usando la notación lambda
En el ejemplo siguiente, Profile es un nombre de variable, que puede elegir el autor de la consulta.
(Profile) => Profile.homeAddress.stateProvince = Profile.workAddress.stateProvince
Literales de PQL
PQL es compatible con los siguientes tipos literales:
"pizza", "jobs", "antidisestablishmentarianism"true, false-201, 0, 412-51.24, 3.14, 0.6942058date(year, month, day)date(2020, 3, 14)Nota: No puede tener acceso directo a las propiedades de los elementos de una matriz. Por lo tanto, si necesita acceder a una propiedad dentro de una matriz, el método admitido es
select X from array where X.item = ....PQL reserva la palabra
xEvent para hacer referencia a una matriz de eventos de experiencia vinculados a un perfil.[1, 4, 7], ["US", "CA"]Palabras reservadas que se pueden utilizar para formar referencias de intervalo de tiempo y marca de tiempo.
- ahora, hoy, ayer, mañana
- esto, lo último, lo siguiente
- antes, después y desde
- milisegundo(s), segundo(s), minuto(s), hora(s), día(s), semana(s), mes(es), año(s), década(s), siglo/siglos, milenio/milenio
X.timestamp occurs before today, X.timestamp occurs last month, X.timestamp occurs <= 3 days before nowFunciones de PQL
En la tabla siguiente se describen las diferentes categorías de funciones de PQL compatibles, incluidos vínculos a documentación adicional para obtener más información.
Pasos siguientes
Ahora que ha aprendido a usar Profile Query Language, puede usar PQL al crear y modificar definiciones de segmentos. Para obtener más información sobre la segmentación, lea descripción general de la segmentación.