Visão geral do Profile Query Language (PQL)
Profile Query Language (PQL) é uma linguagem de consulta compatível com Experience Data Model (XDM) projetada para oferecer suporte à definição e execução de consultas de segmentação para dados Real-Time Customer Profile.
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 do 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 a 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 referiria 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 do PQL
O PQL fornece suporte para os seguintes tipos literais:
"pizza", "jobs", "antidisestablishmentarianism"true, false-201, 0, 412-51.24, 3.14, 0.6942058date(year, month, day)date(2020, 3, 14)Observação: 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 aceito é
select X from array where X.item = ....A PQL reserva a palavra
xEvent para se referir a uma matriz 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 nowFunções do PQL
A tabela a seguir descreve as diferentes categorias de funções do PQL compatíveis, incluindo links para documentação adicional para obter mais informações.
Próximas etapas
Agora que você aprendeu a usar o Profile Query Language, é possível usar o PQL ao criar e modificar definições de segmentos. Para obter mais informações sobre segmentação, leia a visão geral sobre segmentação.