Testare il percorso testing_the_journey
Dopo aver creato il percorso, puoi testarlo prima di pubblicarlo. Adobe Journey Optimizer offre la “modalità di test” come modo per visualizzare i profili di test durante lo spostamento nel percorso, rilevando potenziali errori prima dell’attivazione. L’esecuzione di test rapidi consente di verificare il corretto funzionamento dei percorsi e di pubblicarli in modo affidabile.
Solo i profili di test possono accedere a un percorso in modalità di test. Puoi creare nuovi profili di test o trasformare quelli esistenti in profili di test. Ulteriori informazioni sui profili di test in questa sezione.
Adobe Percorsi Optimizer offre due modi per testare e convalidare il percorso:
-
Simulazione: imposta il percorso su Simulazione e utilizza gli utenti simulati (profili temporanei creati o generati al volo senza profili precreati in Adobe Experience Platform).
-
Modalità di test: i profili persistenti sono contrassegnati in modo esplicito come profili di test in Adobe Experience Platform. Possono essere riutilizzati in più sessioni di test. Questo metodo è consigliato per il test con dati di profilo coerenti e predefiniti. Scopri come creare profili di test.
Note importanti important_notes
Esamina queste note prima di eseguire i test nel percorso.
Limitazioni generali
- Solo profili di test - Solo i singoli utenti contrassegnati come “profili di test” nel servizio Profilo cliente in tempo reale possono accedere a un percorso in modalità di test. Scopri come creare profili di test.
- Requisito spazio dei nomi - La modalità di test è disponibile solo per i percorsi bozza che utilizzano uno spazio dei nomi. La modalità di test deve verificare se una persona che entra nel percorso è un profilo di test o meno e deve quindi essere in grado di raggiungere Adobe Experience Platform.
- Limite profilo - Un massimo di 100 profili di test può entrare in un percorso durante una singola sessione di test.
- Attivazione evento - Gli eventi possono essere attivati solo dall’interfaccia. Gli eventi non possono essere attivati da sistemi esterni che utilizzano un’API.
- Tipi di pubblico per caricamento personalizzati - La modalità di test Percorso non supporta l’arricchimento degli attributi Pubblico per caricamento personalizzato.
Comportamento durante e dopo il test
- Disabilitazione della modalità di test - Quando si disabilita la modalità di test, tutti i profili attualmente presenti o precedentemente immessi nel percorso vengono rimossi e il reporting viene cancellato.
- Flessibilità di riattivazione - È possibile abilitare e disabilitare la modalità di test il numero di volte necessario.
- Disattivazione automatica: i Percorsi che rimangono inattivi in modalità di test per per una settimana tornano automaticamente allo stato Bozza per ottimizzare le prestazioni ed evitare l’utilizzo di risorse obsolete.
- Modifica e pubblicazione - Se la modalità di test è attiva, non è possibile modificare il percorso. Tuttavia, puoi pubblicare direttamente il percorso, senza dover disattivare prima la modalità di test.
Execution
- Comportamento divisione - Quando il percorso raggiunge una divisione, il ramo superiore è sempre selezionato. Riordinare i rami se si desidera testare un percorso diverso.
- Tempistica eventi - Se il percorso include più eventi, attiva ogni evento in sequenza. L’invio di un evento troppo presto (prima del completamento del primo nodo di attesa) o troppo tardi (dopo il timeout configurato) comporta l’eliminazione dell’evento. Il profilo viene quindi inviato a un percorso di timeout. Conferma sempre che qualsiasi riferimento ai campi del payload dell’evento rimanga valido inviando il payload all’interno della finestra definita.
- Intervallo date attivo - Assicurarsi che la finestra date/ore di inizio e fine configurata nel percorso includa l’ora corrente durante l’avvio della modalità di test. In caso contrario, gli eventi di test attivati vengono automaticamente scartati. Ulteriori informazioni sulla risoluzione del problema in questa pagina.
- Eventi di reazione - Per gli eventi di reazione con timeout, il tempo di attesa minimo e predefinito è di 40 secondi.
- Set di dati di test - Gli eventi attivati in modalità di test sono archiviati in set di dati dedicati etichettati come segue:
JOtestmode - <schema of your event> - Infrastruttura condivisa - La modalità di test viene eseguita sulla stessa infrastruttura di produzione. Durante periodi di traffico elevato, puoi notare ritardi negli invii di e-mail o nell’elaborazione di eventi. In questo caso, controlla le dashboard del traffico della piattaforma o riprova i test nelle ore non di punta.
Attiva la modalità di test
Utilizzare il metodo Modalità test per testare il percorso con profili di test preesistenti già creati in Adobe Experience Platform.
-
Per attivare la modalità test, fare clic sul pulsante Simula e selezionare Modalità test.
-
Se nel percorso è presente almeno un’attività Wait, impostare il parametro Wait time per definire la durata di ogni attività di attesa e di ogni timeout evento in modalità di test. Il tempo predefinito è di 10 secondi per attese e timeout di eventi. In questo modo potrai ottenere rapidamente i risultati del test.
note NOTE Quando in un percorso viene utilizzato un evento di reazione con timeout, il valore predefinito e minimo del tempo di attesa è di 40 secondi. Vedi questa sezione. -
Utilizza il pulsante Attiva un evento per configurare e inviare eventi al percorso.
-
Configura i diversi campi previsti. Nel campo Identificatore profilo immettere il valore del campo utilizzato per identificare il profilo di test. Ad esempio, può essere l’indirizzo e-mail. Assicurati di inviare eventi relativi ai profili di test. Vedi questa sezione.
-
Dopo aver ricevuto gli eventi, fare clic sul pulsante Mostra registro per visualizzare i risultati del test e verificarli. Vedi questa sezione.
-
In caso di errori, disattiva la modalità di test, modifica il percorso e verificalo di nuovo. Una volta completati i test, puoi pubblicare il percorso. Consulta questa pagina.
Esempio funzionante: convalidare un percorso semplice test-walkthrough
L’esempio seguente esegue il test di un percorso che inizia con un evento unitario, invia un’e-mail, attende 10 minuti e successivamente invia una notifica push.
Per convalidare il percorso dall’inizio alla fine:
-
Attiva la modalità di test facendo clic su Modalità di test nell’angolo in alto a destra. L’area di lavoro passa alla modalità di test e viene visualizzato un pulsante Attiva un evento.
-
Imposta Tempo di attesa su 10 secondi in modo che il nodo di attesa venga completato rapidamente durante il test.
-
Fai clic su Attiva un evento, seleziona l’evento e immetti un identificatore del profilo di test (ad esempio, l’indirizzo e-mail di un profilo contrassegnato come profilo di test in Adobe Experience Platform).
-
Fai clic su Invia. Il flusso visivo viene visualizzato sull’area di lavoro e diventa verde mentre il profilo procede attraverso ogni passaggio.
-
Fai clic su Mostra registro e conferma quanto segue nell’output JSON:
currentstepcorrisponde all’attività in cui si prevede che si trovi il profilo.phasemostrarunningmentre il profilo si trova in un nodo di attesa efinishedquando raggiunge la fine.- Nessuna voce
actionExecutionErrorspresente.
-
Dopo 10 secondi, aggiorna il registro. Il profilo deve aver superato il nodo di attesa e attivato l’azione push.
-
Quando tutti i passaggi mostrano
finishede non vengono registrati errori, disattivare la modalità di test e pubblicare il percorso.
- L'identificatore di profilo immesso è contrassegnato come profilo di test in Adobe Experience Platform.
- Le date di inizio e di fine configurate per il percorso includono l’ora corrente. Gli eventi attivati al di fuori di questa finestra vengono automaticamente scartati. Ulteriori informazioni.
Attivare gli eventi firing_events
Utilizza il pulsante Attiva un evento per configurare un evento che farà entrare una persona nel percorso.
Prerequisiti trigger-events-prerequisites
Come prerequisito, è necessario sapere quali profili sono contrassegnati come profili di test in Adobe Experience Platform. In effetti, la modalità di test consente solo questi profili nel percorso.
L’evento deve contenere un ID. L’ID previsto dipende dalla configurazione dell’evento. Ad esempio, può essere un ECID o un indirizzo e-mail. Il valore di questa chiave deve essere aggiunto nel campo Identificatore profilo.
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.
-
Quando si attiva un evento in modalità di test, viene generato un evento reale, ovvero che si verificherà anche in altri percorsi che ascoltano l’evento.
-
Assicurati che ogni evento in modalità di test sia attivato nell’ordine corretto e all’interno della finestra di attesa configurata. Ad esempio, in caso di attesa di 60 secondi, il secondo evento deve essere attivato solo dopo che è trascorso tale attesa di 60 secondi e prima della scadenza del limite di timeout.
Configurazione evento trigger-events-configuration
Se il percorso contiene più eventi, utilizza l’elenco a discesa per selezionare un evento. Quindi, per ogni evento, configura i campi passati e l’esecuzione dell’invio dell’evento. L’interfaccia ti aiuta a trasmettere le informazioni corrette nel payload dell’evento e garantisce che il tipo di informazioni sia corretto. La modalità di test salva gli ultimi parametri utilizzati in una sessione di test per un utilizzo successivo.
L’interfaccia ti consente di trasmettere parametri evento semplici. Se si desidera passare raccolte o altri oggetti avanzati nell’evento, è possibile selezionare Vista Codice per visualizzare l’intero codice del payload e modificarlo. Ad esempio, puoi copiare e incollare le informazioni sull’evento preparate da un utente tecnico.
Un utente tecnico può inoltre utilizzare questa interfaccia per comporre payload di eventi e attivare eventi senza dover utilizzare uno strumento di terze parti.
Quando si fa clic sul pulsante Invia, inizia il test. La progressione dell’individuo nel percorso è rappresentata da un flusso visivo. Il tracciato diventa verde man mano che l’individuo si sposta attraverso il percorso. Se si verifica un errore, nel passaggio corrispondente viene visualizzato un simbolo di avviso. È possibile posizionare il cursore su di esso per visualizzare ulteriori informazioni sull’errore e accedere ai dettagli completi (se disponibili).
Quando selezioni un profilo di test diverso nella schermata di configurazione dell’evento ed esegui di nuovo il test, il flusso visivo viene cancellato e mostra il percorso del nuovo individuo.
Quando si apre un percorso in un test, il percorso visualizzato corrisponde all’ultimo test eseguito.
Modalità di test per percorsi basati su regole test-rule-based
La modalità di test è disponibile anche per i percorsi che utilizzano un evento basato su regole. Per ulteriori informazioni sugli eventi basati su regole, consulta questa pagina.
Quando si attiva un evento, la schermata Configurazione evento consente di definire i parametri dell’evento da passare nel test. Per visualizzare la condizione dell’ID evento, fai clic sull’icona con la descrizione comando nell’angolo in alto a destra. È inoltre disponibile una descrizione comando accanto a ogni campo che fa parte della valutazione delle regole.
Modalità di test per gli eventi di business test-business
Quando utilizzi un evento di business, utilizza la modalità di test per attivare un singolo ingresso del profilo di test nel percorso, simulare l’evento e passare l’ID profilo corretto. Devi trasmettere i parametri dell’evento e l’identificatore del profilo di test che entrerà nel percorso in test. In modalità di test, non è disponibile la modalità “Visualizzazione codice” per i percorsi basata su eventi di business.
Si noti che quando si attiva per la prima volta un evento business, non è possibile modificare la definizione dell’evento business nella stessa sessione di test. È possibile fare in modo che lo stesso individuo o un individuo diverso entri nel percorso passando lo stesso identificatore o un altro identificatore. Se si desidera modificare i parametri degli eventi business, è necessario interrompere e riavviare la modalità di test.
Visualizzare i registri viewing_logs
Il pulsante Mostra registro consente di visualizzare i risultati del test. In questa pagina vengono visualizzate le informazioni correnti del percorso in formato JSON. Un pulsante consente di copiare interi nodi. Per aggiornare i risultati del test del percorso, è necessario aggiornare manualmente la pagina.
Viene visualizzato il numero di individui (tecnicamente denominati istanze) attualmente all’interno del percorso. Per ogni individuo vengono visualizzate le seguenti informazioni:
- Id: ID interno dell’individuo nel percorso. Può essere utilizzato a scopo di debug.
- currentstep: il passaggio in cui si trova l’utente nel percorso. È consigliabile aggiungere etichette alle attività per identificarle più facilmente.
- currentstep > fase: lo stato del percorso dell’utente (in esecuzione, terminato, errore o timeout). Per ulteriori informazioni, consulta di seguito.
- currentstep > extraInfo: descrizione dell’errore e altre informazioni contestuali.
- currentstep > fetchErrors: informazioni sugli errori di recupero dati che si sono verificati durante questo passaggio.
- externalKeys: valore della formula chiave definita nell’evento.
- arricchedData: i dati recuperati dal percorso se il percorso utilizza origini dati.
- transitionHistory: elenco dei passaggi seguiti dall’utente. Per gli eventi, viene visualizzato il payload.
- actionExecutionErrors: informazioni sugli errori che si sono verificati.
Di seguito sono riportati i diversi stati del percorso di un singolo utente:
- In esecuzione: l’individuo è attualmente nel percorso.
- Fine: l’utente si trova alla fine del percorso.
- Errore: l’utente è stato arrestato nel percorso a causa di un errore.
- Timeout: l’utente è stato arrestato nel percorso a causa di un passaggio che ha richiesto troppo tempo.
Quando un evento viene attivato utilizzando la modalità di test, viene generato automaticamente un set di dati con il nome dell’origine.
La modalità di test crea automaticamente un evento esperienza e lo invia a Adobe Experience Platform. Il nome dell’origine di questo evento esperienza è “Eventi di test di Journey Orchestration”.