Exemplos de consultas query-examples
Esta seção fornece exemplos usados com frequência para consultar eventos de etapa de Jornada no Data Lake. Antes de mergulhar em casos de uso específicos, é importante entender os identificadores-chave usados nos dados do evento de jornada.
Verifique se os campos usados em suas consultas têm valores associados no esquema correspondente.
Noções básicas sobre identificadores de chave key-identifiers
- 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á igual 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
Esta consulta fornece o número de perfis distintos que entraram na jornada especificada no período.
Consulta do Data Lake
| code language-sql |
|---|
|
Saiba como solucionar problemas de tipos de eventos descartados em jornada_step_events.
Esta consulta retorna o conjunto de regras rejeitado e as informações da regra quando um perfil é impedido de inserir uma jornada devido às regras de limitação ou qualificação.
Exemplo
| code language-sql |
|---|
|
Esta consulta retorna os detalhes do evento da etapa para perfis que foram descartados durante uma jornada e não receberam uma ação de jornada. Isso ajuda a identificar por que os perfis foram descartados devido a regras de negócios, como restrições de horários silenciosos.
Consulta do Data Lake
| code language-sql |
|---|
|
Exemplo
| code language-sql |
|---|
|
Os resultados da consulta exibem campos-chave que ajudam a identificar o motivo dos descartes de perfil:
-
actionExecutionError - Quando definido como
businessRuleProfileDiscarded, isso indica que o perfil foi descartado devido a uma regra de negócios. O campoeventTypefornece detalhes adicionais sobre qual regra de negócios específica causou o descarte. -
eventType - Especifica o tipo de regra de negócios que causou o descarte:
quietHours: o perfil foi descartado devido à configuração de horários de silêncioforcedDiscardDueToQuietHours: o perfil foi descartado à força porque o limite de grade de proteção foi atingido para perfis mantidos em horas de silêncio
Essa consulta conta os perfis distintos que apresentaram erros em cada nó de uma jornada, agrupados por nome de nó. Inclui todos os tipos de erros de execução de ação e erros de busca.
Consulta do Data Lake
| code language-sql |
|---|
|
Esta consulta conta o número total de eventos que foram descartados de uma jornada. Ele filtra vários códigos de evento de descarte, incluindo erros de trabalho de exportação de segmento, descartes do Dispatcher e descartes da máquina de estado.
Consulta do Data Lake
| code language-sql |
|---|
|
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.
Consulta do Data Lake
| 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.
Exemplo de saída
Esta consulta retorna todos os erros diferentes que ocorreram ao executar uma ação em uma jornada, juntamente com a contagem de quantas vezes cada erro ocorreu, ordenada por frequência. |
Consultas baseadas em perfil profile-based-queries
Esta consulta verifica se um perfil específico inseriu uma jornada, contando os eventos associados a esse perfil e a combinação de jornada.
| code language-sql |
|---|
|
Exemplo de saída
| table 0-row-1 1-row-1 |
|---|
| EVENT_COUNT |
| 3 |
Esta consulta retorna o número exato de vezes que um perfil inseriu uma jornada. Um resultado maior que 0 confirma que o perfil entrou na jornada.
Método 1: se o nome da mensagem não for exclusivo na jornada (ela é usada em vários locais).
| code language-sql |
|---|
|
Exemplo de saída
| table 0-row-1 1-row-1 |
|---|
| MESSAGE_SENT_COUNT |
| 1 |
Um resultado maior que 0 confirma que a ação de mensagem foi executada com êxito. 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.
| code language-sql |
|---|
|
Exemplo de saída
| table 0-row-1 1-row-1 |
|---|
| MESSAGE_SENT_COUNT |
| 1 |
A consulta retorna a contagem de vezes que a mensagem foi invocada com êxito para o perfil selecionado.
Esta consulta recupera todas as ações de mensagem executadas com êxito para um perfil específico nos últimos 30 dias, agrupadas por nome de mensagem.
| code language-sql |
|---|
|
Exemplo de saída
| table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 | |
|---|---|
| MESSAGE_NAME | MESSAGE_COUNT |
| Email de boas-vindas | 1 |
| Recomendação do produto | 3 |
| Lembrete de abandono do carrinho | 2 |
| Informativo semanal | 4 |
A consulta retorna a lista de todas as mensagens juntamente com sua contagem invocada para o perfil selecionado.
Esta consulta retorna todas as jornadas inseridas por um perfil específico nos últimos 30 dias, juntamente com a contagem de entradas de cada jornada.
| code language-sql |
|---|
|
Exemplo de saída
| table 0-row-2 1-row-2 2-row-2 3-row-2 | |
|---|---|
| JORNADA_NAME | ENTRY_COUNT |
| Bem-vindo ao Jornada v2 | 1 |
| Recomendações de produto | 5 |
| Campanha de reengajamento | 2 |
A consulta retorna a lista de todos os nomes de jornada juntamente com o número de vezes que o perfil consultado inseriu cada jornada.
Este query fornece um detalhamento diário do número de perfis distintos que inseriram uma jornada em um período especificado.
| code language-sql |
|---|
|
Exemplo de saída
| table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 | |
|---|---|
| ENTRY_DATE | PROFILES_COUNT |
| 25/11/2024 | 1.245 |
| 24/11/2024 | 1.189 |
| 23/11/2024 | 15.340 |
| 22/11/2024 | 1.205 |
| 21/11/2024 | 1.167 |
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 um dia diferente.
Saiba como solucionar problemas de tipos de eventos descartados em jornada_step_events.
Consultas relacionadas ao público-alvo de leitura read-segment-queries
Esta consulta calcula a duração de um trabalho de exportação de público-alvo localizando a diferença de tempo entre o momento em que o trabalho foi enfileirado e o momento em que foi concluído.
| 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.
Esta consulta conta o número de perfis distintos que foram descartados devido a erros de duplicação de instância durante a atividade Ler público.
| code language-sql |
|---|
|
A consulta retorna todas as IDs de perfil que foram descartadas pela jornada porque estavam duplicadas.
Esta consulta retorna a contagem de perfis que foram descartados porque tinham um namespace inválido ou uma identidade ausente para o namespace necessário.
| 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.
Essa consulta conta os perfis que foram descartados porque um mapa de identidade necessário para a execução da jornada estava ausente.
| code language-sql |
|---|
|
A consulta retorna todas as IDs de perfil que foram descartadas pela jornada porque o mapa de identidade estava ausente.
Esta consulta identifica perfis que foram descartados quando a jornada estava sendo executada no modo de teste, mas o perfil não tinha o atributo testProfile definido como verdadeiro.
| 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.
Esta consulta retorna a contagem de perfis que foram descartados devido a erros internos do sistema durante a execução da jornada.
| code language-sql |
|---|
|
A consulta retorna todas as IDs de perfil que foram descartadas pela jornada devido a um erro interno.
Esta consulta fornece uma visão geral abrangente da atividade Ler público, incluindo detalhes do trabalho de exportação de segmento, códigos de evento, status e contagens de perfil para todos os estágios do processo de exportação de público-alvo.
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 upstream: problema na implantação do jornada, evento comercial ou problema com o scheduler.
Essa consulta filtra códigos de evento de erro específicos relacionados a falhas de Leitura de público, como erros de criação de tópico, erros de chamada de API, tempos limite e trabalhos de exportação com falha.
Consulta do Data Lake
| code language-sql |
|---|
|
Essa consulta recupera o status de processamento de trabalhos de exportação de público-alvo, mostrando se eles tiveram êxito ou falharam junto com as métricas de exportação de perfil.
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
Esta consulta combina contagens de perfis descartados com métricas de trabalho de exportação para fornecer uma exibição completa do desempenho da exportação de público-alvo para cada trabalho de exportação individual.
Consulta do Data Lake
| code language-sql |
|---|
|
Essa consulta agrega métricas gerais em todos os trabalhos de exportação para uma determinada versão do jornada, útil para jornadas recorrentes ou jornadas acionadas por eventos comerciais com reutilização de tópico.
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
Esta consulta identifica perfis que foram descartados porque o status de realização do público-alvo não correspondia à configuração de Qualificação de público-alvo da jornada (por exemplo, configurado para "entra", mas o perfil "sai").
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.
Esta consulta recupera todas as qualificações de público-alvo ou eventos externos que foram descartados para um perfil específico devido a erros de serviço interno.
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
Essa consulta conta o número de vezes que um evento comercial foi recebido por uma jornada, agrupado por data, em um intervalo de tempo especificado.
| code language-sql |
|---|
|
Esta consulta identifica quando um evento externo para um perfil específico foi descartado porque não havia nenhuma jornada ativa ou correspondente configurada para receber esse evento.
| code language-sql |
|---|
|
Saiba como solucionar problemas de tipos de eventos descartados em jornada_step_events.
Esta consulta recupera eventos externos que foram descartados para um perfil específico devido a erros internos de serviço, juntamente com a ID do evento e o código de erro.
| code language-sql |
|---|
|
Saiba como solucionar problemas de tipos de eventos descartados em jornada_step_events.
Essa consulta agrega todos os eventos descartados pela máquina de estado de jornada, agrupados por código de erro para ajudar a identificar os motivos mais comuns para descartes.
| code language-sql |
|---|
|
Saiba como solucionar problemas de tipos de eventos descartados em jornada_step_events.
Esta consulta identifica todos os eventos que foram descartados porque um perfil tentou inserir uma jornada novamente quando a reentrada não era permitida na configuração da jornada.
| code language-sql |
|---|
|
Saiba como solucionar problemas de tipos de eventos descartados em jornada_step_events.
Consultas para perfis ativáveis engageable-profiles-queries
Essas consultas ajudam a monitorar e analisar a contagem de perfis ativáveis. Um perfil que pode ser ativado é um perfil exclusivo que passou por jornadas ou campanhas nos últimos 12 meses. Saiba mais sobre Perfis ativáveis e uso de licença.
- Verifique se cada campo não agregado está incluído na cláusula
GROUP BY - Evite referenciar conjuntos de dados que não existem em sua sandbox - confirme os nomes dos conjuntos de dados na interface do usuário da plataforma
- Use
distinctao contar perfis exclusivos para evitar duplicatas em namespaces de identidade - Ao usar
LIMIT, coloque-o no final da consulta após as cláusulasORDER BY
Essa consulta retorna o número de perfis distintos que foram envolvidos por uma jornada específica, o que contribui para a contagem de Perfis ativáveis.
| code language-sql |
|---|
|
Esta consulta ajuda você a entender quantos perfis únicos uma jornada específica contribuiu para sua contagem de Perfis envolventes nos últimos 12 meses.
Esta consulta mostra o número de perfis exclusivos envolvidos por cada jornada em sua organização nos últimos 12 meses, ajudando você a identificar quais jornadas estão contribuindo mais para sua contagem de Perfis que podem ser engajados.
| code language-sql |
|---|
|
Exemplo de saída
| table 0-row-3 1-row-3 2-row-3 3-row-3 | ||
|---|---|---|
| JORNADA_VERSION_ID | JORNADA_NAME | ENGAGED_PROFILES |
| 67b14482-143e-4f83-9cf5-cfec0fca3d26 | Campanha de Boas-vindas v2 | 125.450 |
| a3c21b89-456d-4e21-b8f3-9a8e7c6d5432 | Jornada de lançamento de produto | 98.230 |
| f9e8d7c6-b5a4-3210-9876-543210fedcba | Fluxo de reengajamento | 45.670 |
Essa saída ajuda a identificar quais jornadas estão envolvendo mais perfis e contribuindo mais significativamente para a sua contagem de Perfis ativáveis.
| note note |
|---|
| NOTE |
Esta consulta é agrupada por journeyVersionID e journeyVersionName. Ambos os campos devem ser incluídos na cláusula GROUP BY, pois estão selecionados na consulta. A omissão de campos da cláusula GROUP BY fará com que a consulta falhe. |
Esta consulta fornece um detalhamento diário de perfis recém-envolvidos, ajudando você a identificar picos na contagem de Perfis envolventes.
| code language-sql |
|---|
|
Exemplo de saída
| table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 | |
|---|---|
| ENGAGEMENT_DATE | ENGAGED_PROFILES |
| 25/11/2024 | 8.450 |
| 24/11/2024 | 7.820 |
| 23/11/2024 | 125.340 |
| 22/11/2024 | 9.230 |
| 21/11/2024 | 8.670 |
Esse resultado ajuda a monitorar as tendências diárias e identificar quando um grande número de perfis está sendo envolvido. Neste exemplo, 23 de novembro mostra um pico significativo (125.340 perfis) em comparação ao engajamento diário típico (cerca de 8.000 perfis), o que justificaria uma investigação para entender qual jornada ou campanha causou o aumento em sua contagem de Perfis envolventes.
Esta consulta ajuda a identificar quais jornadas engajaram grandes números de novos perfis em períodos recentes, o que pode explicar aumentos súbitos na contagem de Perfis engajáveis.
| code language-sql |
|---|
|
Exemplo de saída
| table 0-row-4 1-row-4 2-row-4 3-row-4 | |||
|---|---|---|---|
| JORNADA_VERSION_ID | JORNADA_NAME | ENGAGEMENT_DATE | ENGAGED_PROFILES |
| 67b14482-143e-4f83-9cf5-cfec0fca3d26 | Campanha na Black Friday | 23/11/2024 | 125.340 |
| a3c21b89-456d-4e21-b8f3-9a8e7c6d5432 | Jornada de lançamento de produto | 22/11/2024 | 45.230 |
| f9e8d7c6-b5a4-3210-9876-543210fedcba | Newsletter de feriado | 21/11/2024 | 32.150 |
Esta consulta filtra jornadas que envolveram mais de 1.000 perfis por dia nos últimos 7 dias. A saída mostra quais jornadas e datas específicas são responsáveis por grandes envolvimentos de perfil. Ajuste o limite da cláusula HAVING de acordo com as suas necessidades (por exemplo, altere > 1000 para > 10000 para limites maiores).
Esta consulta fornece uma contagem de perfis únicos envolvidos em todas as jornadas nos últimos 12 meses, fornecendo uma visão geral de seu envolvimento baseado em jornada.
| code language-sql |
|---|
|
Exemplo de saída
| table 0-row-1 1-row-1 |
|---|
| TOTAL_ENGAGED_PROFILES |
| 2.547.890 |
Esse único número representa a contagem total de perfis únicos que foram engajados por pelo menos uma jornada nos últimos 12 meses.
| note note |
|---|
| NOTE |
| Essa consulta conta IDs de perfil distintas no conjunto de dados de eventos de etapa de jornada. A contagem real de Perfis Ativáveis mostrada no Painel de Uso de Licenças pode ser um pouco diferente, pois também inclui perfis envolvidos por meio de campanhas e outros recursos do Journey Optimizer além do jornada. |
Consultas comuns baseadas em jornada journey-based-queries
Essa consulta retorna uma contagem diária de versões exclusivas do jornada que tinham atividade, ajudando você a entender os padrões de execução da jornada ao longo do tempo.
| code language-sql |
|---|
|
Exemplo de saída
| table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 | |
|---|---|
| ACTIVITY_DATE | ATIVE_JORNADA |
| 25/11/2024 | 12 |
| 24/11/2024 | 15 |
| 23/11/2024 | 14 |
| 22/11/2024 | 11 |
| 21/11/2024 | 13 |
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
Essa consulta usa Expressões de tabela comuns (CTEs) para identificar os perfis que estão aguardando atualmente em um nó específico de uma jornada, localizando os perfis que passaram pelo nó, mas ainda não avançaram para os próximos nós.
Consulta do Data Lake
| code language-sql |
|---|
|
Exemplo
| code language-sql |
|---|
|
Esta consulta conta as instâncias do jornada que saíram durante um período de tempo especificado, incluindo saídas devido a erros de conclusão, erros, tempos limite ou erros de limite.
Consulta do Data Lake
| code language-sql |
|---|
|
Exemplo
| code language-sql |
|---|
|
Esta consulta fornece um detalhamento das saídas do jornada, mostrando o nome do nó e o status de saída de cada instância encerrada para ajudar a identificar onde e por que os perfis saíram da jornada.
Consulta do Data Lake
| code language-sql |
|---|
|
Exemplo
| code language-sql |
|---|
|
Consultas relacionadas às métricas de desempenho de Ação personalizada query-custom-action
Esta consulta fornece métricas de desempenho para ações HTTP personalizadas, incluindo total de chamadas, chamadas bem-sucedidas, contagens de erros por tipo (4xx, 5xx, tempos limite, limitados) e taxa de transferência em solicitações por segundo para cada endpoint.
Consulta do Data Lake
| code language-sql |
|---|
|
Exemplo
| code language-sql |
|---|
|
Esta consulta fornece as mesmas métricas de desempenho da consulta anterior, mas organizadas como uma série de tempo, mostrando como o desempenho do endpoint varia ao longo do tempo com granularidade minuto a minuto.
Consulta do Data Lake
| code language-sql |
|---|
|
Exemplo
| code language-sql |
|---|
|
Esta consulta calcula os percentis de tempo de resposta para endpoints de ação personalizados, ajudando você a entender a distribuição de latência e identificar outliers de desempenho em diferentes limites de percentil.
Consulta do Data Lake
| code language-sql |
|---|
|
Exemplo
| code language-sql |
|---|
|
Essa consulta fornece percentis de latência organizados como uma série de tempo, permitindo rastrear como os tempos de resposta do endpoint mudam ao longo do tempo em diferentes níveis de percentil.
Consulta do Data Lake
| code language-sql |
|---|
|
Exemplo
| code language-sql |
|---|
|
Esta consulta analisa os tempos de espera da fila para endpoints com limitação, mostrando os percentis de espera 50 e 95 para ajudar você a entender o impacto da limitação em suas ações personalizadas.
Consulta do Data Lake
| code language-sql |
|---|
|
Exemplo
| code language-sql |
|---|
|
Essa consulta fornece percentis de tempo de espera de fila como uma série de tempo, permitindo monitorar como a limitação afeta os tempos de espera ao longo do tempo para cada endpoint.
Consulta do Data Lake
| code language-sql |
|---|
|
Exemplo
| code language-sql |
|---|
|
Esta consulta fornece um detalhamento dos erros de um endpoint específico, agrupados por tipo de erro e código de erro, incluindo informações sobre tentativas de repetição.
Consulta do Data Lake
| code language-sql |
|---|
|
Exemplo
| code language-sql |
|---|
|