Riferimento codici di errore error-codes
Adobe Journey Optimizer utilizza codici di errore standardizzati per aiutarti a identificare e risolvere rapidamente i problemi tra percorsi, campagne e configurazioni di messaggi. Comprendere questi codici di errore può ridurre in modo significativo i tempi di risoluzione dei problemi e aiutarti a mantenere prestazioni ottimali della campagna.
Informazioni sulla struttura del codice di errore error-code-structure
I codici di errore di Adobe Journey Optimizer seguono un pattern di denominazione coerente che consente di identificare il componente e il tipo di problema:
- Prefisso servizio: indica quale servizio Adobe Journey Optimizer ha generato l'errore (ad esempio, CJMPTS per il servizio push/trasporto, CJMRT per il runtime di Percorso, CJMMAS per il servizio di authoring dei messaggi)
- Numero errore: identificatore univoco per la condizione di errore specifica
- Codice stato HTTP: codice stato HTTP standard (ad esempio 400, 403, 422, 500)
Esempio: CJMRT-030012-422 indica un errore di runtime del Percorso (CJMRT) con il numero di errore 030012 e lo stato HTTP 422 (entità non elaborabile).
Dove trovare i codici di errore find-error-codes
I codici di errore vengono visualizzati in diverse posizioni all’interno di Adobe Journey Optimizer:
- Rapporti e registri di esecuzione del percorso
- Schermate di attivazione della campagna
- Avvisi di convalida dei messaggi
- Notifiche e avvisi di sistema
- Risposte API (quando si utilizzano API REST)
Quando si verifica un errore, annota il codice di errore completo e l’eventuale ID richiesta associato, in quanto sono essenziali per la risoluzione dei problemi e per supportare l’escalation.
Codici di errore comuni per servizio error-codes-by-service
CJMPTS: errori del servizio push e trasporto cjmpts-errors
Questi errori si verificano durante le operazioni di consegna e trasporto delle notifiche push.
Codice di errore
Descrizione
Causa principale
Risoluzione
CJMPTS-1510-500
Errore interno del server nell’invio del canale push
Malfunzionamento del trasporto/push back-end; errore del provider o dell’infrastruttura
1. Controllare le impostazioni di provisioning dei canali
2. Verificare che le credenziali push siano valide
3. Ripetere l'operazione
4. Se persiste, contatta il supporto Adobe con ID richiesta
Documentazione correlata: Configurazione push
2. Verificare che le credenziali push siano valide
3. Ripetere l'operazione
4. Se persiste, contatta il supporto Adobe con ID richiesta
Documentazione correlata: Configurazione push
CJMPTS-1023-500
Errore interno del server durante l’invio/elaborazione push (gateway di terze parti)
Errore temporaneo di malfunzionamento del cloud o errore sconosciuto del servizio
1. Verificare la configurazione del provider/canale
2. Verificare lo stato del gateway di terze parti
3. Riprova tra qualche minuto
4. Controlla i registri per il contesto aggiuntivo
Documentazione correlata: Notifiche push
2. Verificare lo stato del gateway di terze parti
3. Riprova tra qualche minuto
4. Controlla i registri per il contesto aggiuntivo
Documentazione correlata: Notifiche push
CJMPTS-1310-500
Errore interno del servizio di rendering (anteprima o invio live)
Rendering del modello a valle non riuscito, in genere a causa di problemi di sintassi JSON/modello
1. Convalidare la sintassi e la struttura del modello
2. Verifica che tutte le variabili di personalizzazione siano valide
3. Utilizza un payload di test per identificare il problema
4. Semplifica la complessità del modello se necessario
Documentazione correlata: Modelli di messaggio, Sintassi Personalization
2. Verifica che tutte le variabili di personalizzazione siano valide
3. Utilizza un payload di test per identificare il problema
4. Semplifica la complessità del modello se necessario
Documentazione correlata: Modelli di messaggio, Sintassi Personalization
CJMRT: errori di runtime di Percorso e API cjmrt-errors
Questi errori si verificano durante l’esecuzione del percorso, l’elaborazione degli eventi e le operazioni API.
Codice di errore
Descrizione
Causa principale
Risoluzione
CJMRT-030012-422
Entità non elaborabile: azione non riuscita, evento non valido o payload non valido
Dati di input non validi (ad esempio pubblico, evento o attributo inesistenti)
1. Controllare nuovamente la struttura del payload di input/evento
2. Verificare che gli oggetti a cui si fa riferimento (tipi di pubblico, set di dati) esistano e siano attivi
3. Convalida che tutti i campi obbligatori sono presenti
4. Test con payload valido noto
Documentazione correlata: Risoluzione dei problemi di Percorso, Configurazione eventi
2. Verificare che gli oggetti a cui si fa riferimento (tipi di pubblico, set di dati) esistano e siano attivi
3. Convalida che tutti i campi obbligatori sono presenti
4. Test con payload valido noto
Documentazione correlata: Risoluzione dei problemi di Percorso, Configurazione eventi
CJMRT-130004-400
Richiesta non valida: input non valido nel nodo di percorso o nella configurazione del canale
riferimenti di configurazione o payload di percorso rimossi/risorsa non valida
1. Rivedere la configurazione del nodo di percorso
2. Verifica che siano presenti tutte le risorse a cui si fa riferimento (messaggi, tipi di pubblico, azioni)
3. Correggi o aggiorna i riferimenti interrotti
4. Ricompila la configurazione del percorso se necessario
Documentazione correlata: Creazione del Percorso, Azioni personalizzate
2. Verifica che siano presenti tutte le risorse a cui si fa riferimento (messaggi, tipi di pubblico, azioni)
3. Correggi o aggiorna i riferimenti interrotti
4. Ricompila la configurazione del percorso se necessario
Documentazione correlata: Creazione del Percorso, Azioni personalizzate
CJMRT-000032-409
Conflitto - la risorsa esiste già
Tentativo di creare una risorsa con ID o nome duplicato
1. Usa ID e nomi univoci per tutte le risorse
2. Verificare la presenza di risorse esistenti con lo stesso identificatore
3. Eliminare o rinominare gli oggetti in conflitto
4. Rivedi convenzioni di denominazione
Documentazione correlata: Versioni Percorso
2. Verificare la presenza di risorse esistenti con lo stesso identificatore
3. Eliminare o rinominare gli oggetti in conflitto
4. Rivedi convenzioni di denominazione
Documentazione correlata: Versioni Percorso
CJMRT-170016-400
Richiesta non valida durante la configurazione/anteprima del percorso
Nel payload manca il collegamento della dipendenza richiesta o del modello interrotto
1. Convalida che tutte le risorse richieste sono attive
2. Assicurati che i modelli e i blocchi di contenuto siano pubblicati
3. Verificare che tutte le dipendenze siano collegate correttamente
4. Rivedi risultati modalità test percorso
Documentazione correlata: percorsi di test, dipendenze Percorso
2. Assicurati che i modelli e i blocchi di contenuto siano pubblicati
3. Verificare che tutte le dipendenze siano collegate correttamente
4. Rivedi risultati modalità test percorso
Documentazione correlata: percorsi di test, dipendenze Percorso
CJMRT-080608-400
Richiesta non valida in dominio/canale/delega
Record DNS richiesti o configurazione e-mail/SMS mancante
1. Completare la configurazione DNS per i domini e-mail
2. Verifica delega sottodominio completata
3. Eseguire di nuovo le procedure guidate di configurazione
4. Consenti propagazione DNS (fino a 72 ore)
Documentazione correlata: Superfici di canale, Delega sottodominio
2. Verifica delega sottodominio completata
3. Eseguire di nuovo le procedure guidate di configurazione
4. Consenti propagazione DNS (fino a 72 ore)
Documentazione correlata: Superfici di canale, Delega sottodominio
CJMRT-110100-500
Errore interno nel payload
Errore di configurazione/dati back-end o configurazione non supportata
1. Riprovare l'operazione
2. Semplifica la configurazione se utilizzi funzionalità avanzate
3. Inoltra al supporto Adobe con ID richiesta e payload esatto
4. Verifica la presenza di problemi noti nelle note sulla versione
Documentazione correlata: Risoluzione dei problemi di Percorso
2. Semplifica la configurazione se utilizzi funzionalità avanzate
3. Inoltra al supporto Adobe con ID richiesta e payload esatto
4. Verifica la presenza di problemi noti nelle note sulla versione
Documentazione correlata: Risoluzione dei problemi di Percorso
CJMMAS: errori del servizio di authoring dei messaggi cjmmas-errors
Questi errori si verificano durante la creazione, la modifica o la pubblicazione di messaggi, predefiniti e contenuti.
Codice di errore
Descrizione
Causa principale
Risoluzione
CJMMAS-1149-400
Richiesta non valida durante il salvataggio di un messaggio, un predefinito o una variante
Campi obbligatori mancanti nel messaggio o configurazione non valida
1. Completare tutti i campi obbligatori (contrassegnati da asterisco)
2. Convalida la configurazione del messaggio/predefinito
3. Verifica i formati e i vincoli dei valori dei campi
4. Rivedi i messaggi di convalida nell'interfaccia utente
Documentazione correlata: Canale e-mail, Superfici di canale
2. Convalida la configurazione del messaggio/predefinito
3. Verifica i formati e i vincoli dei valori dei campi
4. Rivedi i messaggi di convalida nell'interfaccia utente
Documentazione correlata: Canale e-mail, Superfici di canale
CJMMAS-2073-422
Entità non elaborabile nella modifica del predefinito per messaggi
Errore di convalida, campo non supportato o sintassi non corretta
1. Correggere gli errori di sintassi/campo come indicato
2. Confronta con una configurazione valida
3. Usa la convalida dell'interfaccia utente dei messaggi prima di salvare
4. Controlla i requisiti dei campi nella documentazione
Documentazione correlata: Predefiniti per messaggi, Impostazioni e-mail
2. Confronta con una configurazione valida
3. Usa la convalida dell'interfaccia utente dei messaggi prima di salvare
4. Controlla i requisiti dei campi nella documentazione
Documentazione correlata: Predefiniti per messaggi, Impostazioni e-mail
CJMMAS-1300-500
Errore interno nell’authoring dei messaggi
Arresto del back-end dovuto a problemi di infrastruttura, contenuti di grandi dimensioni o tempi di inattività del servizio
1. Semplificare modello/contenuto (ridurre dimensioni/complessità)
2. Ripetere l'operazione
3. Salvare il lavoro in modo incrementale
4. Se persiste, passa al supporto Adobe
Documentazione correlata: Modelli di contenuto
2. Ripetere l'operazione
3. Salvare il lavoro in modo incrementale
4. Se persiste, passa al supporto Adobe
Documentazione correlata: Modelli di contenuto
CJMMAS-2001-200
Stato di successo ma banner di errore: collegamento di rinuncia mancante
Collegamento per l’annullamento dell’iscrizione richiesto mancante nella variante e-mail
1. Aggiungi il collegamento di rinuncia/annullamento iscrizione a tutte le varianti di e-mail
2. Verifica che il collegamento sia presente in tutte le versioni linguistiche
3. Utilizza l'helper di personalizzazione per inserire il collegamento di rinuncia
4. Verifica tutte le varianti prima di pubblicare
Documentazione correlata: Gestione rinuncia, Progettazione e-mail
2. Verifica che il collegamento sia presente in tutte le versioni linguistiche
3. Utilizza l'helper di personalizzazione per inserire il collegamento di rinuncia
4. Verifica tutte le varianti prima di pubblicare
Documentazione correlata: Gestione rinuncia, Progettazione e-mail
CJMMAS-1603-403
Non consentito durante l’aggiornamento/pubblicazione di un modello o di un predefinito
L’utente non dispone delle autorizzazioni/del ruolo richiesti o l’azione non è consentita nello stato corrente
1. Verifica che l’utente disponga delle autorizzazioni appropriate (Message Manager, Author, ecc.)
2. Verifica lo stato del predefinito/modello (bozza, pubblicato, archiviato)
3. Richiedi l'accesso all'amministratore se necessario
4. Rivedi assegnazioni profilo prodotto
Documentazione correlata: Autorizzazioni, Controllo dell'accesso
2. Verifica lo stato del predefinito/modello (bozza, pubblicato, archiviato)
3. Richiedi l'accesso all'amministratore se necessario
4. Rivedi assegnazioni profilo prodotto
Documentazione correlata: Autorizzazioni, Controllo dell'accesso
CJMCMP: errori della campagna cjmcmp-errors
Questi errori si verificano durante la creazione, la configurazione e l’attivazione della campagna.
Codice di errore
Descrizione
Causa principale
Risoluzione
CJMCMP-2050-400
Richiesta non valida nell’attivazione o nell’approvazione della campagna
La campagna fa riferimento a un criterio o a un segmento non valido/mancante
1. Controlla tutte le configurazioni dei nodi della campagna
2. Verificare che i collegamenti ai criteri o ai segmenti siano correnti e validi
3. Aggiornamento con configurazione corretta
4. Verifica di nuovo la campagna prima dell'attivazione
Documentazione correlata: Creazione campagna, Approvazione campagna
2. Verificare che i collegamenti ai criteri o ai segmenti siano correnti e validi
3. Aggiornamento con configurazione corretta
4. Verifica di nuovo la campagna prima dell'attivazione
Documentazione correlata: Creazione campagna, Approvazione campagna
Approccio generale per la risoluzione dei problemi troubleshooting-approach
Quando incontri un codice di errore, segui questo approccio sistematico:
-
Identificare l'errore: annotare il codice di errore completo, lo stato HTTP ed eventuali messaggi o ID di richiesta associati.
-
Trovare il servizio: utilizzare il prefisso del servizio (CJMPTS, CJMRT, CJMMAS, CJMCMP) per identificare il componente interessato.
-
Verifica il codice di stato:
- 400 (richiesta non valida): verifica dati e configurazione di input
- 403 (non consentito): verifica autorizzazioni e diritti di accesso
- 409 (conflitto): cercare risorse duplicate o in conflitto
- 422 (entità non elaborabile): convalida dei dati in base ai requisiti dello schema
- 500 (errore interno del server): riprova ed esegui potenzialmente l'inoltro al supporto
-
Rivedi modifiche recenti: considera le modifiche recenti (aggiornamenti di percorso, nuove campagne, modifiche alla configurazione, ecc.).
-
Consulta la documentazione: utilizza i collegamenti forniti in questa guida per accedere alla documentazione dettagliata della funzione interessata.
-
Riprova quando appropriato: per gli errori della serie 500, un semplice nuovo tentativo dopo pochi minuti spesso risolve problemi transitori.
-
Inoltra a nuovo quando necessario: se l'errore persiste dopo i seguenti passaggi di risoluzione, contatta il supporto Adobe con:
- Codice di errore completo
- ID richiesta (se disponibile)
- Passaggi da riprodurre
- Dettagli di configurazione rilevanti
Best practice per evitare errori comuni best-practices
Prima dell'attivazione del percorso journey-best-practices
- Convalida tutte le risorse: verifica che tutti i tipi di pubblico, gli eventi, le origini dati e le azioni personalizzate a cui si fa riferimento siano configurati correttamente
- Verifica approfondita: utilizza la modalità di test per identificare i problemi prima di pubblicare (Ulteriori informazioni)
- Convalida volumi: utilizza l'esecuzione in prova per convalidare la portata del pubblico e la logica di diramazione prima della pubblicazione (Ulteriori informazioni)
- Verifica autorizzazioni: verifica di disporre dei diritti di accesso necessari per tutti i componenti
- Verifica dipendenze: verifica che tutti i messaggi e il contenuto collegati siano pubblicati
Durante la creazione dei messaggi message-best-practices
- Compilare i campi obbligatori: compilare sempre tutti i campi obbligatori prima di salvare
- Includi collegamenti di rinuncia: aggiungi collegamenti di annullamento iscrizione a tutte le varianti di e-mail (Ulteriori informazioni)
- Convalida personalizzazione: verifica tutti i contenuti dinamici con profili di esempio (Ulteriori informazioni)
- Mantieni i modelli gestibili: evita modelli eccessivamente complessi che potrebbero causare problemi di rendering
Per la gestione delle campagne campaign-best-practices
- Verifica dati pubblico: assicurati che i tipi di pubblico di destinazione siano configurati e popolati correttamente
- Verifica stato approvazione: comprendi i requisiti di approvazione prima di tentare l'attivazione (Ulteriori informazioni)
- Configurazioni monitor: verifica regolarmente la validità delle superfici di canale e dei predefiniti
- Pianificare le modifiche DNS: attendi tempo sufficiente per la propagazione DNS durante l'aggiornamento dei domini
Risorse aggiuntive additional-resources
Ottenere supporto getting-support
Se si verificano errori persistenti che non possono essere risolti utilizzando questa guida:
- Raccogli informazioni: raccogli il codice di errore, l'ID richiesta, i timestamp e i passaggi da riprodurre
- Verifica lo stato del sistema: visita Stato Adobe per problemi noti del servizio
- Documentazione di ricerca: consulta Adobe Experience League per informazioni sulle soluzioni
- Coinvolgi community: pubblica domande nella community Adobe Journey Optimizer
- Contatta il supporto Adobe: invia un ticket di supporto con tutti i dettagli pertinenti
NOTE
Questo riferimento al codice di errore viene continuamente aggiornato man mano che vengono identificati e documentati nuovi codici. Per informazioni aggiornate, controlla regolarmente i blog della community Adobe Journey Optimizer.
Argomenti correlati
recommendation-more-help
b22c9c5d-9208-48f4-b874-1cefb8df4d76