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

Categoria
Nome do campo
Rótulo
Descrição
Versão do Jornada
journeyUID
Identificador de Jornada
journeyVersionUID
Identificador de versão do Jornada
journeyVersionName
Nome da versão do Jornada
journeyVersionDescription
Descrição da versão do Jornada
journeyVersion
Versão do Jornada
Jornada instância
instanceUID
Identificador de instância do Jornada
ID da instância
externalKey
Chave externa
Identificador individual que aciona a jornada
organizationId
Identificador da organização
Organização da marca
sandboxName
Nome da sandbox
Nome da sandbox
Identidade
profileId
Identificador de identidade do perfil
Identificador do perfil na jornada
namespace
Namespace de identidade do perfil
Namespace do perfil na jornada (exemplo: ECID)
Nó Atual
currentNodeId
Identificador do nó atual
Identificador da atividade atual (nó)
currentNodeName
Nome do nó atual
Nome da atividade atual (nó)
Nó anterior
previousNodeId
Identificador do nó anterior
Identificador da atividade anterior (nó)
previousNodeName
Nome do nó anterior
Nome da atividade anterior (nó)
Erros
lastNodeUIDInError
Último identificador de nó com erro
Identificador da atividade mais recente (nó) com erro
lastNodeNameInError
Nome do último nó com erro
Nome da atividade mais recente (nó) com erro
lastNodeTypeInError
Último tipo de nó com erro

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
lastErrorCode
Último código de erro

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)
lastExecutionActionErrorCode
Código de erro da última ação executada
Código de erro da ação mais recente com erro
lastDataFetchErrorCode
Código de erro da última busca de dados
Código de erro da última busca de dados nas fontes de dados
Hora
lastActionExecutionElapsedTime
Tempo decorrido da execução da última ação
Tempo gasto para executar a ação mais recente
lastDataFetchElapsedTime
Tempo decorrido da última busca de dados
Tempo gasto para executar a última busca de dados a partir de fontes de dados
Referência de conhecimento de IA

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 lastNodeTypeInError e lastErrorCode
  • 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, timedOut e error (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 lastErrorCode usa valores predefinidos: códigos de erro HTTP, capped, timedOut e error
  • 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 journeyUID e instanceUID?journeyUID identifica a definição de jornada; instanceUID identifica 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 lastNodeNameInError e lastErrorCode em uma ação personalizada para incluir detalhes do erro em uma notificação do Slack.
recommendation-more-help
journey-optimizer-help