Profile Query Language Visão geral do (PQL)
Profile Query Language (PQL) é uma Experience Data Model Linguagem de consulta compatível com (XDM) projetada para oferecer suporte à definição e execução de consultas de segmentação para Real-Time Customer Profile dados.
Este guia fornece uma visão geral do PQL, abordando diretrizes de formatação e fornecendo exemplos de expressões PQL.
Formatação de consulta PQL
As consultas PQL têm a seguinte assinatura:
({INPUT_PARAMETER_1}, {INPUT_PARAMETER_2}, ...) => {RESULT_TYPE}
O parâmetro de entrada pode ser um primitivo simples, como um booleano ou uma string, ou um tipo mais complexo, como um objeto, matriz ou mapa.
Há três maneiras diferentes de fazer referência aos parâmetros de entrada no corpo de uma expressão PQL:
Referência implícita ao primeiro parâmetro
No exemplo abaixo, como o primeiro parâmetro está sempre em contexto, uma referência de propriedade (homeAddress
) pode ser feita diretamente para ele.
homeAddress.stateProvince = workAddress.stateProvince
Referência explícita ao primeiro parâmetro
No exemplo abaixo, $1
refere-se ao primeiro parâmetro. Como resultado, $2
se refere ao segundo parâmetro etc.
$1.homeAddress.stateProvince = $1.homeAddress.stateProvince
Uso de variáveis nomeadas, usando a notação lambda
No exemplo abaixo, Profile
é um nome de variável, que pode ser escolhido pelo autor da consulta.
(Profile) => Profile.homeAddress.stateProvince = Profile.workAddress.stateProvince
Literais PQL
O PQL fornece suporte para os seguintes tipos literais:
"pizza"
, "jobs"
, "antidisestablishmentarianism"
true
, false
-201
, 0
, 412
-51.24
, 3.14
, 0.6942058
date(year, month, day)
date(2020, 3, 14)
Nota: Não é possível acessar diretamente as propriedades dos itens em uma matriz. Portanto, se você precisar acessar uma propriedade em uma matriz, o método compatível é
select X from array where X.item = ...
.A PQL reserva a palavra
xEvent
para consultar uma variedade de eventos de experiência vinculados a um perfil.[1, 4, 7]
, ["US", "CA"]
Palavras reservadas que podem ser usadas para formar referências de carimbo de data e hora e intervalo de tempo.
- hoje, ontem, amanhã
- este, último, próximo
- antes, depois, de
- milissegundo(s), segundo(s), minuto(s), hora(s), dia(s), semana(s), mês(es), ano(s), década(s), século/séculos, milênio/milênio
X.timestamp occurs before today
, X.timestamp occurs last month
, X.timestamp occurs <= 3 days before now
Funções PQL
A tabela a seguir descreve as diferentes categorias de funções PQL compatíveis, incluindo links para documentação adicional a fim de obter mais informações.
Próximas etapas
Agora que você aprendeu a usar Profile Query Language, é possível usar o PQL ao criar e modificar definições de segmento. Para obter mais informações sobre segmentação, leia o visão geral da segmentação.