Exemplos de consultas query-examples
Esta seção lista vários exemplos usados com frequência para consultar Eventos de etapa da Jornada no Data Lake.
Verifique se os campos usados em suas consultas têm valores associados no esquema correspondente.
- id: exclusiva para todas as entradas de evento de etapa. Dois eventos de etapa diferentes não podem ter a mesma ID.
- instanceId: instanceID é o mesmo para todos os eventos de etapa associados a um perfil em uma execução de jornada. Se um perfil entrar novamente na jornada, uma instanceId diferente será usada. Essa nova instanceId será a mesma para todos os eventos de etapa da instância reinserida (do início ao fim).
- profileID: a identidade do perfil correspondente ao namespace da jornada.
note note |
---|
NOTE |
Para fins de solução de problemas, recomendamos usar journeyVersionID em vez de journeyVersionName ao consultar jornadas. Saiba mais sobre os atributos de propriedades de jornada nesta seção. |
Casos de uso básicos/consultas comuns common-queries
accordion | ||
---|---|---|
Quantos perfis entraram em uma jornada em um determinado período | ||
Esta consulta fornece o número de perfis distintos que entraram na jornada especificada no período. Consulta do Data Lake
|
Exemplo
code language-sql |
---|
|
Consulta do Data Lake
code language-sql |
---|
|
Consulta do Data Lake
code language-sql |
---|
|
Consulta do Data Lake
Esta consulta retorna todos os eventos de etapa e eventos de serviço para o perfil e a jornada fornecidos pelo tempo especificado em ordem cronológica.
code language-sql |
---|
|
Essas consultas podem ser usadas, por exemplo, para estimar o tempo gasto em uma atividade de espera. Isso permite verificar se a atividade de espera está configurada corretamente.
Consulta do Data Lake
code language-sql |
---|
|
Consulta do Data Lake
code language-sql |
---|
|
O conjunto de dados de Eventos de etapa de Jornada contém todos os stepEvents e serviceEvents. stepEvents são usados em relatórios, pois se relacionam a atividades (evento, ações etc.) de perfis em uma jornada. serviceEvents são armazenados no mesmo conjunto de dados e indicam informações adicionais para fins de depuração, por exemplo, o motivo para um descarte de evento de experiência.
Este é um exemplo de consulta para verificar os detalhes de um serviceEvent:
Consulta do Data Lake
code language-sql |
---|
|
Erros de mensagem/ação message-action-errors
accordion | ||||
---|---|---|---|---|
Lista de cada erro encontrado no jornada | ||||
Essa consulta permite listar cada erro encontrado no jornada ao executar uma mensagem/ação. Consulta do Data Lake
Exemplo
Esta consulta retorna todos os erros diferentes que ocorreram ao executar uma ação em uma jornada junto com a contagem de quantas vezes ela ocorreu. |
Consultas baseadas em perfil profile-based-queries
Consulta do Data Lake
code language-sql |
---|
|
Exemplo
code language-sql |
---|
|
O resultado deve ser maior que 0. Esta consulta retorna o número exato de vezes que um perfil inseriu uma jornada.
Método 1: se o nome da mensagem não for exclusivo na jornada (ela é usada em vários locais).
Consulta do Data Lake
code language-sql |
---|
|
Exemplo
code language-sql |
---|
|
O resultado deve ser maior que 0. Esta consulta informa apenas se a ação de mensagem foi executada com êxito no lado da jornada.
Método 2: se o nome da mensagem for exclusivo na jornada.
Consulta do Data Lake
code language-sql |
---|
|
Exemplo
code language-sql |
---|
|
A consulta retorna a lista de todas as mensagens juntamente com sua contagem invocada para o perfil selecionado.
Consulta do Data Lake
code language-sql |
---|
|
Exemplo
code language-sql |
---|
|
A consulta retorna a lista de todas as mensagens juntamente com sua contagem invocada para o perfil selecionado.
Consulta do Data Lake
code language-sql |
---|
|
Exemplo
code language-sql |
---|
|
A consulta retorna a lista de todos os nomes de jornada juntamente com o número de vezes que o perfil consultado inseriu a jornada.
Consulta do Data Lake
code language-sql |
---|
|
Exemplo
code language-sql |
---|
|
O query retorna, para o período definido, o número de perfis que entraram na jornada a cada dia. Se um perfil inserido por meio de várias identidades, ele será contado duas vezes. Se a reentrada estiver ativada, a contagem de perfis poderá ser duplicada em dias diferentes se ela entrar novamente na jornada em dias diferentes.
Consultas relacionadas ao público-alvo de leitura read-segment-queries
Consulta do Data Lake
code language-sql |
---|
|
Exemplo
code language-sql |
---|
|
A consulta retorna a diferença de tempo, em minutos, entre o momento em que o trabalho de exportação de público-alvo foi enfileirado e o momento em que foi encerrado.
Consulta do Data Lake
code language-sql |
---|
|
Exemplo
code language-sql |
---|
|
A consulta retorna todas as IDs de perfil que foram descartadas pela jornada porque estavam duplicadas.
Consulta do Data Lake
code language-sql |
---|
|
Exemplo
code language-sql |
---|
|
A consulta retorna todas as IDs de perfil que foram descartadas pela jornada porque tinham um namespace inválido ou nenhuma identidade para esse namespace.
Consulta do Data Lake
code language-sql |
---|
|
Exemplo
code language-sql |
---|
|
A consulta retorna todas as IDs de perfil que foram descartadas pela jornada porque o mapa de identidade estava ausente.
Consulta do Data Lake
code language-sql |
---|
|
Exemplo
code language-sql |
---|
|
A consulta retorna todas as IDs de perfil que foram descartadas pela jornada porque o trabalho de exportação foi executado no modo de teste, mas o perfil não tinha o atributo testProfile definido como verdadeiro.
Consulta do Data Lake
code language-sql |
---|
|
Exemplo
code language-sql |
---|
|
A consulta retorna todas as IDs de perfil que foram descartadas pela jornada devido a um erro interno.
Consulta do Data Lake
code language-sql |
---|
|
Ele retornará todos os eventos de serviço relacionados à versão do jornada fornecida. Podemos acompanhar a cadeia de operações:
- criação de tópico
- exportar criação de trabalho
- finalização do trabalho de exportação (com métricas em perfis exportados)
- trabalhador processando desligamento
Também podemos detectar problemas como:
- erros no tópico ou na criação do trabalho de exportação (incluindo tempos limite em chamadas da API de exportação de público)
- trabalhos de exportação que podem ficar paralisados (caso em que, para uma determinada versão do jornada, não temos nenhum evento relacionado ao encerramento do trabalho de exportação)
- problemas do trabalhador, se recebermos um evento de desligamento do trabalho de exportação, mas nenhum trabalhador estiver processando um desligamento
IMPORTANTE: se não houver nenhum evento retornado por essa consulta, talvez seja devido a um dos seguintes motivos:
- a versão do jornada não atingiu o cronograma
- se a versão do jornada deveria ter acionado o trabalho de exportação chamando o orchestrator, algo deu errado no fluxo upstram: problema na implantação do jornada, evento comercial ou problema com o scheduler.
Consulta do Data Lake
code language-sql |
---|
|
Consulta do Data Lake
code language-sql |
---|
|
Se nenhum registro for retornado, significa que:
- ocorreu um erro durante a criação do tópico ou do trabalho de exportação
- o trabalho de exportação ainda está em execução
Consulta do Data Lake
code language-sql |
---|
|
Consulta do Data Lake
code language-sql |
---|
|
Esta consulta é diferente da anterior.
Ele retorna as métricas gerais de uma determinada versão do jornada, independentemente das tarefas que podem ter sido executadas para ele (no caso de jornadas recorrentes, eventos comerciais acionados por meio da reutilização de tópicos).
Consultas relacionadas à qualificação de público-alvo segment-qualification-queries
Consulta do Data Lake
code language-sql |
---|
|
Exemplo
code language-sql |
---|
|
Esta consulta retorna todas as IDs de perfil que foram descartadas pela versão do jornada devido à realização incorreta do público-alvo.
Consulta do Data Lake
code language-sql |
---|
|
Exemplo
code language-sql |
---|
|
Esta consulta retorna todos os eventos (eventos externos/eventos de qualificação de público-alvo) que foram descartados por qualquer outro motivo para um perfil.
Consultas baseadas em eventos event-based-queries
Consulta do Data Lake
code language-sql |
---|
|
Exemplo
code language-sql |
---|
|
Consulta do Data Lake
code language-sql |
---|
|
Exemplo
code language-sql |
---|
|
Consulta do Data Lake
code language-sql |
---|
|
Exemplo
code language-sql |
---|
|
Consulta do Data Lake
code language-sql |
---|
|
Exemplo
code language-sql |
---|
|
Consulta do Data Lake
code language-sql |
---|
|
Exemplo
code language-sql |
---|
|
Consultas comuns baseadas em jornada journey-based-queries
Consulta do Data Lake
code language-sql |
---|
|
Exemplo
code language-sql |
---|
|
A consulta retorna, para o período definido, a contagem de jornadas exclusivas que são acionadas a cada dia. Um único acionamento de jornada em vários dias será contado uma vez por dia.
Consultas em instâncias do jornada journey-instances-queries
Consulta do Data Lake
code language-sql |
---|
|
Exemplo
code language-sql |
---|
|
Consulta do Data Lake
code language-sql |
---|
|
Exemplo
code language-sql |
---|
|
Consulta do Data Lake
code language-sql |
---|
|
Exemplo
code language-sql |
---|
|