Jornada atributos de propriedades journey-properties
No editor de expressão simples e no editor de expressão avançado, abaixo das categorias Evento e Fonte de dados, você pode acessar a categoria Propriedades de Jornada. Essa categoria contém campos técnicos relacionados à jornada para um determinado perfil. Essas são as informações recuperadas pelo sistema a partir das jornadas ativas, como a ID da jornada ou os erros específicos encontrados.
Ela contém informações, por exemplo, sobre:
-
Versão do jornada: uid do jornada, uid da versão do jornada, uid da instância etc.
-
erros: busca de dados, execução de ação etc.
-
etapa atual, última etapa atual etc.
-
perfis descartados
A lista de campos está disponível nesta seção.
Você pode usar esses campos para criar expressões. Durante a execução da jornada, os valores são recuperados diretamente da jornada.
Abaixo estão alguns exemplos de casos de uso:
-
Registrar em log perfis descartados: é possível enviar todos os perfis excluídos de uma mensagem por uma regra de limitação para um sistema de terceiros para fins de registro em log. Para isso, configure um caminho em caso de tempo limite e erro e adicione uma condição para filtrar por um tipo de erro específico, por exemplo: “descartar pessoas ao limitar a regra”. Em seguida, você pode enviar os perfis descartados para um sistema de terceiros por meio de uma ação personalizada.
-
Enviar alertas em caso de erros: você pode enviar uma notificação para um sistema de terceiros sempre que ocorrer um erro em uma mensagem. Para isso, configure um caminho em caso de erro, adicione uma condição e uma ação personalizada. É possível enviar uma notificação em um canal do Slack, por exemplo, com a descrição do erro encontrado.
-
Refinar erros nos relatórios: em vez de ter apenas um caminho para mensagens com erro, você pode definir uma condição por tipo de erro. Isso permitirá que você refine os relatórios e visualize todos os dados de tipos de erro.
Lista de campos journey-properties-fields
Tipo de erro da atividade mais recente (nó) com erro. Tipos possíveis:
- Eventos: Eventos, Reações, SQ (exemplo: Qualificação de público-alvo)
- Controle de fluxo: Fim, Condição, Espera
- Ações: ACS actions, Jump, Custom Action
Código de erro da atividade mais recente (nó) com erro. Possíveis erros:
- Códigos de erro HTTP
- limitado
- timedOut
- erro (exemplo: padrão no caso de um erro inesperado. Não deve/extremamente raramente acontece)
Esta seção contém conhecimento estruturado destinado a oferecer suporte à interpretação, recuperação e resposta a perguntas relacionadas a este tópico.
Para uma compreensão completa, essas informações devem ser combinadas com a documentação desta página. Nenhuma das origens deve ser independente; a página descreve o recurso, enquanto esta seção fornece um contexto adicional que ajuda a desfazer a ambiguidade da terminologia, intenção, aplicabilidade e restrições.
- TL;DR: Esta página descreve a categoria Propriedades da Jornada no editor de expressão — um conjunto de campos técnicos sobre a instância de jornada ativa (IDs, erros, nós atuais/anteriores, tempos decorridos) que podem ser usados para criar expressões para registro, alerta e relatórios específicos de erros.
Intenções:
- Acesse os campos Propriedades da Jornada no editor de expressão simples ou avançado para fazer referência aos metadados de jornada em tempo real
- Crie uma condição que filtre perfis descartados por tipo de erro para direcioná-los para um sistema de log de terceiros
- Enviar alertas de erro a um canal externo (por exemplo, Slack) fazendo referência ao último código de erro e nome do nó em uma ação personalizada
- Refinar o relatório de erros de jornada criando caminhos de condição separados por tipo de erro usando
lastNodeTypeInErrorelastErrorCode - Identificadores de versão de jornada de referência, identificadores de instância e nome da sandbox em expressões para rastreamento e auditoria
Glossário:
- Propriedades da Jornada: uma categoria no editor de expressão contendo campos de metadados técnicos para a instância de execução de jornada atual (específico do produto)
- instanceUID: o identificador exclusivo da instância do jornada para uma determinada execução de perfil (específico do produto)
- lastErrorCode: o código de erro da atividade com falha mais recente na jornada; os valores possíveis incluem códigos HTTP,
capped,timedOuteerror(específico do produto) - lastNodeTypeInError: o tipo da última atividade que encontrou um erro; pode ser Eventos, Controle de fluxo ou Ações (específico do produto)
- externalKey: o identificador individual (por exemplo, ID de perfil) que acionou a instância do jornada (específico do produto)
Medidas de Proteção:
- Os valores do campo Propriedades da jornada são recuperados diretamente da jornada ativa no tempo de execução — eles não estão disponíveis para validação de pré-execução
- O campo
lastErrorCodeusa valores predefinidos: códigos de erro HTTP,capped,timedOuteerror - As Propriedades da Jornada estão disponíveis nos editores de expressão simples e avançado, na categoria Propriedades da Jornada
Terminologia:
- Nome canônico: Propriedades de Jornada — Acrônimo: none — variantes: campos técnicos de jornada, campos de metadados de jornada
- Sinônimos: “Propriedades do Jornada” = “Campos técnicos do jornada”; “instanceUID” = “Identificador de instância do jornada”
- Não confunda: journeyUID (identifica a definição da jornada) ≠ instanceUID (identifica a execução da jornada por um perfil específico)
Perguntas frequentes:
- P: Onde encontro os campos Propriedades da Jornada no editor de expressão? — Eles aparecem nos editores de expressão simples e avançado na categoria Propriedades da Jornada, abaixo de Eventos e Fontes de dados.
- P: Como posso registrar perfis descartados por uma regra de limitação? — Adicione uma filtragem de condição de caminho de erro em
lastErrorCode == "capped"e envie esses perfis para um sistema de terceiros por meio de uma ação personalizada. - P: Qual é a diferença entre
journeyUIDeinstanceUID? —journeyUIDidentifica a definição de jornada;instanceUIDidentifica uma instância de execução específica para um determinado perfil. - P: Que código de erro foi retornado para um erro de sistema inesperado? — O código
error, que é usado como padrão para erros inesperados e raramente deve ocorrer. - P: Posso usar os campos de Propriedades de Jornada para enviar alertas do Slack sobre falhas de ação? — Sim; referencie
lastNodeNameInErrorelastErrorCodeem uma ação personalizada para incluir detalhes do erro em uma notificação do Slack.