Risolvere i problemi di un percorso troubleshooting
In questa sezione, scopri come risolvere i problemi dei percorsi prima di eseguire test o pubblicare. Tutti i controlli elencati di seguito possono essere effettuati quando il percorso è in modalità di test o quando è live. Ti consigliamo di eseguire tutti i controlli riportati di seguito in modalità di test, quindi di procedere alla pubblicazione. Consulta questa pagina.
Verifica la presenza di errori prima del test checking-for-errors-before-testing
Prima di testare e pubblicare il percorso, controlla che tutte le attività siano state configurate correttamente. Non è possibile eseguire test o pubblicazioni se il sistema rileva ancora degli errori.
Errori nelle attività activity-errors
Gli errori vengono visualizzati con un simbolo di avviso visualizzato sulle attività stesse all’interno dell’area di lavoro. Per visualizzare il messaggio di errore, posiziona il cursore sul punto esclamativo. Se fai clic sull’attività, la riga dovrebbe essere visualizzata in errore con un avviso. Ad esempio:
-
se un campo obbligatorio è vuoto, viene visualizzato un errore
-
quando due attività vengono disconnesse, nell’area di lavoro viene visualizzato un avviso
Errori nel percorso canvas-errors
Gli errori sono visibili anche dal pulsante Avvisi, sopra l'area di lavoro. Questo pulsante consente di visualizzare gli errori rilevati dal percorso che impediscono l'attivazione della modalità di test o la pubblicazione.
Il sistema rileva due tipi di problemi: errori e avvisi. Gli errori bloccano la pubblicazione e l’attivazione di test. Gli avvisi indicano i potenziali problemi che non impediscono l’attivazione del test o la pubblicazione. Vedrai una descrizione del problema e un ID di registro del problema del tipo ERR_XXX_XXX. Questo può aiutare a identificare il problema.
Gli errori e gli avvisi globali relativi al percorso vengono visualizzati per primi nell’elenco. Gli errori e gli avvisi relativi ad attività specifiche sono elencati successivamente per ordine di attività o per visualizzazione nel percorso da sinistra a destra. Nella parte inferiore dell'elenco degli avvisi, il pulsante Copia dettagli consente di copiare le informazioni tecniche sul percorso utili per la risoluzione dei problemi.
Aggiungi un percorso alternativo canvas-add-path
È possibile definire un'azione di fallback in caso di errore per le seguenti attività di percorso: Condizione e Azione.
Quando si verifica un errore in un’azione o in una condizione, il percorso di un singolo utente si arresta. L'unico modo per farlo continuare è risolvere il problema. Per evitare di interrompere il percorso, puoi anche selezionare l'opzione Aggiungi un percorso alternativo in caso di timeout o errore nelle proprietà dell'attività. Ulteriori informazioni in questa sezione.
Verifica che gli eventi siano inviati correttamente checking-that-events-are-properly-sent
Il punto di partenza di un percorso è sempre un evento. Puoi eseguire i test utilizzando strumenti come Postman.
Puoi verificare se la chiamata API inviata tramite questi strumenti viene inviata correttamente o meno. Se ricevi nuovamente un errore, significa che la chiamata presenta un problema. Controlla di nuovo il payload, l’intestazione (e in particolare l’ID organizzazione) e l’URL di destinazione. Puoi chiedere all’amministratore qual è l’URL corretto da utilizzare.
Gli eventi non vengono inviati direttamente dall’origine ai percorsi. In effetti, i percorsi si basano sulle API Streaming Ingestion di Adobe Experience Platform. Di conseguenza, in caso di problemi relativi agli eventi, puoi fare riferimento alla documentazione di Adobe Experience Platform per la risoluzione dei problemi relativi alle API Streaming Ingestion.
Controlla se le persone entrano nel percorso checking-if-people-enter-the-journey
Il reporting percorso misura le entrate delle persone in un percorso in tempo reale.
Se l’invio dell’evento è stato completato con successo ma non viene visualizzato alcuna entrata nel percorso, significa che si sono verificati errori tra l’invio dell’evento e la ricezione dell’evento nel percorso.
Per iniziare la risoluzione dei problemi, consulta le domande seguenti:
-
Hai la certezza che il percorso in cui prevedevi che arrivasse l’evento fosse in modalità di test o live?
-
Hai salvato l’evento prima di copiare il payload dall’anteprima del payload?
-
Il payload dell’evento contiene un ID evento?
-
Hai raggiunto l’URL giusto?
-
Hai seguito la struttura del payload delle API di Streaming Ingestion utilizzando l’anteprima della struttura del payload nel riquadro di configurazione dell’evento? Consulta questa pagina.
-
Hai utilizzato le coppie chiave-valore corrette nell’intestazione dell’evento?
code language-none X-gw-ims-org-id - your organization's ID Content-type - application/json
Controllare il modo in cui le persone si spostano nel percorso checking-how-people-navigate-through-the-journey
Il reporting di percorso misura il progresso delle persone all'interno di un percorso. È facile identificare in che punto una persona si è fermata e per quale motivo.
Di seguito sono riportati alcuni elementi da verificare:
- È dovuto a una condizione che esclude la persona? Ad esempio, la condizione è “gender = male” e la persona in oggetto è una donna. Questo controllo può essere eseguito da un utente aziendale, se la condizione non è troppo complessa.
- È dovuto a una chiamata a un’origine dati che non risponde? Quando il percorso è in modalità di test, queste informazioni possono essere visualizzate nei registri in modalità di test. Quando il percorso è live, un amministratore può testare le chiamate dirette all’origine dati e verificare la risposta ricevuta. Un amministratore può anche duplicare il percorso e testarlo.
Verifica che i messaggi siano inviati correttamente checking-that-messages-are-sent-successfully
Se gli individui si spostano nel modo giusto durante il percorso ma non ricevono i messaggi che dovrebbero ricevere, puoi verificare se:
- Journey Optimizer ha preso correttamente in considerazione la richiesta di invio del messaggio. Gli utenti aziendali possono accedere al messaggio che doveva essere stato inviato e verificare se l’ora dell’esecuzione più recente corrisponde all’orario di esecuzione del percorso. Può anche controllare le ultime chiamate/eventi API ricevuti.
- Journey Optimizer ha inviato correttamente il messaggio. Controlla la segnalazione del percorso per assicurarti che non ci siano errori.
Nel caso di un messaggio inviato tramite un’azione personalizzata, l’unica cosa che è possibile controllare durante il test di percorso è il fatto che la chiamata del sistema dell’azione personalizzata conduca o meno a un errore. Se la chiamata al sistema esterno associata all’azione personalizzata non genera un errore ma non causa l’invio di un messaggio, è necessario eseguire alcune indagini sul lato del sistema esterno.