Referência de códigos de erro error-codes
O Adobe Journey Optimizer usa códigos de erro padronizados para ajudar você a identificar e resolver problemas rapidamente em jornadas, campanhas e configurações de mensagens. A compreensão desses códigos de erro pode reduzir bastante o tempo de solução de problemas e ajudar você a manter o desempenho ideal da campanha.
Noções básicas sobre a estrutura do código de erro error-code-structure
Os códigos de erro do Adobe Journey Optimizer seguem um padrão de nomenclatura consistente que ajuda a identificar o componente e o tipo de problema:
- Prefixo do serviço: indica qual serviço Adobe Journey Optimizer gerou o erro (por exemplo, CJMPTS para Serviço de Envio/Transporte, CJMRT para Tempo de Execução de Jornada, CJMAS para Serviço de Criação de Mensagens)
- Número do erro: identificador exclusivo para a condição de erro específica
- Código de status HTTP: código de status HTTP padrão (por exemplo, 400, 403, 422, 500)
Exemplo: CJMRT-030012-422 indica um erro de Tempo de Execução de Jornada (CJMRT) com o número de erro 030012 e o status HTTP 422 (Entidade Não Processável).
Onde encontrar códigos de erro find-error-codes
Os códigos de erro aparecem em vários locais no Adobe Journey Optimizer:
- Relatórios e logs de execução de Jornada
- Telas de ativação de campanha
- Avisos de validação de mensagem
- Notificações e alertas do sistema
- Respostas da API (ao usar APIs REST)
Quando ocorrer um erro, anote o código de erro completo e a ID da solicitação que o acompanha, pois eles são essenciais para a solução de problemas e o encaminhamento de suporte.
Códigos de erro comuns por serviço error-codes-by-service
CJMPTS: erros do serviço de push e transporte cjmpts-errors
Esses erros ocorrem durante as operações de entrega de notificação por push e transporte de mensagem.
2. Verifique se as credenciais de push são válidas
3. Repita a operação
4. Se for persistente, entre em contato com o Suporte da Adobe com a ID da solicitação
Documentação relacionada: Configuração de push
2. Verifique o status do gateway de terceiros
3. Tente novamente após alguns minutos
4. Examinar logs para contexto adicional
Documentação relacionada: Notificações por push
2. Verifique se todas as variáveis de personalização são válidas
3. Use uma carga de teste para identificar o problema
4. Simplifique a complexidade do modelo, se necessário
Documentação relacionada: Modelos de mensagem, Sintaxe do Personalization
CJMRT: erros de API e Tempo de execução de Jornada cjmrt-errors
Esses erros ocorrem durante a execução da jornada, o processamento de eventos e as operações da API.
2. Verifique se os objetos referenciados (públicos, conjuntos de dados) existem e estão ativos
3. Validar se todos os campos obrigatórios estão presentes
4. Teste com uma carga em boas condições
Documentação relacionada: Solução de problemas de Jornada, Configuração de eventos
2. Verifique se todos os recursos referenciados (mensagens, públicos, ações) existem
3. Corrigir ou atualizar referências corrompidas
4. Recrie a configuração da jornada, se necessário
Documentação relacionada: Criação de Jornadas, Ações personalizadas
2. Verificar recursos existentes com o mesmo identificador
3. Excluir ou renomear objetos conflitantes
4. Revisar convenções de nomenclatura
Documentação relacionada: versões de Jornada
2. Verifique se os modelos e blocos de conteúdo foram publicados
3. Verifique se todas as dependências estão vinculadas corretamente
4. Revise os resultados do modo de teste de jornada
Documentação relacionada: Testando jornadas, Dependências de Jornada
2. Verifique se a delegação de subdomínio foi concluída
3. Execute os assistentes de configuração novamente
4. Tempo de permissão para propagação DNS (até 72 horas)
Documentação relacionada: Superfícies de canal, Delegação de subdomínio
2. Simplifique a configuração se estiver usando recursos avançados
3. Escalonar para o Suporte da Adobe com ID de solicitação e carga exata
4. Verifique problemas conhecidos nas notas de versão
Documentação relacionada: Solução de problemas de Jornada
CJMAS: Erros do serviço de autoria de mensagens cjmmas-errors
Esses erros ocorrem ao criar, editar ou publicar mensagens, predefinições e conteúdo.
2. Validar configuração de mensagem/predefinição
3. Verificar formatos e restrições de valor de campo
4. Examine as mensagens de validação na interface
Documentação relacionada: Canal de email, Superfícies de canal
2. Compare com uma configuração em boas condições
3. Use a validação da interface de mensagem antes de salvar
4. Examine os requisitos de campo na documentação
Documentação relacionada: Predefinições de mensagem, Configurações de email
2. Repita a operação
3. Salve o trabalho incrementalmente
4. Se for persistente, encaminhe para o Suporte da Adobe
Documentação relacionada: Modelos de conteúdo
2. Verifique se o link está presente em cada versão de idioma
3. Use o auxiliar de personalização para inserir o link para opção de não participação
4. Teste todas as variantes antes de publicar
Documentação relacionada: Gerenciamento de recusa, Design de email
2. Verificar status de predefinição/modelo (rascunho, publicado, arquivado)
3. Solicite acesso ao administrador, se necessário
4. Revisar atribuições de perfil de produto
Documentação relacionada: Permissões, Controle de acesso
CJMCMP: Erros de campanha cjmcmp-errors
Esses erros ocorrem durante a criação, configuração e ativação da campanha.
2. Verifique se os links de política/segmento são atuais e válidos
3. Atualize com a configuração correta
4. Testar novamente a campanha antes da ativação
Documentação relacionada: Criação de campanha, Aprovação de campanha
Abordagem geral de solução de problemas troubleshooting-approach
Ao encontrar um código de erro, siga esta abordagem sistemática:
-
Identificar o erro: observe o código de erro completo, o status HTTP e qualquer mensagem ou ID de solicitação que o acompanhe.
-
Localizar o serviço: use o prefixo do serviço (CJMPTS, CJMRT, CJMMAS, CJMCMP) para identificar qual componente é afetado.
-
Verificar o código de status:
- 400 (Solicitação inválida): revisar dados e configuração de entrada
- 403 (Proibido): verificar permissões e direitos de acesso
- 409 (Conflito): procurar recursos duplicados ou conflitantes
- 422 (Entidade Não Processável): Validar dados em relação aos requisitos do esquema
- 500 (Erro Interno do Servidor): tentar novamente e escalonar para suporte
-
Revisar alterações recentes: considere o que foi modificado recentemente (atualizações de jornada, novas campanhas, alterações de configuração etc.).
-
Consultar documentação: use os links fornecidos neste guia para acessar a documentação detalhada do recurso afetado.
-
Repetir quando apropriado: para erros de 500 séries, uma simples tentativa após alguns minutos geralmente resolve problemas transitórios.
-
Escalonar quando necessário: se o erro persistir após as seguintes etapas de resolução, contate o Suporte da Adobe com:
- Código de erro completo
- ID da solicitação (se disponível)
- Etapas a serem reproduzidas
- Detalhes de configuração relevantes
Práticas recomendadas para evitar erros comuns best-practices
Antes da ativação do jornada journey-best-practices
- Validar todos os recursos: verifique se todos os públicos referenciados, eventos, fontes de dados e ações personalizadas estão configurados corretamente
- Testar completamente: use o modo de teste para identificar problemas antes de publicar (Saiba mais)
- Validar volumes: use simulação para validar o alcance do público e a lógica da ramificação antes de entrar em funcionamento (Saiba mais)
- Verificar permissões: verifique se você tem os direitos de acesso necessários para todos os componentes
- Revisar dependências: verifique se todas as mensagens e conteúdos vinculados foram publicados
Ao criar mensagens message-best-practices
- Preencha os campos obrigatórios: sempre preencha todos os campos obrigatórios antes de salvar
- Incluir links para opção de não participação: adicionar links para cancelar inscrição a todas as variantes de email (Saiba mais)
- Validar personalização: testar todo o conteúdo dinâmico com perfis de exemplo (Saiba mais)
- Manter modelos gerenciáveis: evite modelos excessivamente complexos que podem causar problemas de renderização
Para gerenciamento de campanhas campaign-best-practices
- Verificar dados de público-alvo: verifique se os públicos-alvo estão configurados e preenchidos corretamente
- Verificar status da aprovação: compreenda os requisitos de aprovação antes de tentar ativar (Saiba mais)
- Monitorar configurações: revise regularmente as superfícies e predefinições de canais em busca de validade
- Planejar alterações de DNS: permitir tempo suficiente para propagação de DNS ao atualizar domínios
Recursos adicionais additional-resources
Obter suporte getting-support
Se você encontrar erros persistentes que não podem ser resolvidos usando este guia:
- Coletar informações: coletar o código de erro, a ID da solicitação, os carimbos de data/hora e as etapas para reproduzir
- Verificar o status do sistema: Visite Status do Adobe para conhecer problemas de serviço
- Pesquisar documentação: consulte a Adobe Experience League para obter soluções
- Engajar a comunidade: postar perguntas na Comunidade do Adobe Journey Optimizer
- Contate o Suporte da Adobe: envie um tíquete de suporte com todos os detalhes relevantes
Tópicos relacionados