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 messaggi, CJMCMP per Campaign, CJMTL per il livello trasporto, CJMRPS per il servizio di reporting/provisioning)
- 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.
2. Verificare le configurazioni e le quote del provider
3. Verificare che le credenziali push siano valide
4. Test con un canale alternativo
5. Se persiste, contatta il supporto Adobe con ID richiesta
Documentazione correlata: Configurazione push
2. Verifica configurazione sandbox/organizzazione
3. Verificare che le configurazioni del canale siano attive
4. Ricrea la configurazione del canale, se necessario
Documentazione correlata: Superfici di canale
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 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. 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.
2. Controlla Stato Adobe per informazioni sulle interruzioni
3. Inoltra al supporto Adobe con dettagli su flusso di lavoro/processo/organizzazione
4. Fornisci registri e acquisizioni di rete se disponibili
Documentazione correlata: Risoluzione dei problemi di Percorso
2. Riferimento/parametro corretto
3. Rimuovi la configurazione avanzata e riprova
4. Aggiungi le funzionalità una alla volta per identificare il problema
Documentazione correlata: Risoluzione dei problemi di Percorso, Configurazione degli eventi
2. Aggiorna token di autenticazione
3. Utilizza un account utente/servizio valido noto
4. Rivedi assegnazioni profilo prodotto
Documentazione correlata: Autorizzazioni
2. Controlla la configurazione del percorso e i flag di funzionalità
3. Aggiorna riferimenti interrotti
4. Verifica aggiornamenti e migrazioni di sistema recenti
Documentazione correlata: Creazione Percorso
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. 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. 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: Creazione 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
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. 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.
2. Consenti tempo per la sincronizzazione tra AEM e AJO
3. Riprova con una risorsa valida nota
4. Verifica lo stato di pubblicazione delle risorse in AEM
Documentazione correlata: Integrazione Assets
2. Aggiungi nuovamente il contenuto nei passaggi incrementali per identificare il problema
3. Controlla la pagina Stato Adobe
4. Rimuovi funzioni o markup non supportati
Documentazione correlata: Modelli di contenuto
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. 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. Ripetere l'operazione
3. Salvare il lavoro in modo incrementale
4. Se persiste, passa al supporto Adobe
Documentazione correlata: Modelli di contenuto
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 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.
2. Ricollegare o aggiungere di nuovo i nodi del messaggio
3. Attiva la modalità di test per forzare la creazione di campagne in linea
4. Passa alla creazione guidata nuovo percorso se il problema è frequente
Documentazione correlata: Creazione Percorso, Verifica percorsi
2. Convalidare le connessioni a schemi e provider di dati
3. Ricarica interfaccia utente e cancella cache del browser
4. Ricrea nodo/e-mail se il problema non è stato risolto
Documentazione correlata: Esperimenti di contenuto
2. Utilizza la nuova versione/modello del percorso
3. Utilizza la modalità di test per cancellare la configurazione
4. Ricrea in blocco nodi se il problema è diffuso
Documentazione correlata: Superfici di canale, Simulazione messaggio
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
CJMTL: errori del livello di trasporto cjmtl-errors
Questi errori si verificano durante le operazioni di trasporto e consegna dei messaggi.
2. Verificare che la versione più recente di AJO sia in uso
3. Ripetere l'operazione
4. Usa i domini statici se il problema persiste
Documentazione correlata: Sintassi Personalization, Progettazione e-mail
2. Correggi profilo/informazioni di contatto
3. Convalida con profilo di test
4. Reimposta il formato del payload come necessario
Documentazione correlata: Gestione profili, Profili di test
CJMRPS: errori Reporting and Provisioning Service cjmrps-errors
Questi errori si verificano durante la configurazione della generazione rapporti e le operazioni di provisioning dei set di dati.
2. Non aggiungere nuovamente i set di dati già presenti
3. Utilizza elenchi di controllo ufficiali per la migrazione per la generazione di rapporti
4. Rimuovi riferimenti a set di dati duplicati
Documentazione correlata: Panoramica sui report, Report campagne, Report Percorso
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.
-
Trova il servizio: utilizza il prefisso del servizio (CJMPTS, CJMRT, CJMMAS, CJMCMP, CJMTL, CJMRPS) 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
Argomenti correlati