Risolvere i problemi relativi all’esecuzione live del percorso troubleshooting-execution
In questa sezione, scopri come risolvere i problemi relativi agli eventi di percorso, verificare se i profili sono entrati nel percorso, come ci si sposta e se i messaggi vengono inviati.
È inoltre possibile risolvere gli errori prima di testare o pubblicare un percorso. Scopri come in questa pagina.
Se utilizzi azioni in entrata, scopri come risolverle in questa pagina.
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.
Se il percorso non è in grado di abilitare la modalità di test con l'errore ERR_MODEL_RULES_16, verificare che l'evento utilizzato includa uno spazio dei nomi identità quando si utilizza un'azione del canale.
Lo spazio dei nomi dell’identità viene utilizzato per identificare in modo univoco i profili di test. Ad esempio, se per identificare i profili di test si utilizza l'e-mail, deve essere selezionato lo spazio dei nomi dell'identità E-mail. Se l'identificatore univoco è il numero di telefono, deve essere selezionato lo spazio dei nomi dell'identità Telefono.
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 visualizzata 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 per l’acquisizione in streaming 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 è “genere = uomo” 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 all’interno del 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.
Informazioni sulle voci duplicate negli eventi dei passaggi del Percorso duplicate-step-events
Perché trovo più voci con gli stessi ID istanza, profilo, nodo e richiesta di percorso?
Quando si esegue una query sui dati degli eventi delle fasi del Percorso, è possibile osservare occasionalmente voci di registro duplicate per la stessa esecuzione del percorso. Queste voci condividono valori identici per:
profileID- Identità del profiloinstanceID- Identificatore dell'istanza del percorsonodeID- Nodo percorso specificorequestID- Identificatore della richiesta
Tuttavia, queste voci hanno valori _id diversi, che è l'indicatore chiave che distingue questo scenario dalla duplicazione effettiva dei dati.
Da cosa deriva questo comportamento?
Ciò si verifica a causa delle operazioni di scalabilità automatica back-end (o "ribilanciamento") nell’architettura dei microservizi di Adobe Journey Optimizer. Durante i periodi di carico elevato o di ottimizzazione del sistema:
- Un evento del passaggio di percorso inizia l’elaborazione e viene registrato nel set di dati Eventi del passaggio di Percorso
- Un'operazione di ridimensionamento automatico ridistribuisce il carico di lavoro tra le istanze del servizio
- Lo stesso evento può essere rielaborato da un'altra istanza del servizio, creando una seconda voce di registro con un
_iddiverso
Si tratta di un comportamento di sistema previsto e funziona come previsto.
Vi è un impatto sull’esecuzione del percorso o sulla consegna dei messaggi?
No. L'impatto è limitato solo alla registrazione. Adobe Journey Optimizer dispone di meccanismi di deduplicazione incorporati a livello di esecuzione dei messaggi che garantiscono:
- A ciascun profilo viene inviato un solo messaggio (e-mail, SMS, notifica push, ecc.)
- Le azioni vengono eseguite una sola volta
- L'esecuzione del percorso procede correttamente
È possibile verificare questa situazione eseguendo una query su ajo_message_feedback_event_dataset o controllando i registri di esecuzione dell'azione. Si noterà che è stato effettivamente inviato un solo messaggio, nonostante le voci di evento del passaggio di percorso duplicate.
Come posso identificare questi casi nelle mie query?
Durante l’analisi dei dati degli eventi dei passaggi del Percorso:
-
Controllare il campo
_id: i duplicati a livello di sistema effettivi avrebbero lo stesso_id. Valori_iddiversi indicano voci di registro separate dallo scenario di ribilanciamento descritto sopra. -
Verifica recapito messaggi: riferimento incrociato con i dati di feedback del messaggio per confermare che è stato inviato un solo messaggio:
code language-sql SELECT timestamp, _experience.customerJourneyManagement.messageExecution.messageExecutionID, _experience.customerJourneyManagement.messageDeliveryfeedback.feedbackStatus FROM ajo_message_feedback_event_dataset WHERE _experience.customerJourneyManagement.messageExecution.journeyVersionID = '<journeyVersionID>' AND TO_JSON(identityMap) like '%<profileID>%' ORDER BY timestamp DESC; -
Raggruppa per identificatori univoci: durante il conteggio delle esecuzioni, utilizza
_idper ottenere conteggi accurati:code language-sql SELECT COUNT(DISTINCT _id) as unique_executions FROM journey_step_events WHERE _experience.journeyOrchestration.stepEvents.journeyVersionID = '<journeyVersionID>' AND _experience.journeyOrchestration.stepEvents.profileID = '<profileID>'
Cosa devo fare se osservo questo?
Si tratta di un comportamento normale del sistema e non è richiesta alcuna azione. La registrazione duplicata non indica un problema nella configurazione del percorso o nella consegna del messaggio.
Se stai creando rapporti o analisi basati su eventi dei passaggi del Percorso:
- Usa
_idcome chiave primaria per il conteggio degli eventi univoci - Riferimento incrociato con i set di dati di feedback dei messaggi durante l’analisi della consegna dei messaggi
- Tieni presente che l’analisi dei tempi può mostrare le voci raggruppate in pochi secondi l’una dall’altra
Per ulteriori informazioni sull'esecuzione di query sugli eventi dei passaggi del Percorso, vedere Esempi di query.