In questa pagina: scopri come convalidare il percorso prima di pubblicarlo utilizzando la simulazione con utenti simulati o la modalità di test con profili di test per rilevare gli errori in anticipo.
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 — Percorsi che rimangono inattivi in modalità di test per per una settimana escono automaticamente dalla modalità di test e tornano allo stato Bozza. Non viene perso alcun contenuto di percorso; termina solo la sessione in modalità di test.
- 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.
- Consegna messaggi - In modalità di test, i messaggi vengono inviati alle caselle in entrata effettive dei profili di test utilizzando la stessa pipeline di consegna della produzione. Differisce da Esecuzione di prova del Percorso, che simula l’esecuzione del percorso senza inviare messaggi o attivare azioni del canale reale. Nessuno dei due metodi replica ogni aspetto di un invio live; utilizza un ambiente di staging per la convalida completa end-to-end.
Execution
- Comportamento suddivisione - Quando il percorso raggiunge una suddivisione, il ramo superiore viene sempre selezionato in modalità di test. Questo non riflette il percorso selezionato statisticamente durante l’esecuzione live. 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 eliminati con il messaggio di registro
DISPATCHER DISCARD #16 — unqualified on journey version enablements. Per ovviare a questo problema durante il test, imposta temporaneamente la data di inizio del percorso su un’ora precedente al momento corrente, quindi ripristinala prima di pubblicarla. 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.
Risoluzione dei problemi della modalità di test troubleshoot-test-mode
Utilizzare questa tabella per eseguire la diagnosi automatica degli errori comuni della modalità di test prima di aprire un ticket di supporto.
@{<EventName>.identityMap.entry('<NamespaceName>').first().id}. <NamespaceName> deve corrispondere esattamente allo schema evento (distinzione maiuscole/minuscole). Consulta Prerequisiti.DISPATCHER DISCARD #16 — unqualified on journey version enablementsERR_MODEL_RULES_16Attivare 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.
Il valore Identificatore profilo deve corrispondere esattamente all’identità archiviata nello schema eventi. Il formato utilizzato per fare riferimento a un’identità nel payload dell’evento è:
@{<EventName>.identityMap.entry('<NamespaceName>').first().id}
Sostituisci <NamespaceName> con lo spazio dei nomi esattamente come definito nello schema dell’evento (ad esempio, Email o Phone). Una mancata corrispondenza dello spazio dei nomi causa una perdita invisibile all’utente: l’evento viene accettato e restituisce una risposta di successo, ma il profilo non entra mai nel percorso e non viene visualizzato alcun errore nell’interfaccia utente. Se un profilo non viene visualizzato nei registri di test dopo l’attivazione di un evento, verificare che lo spazio dei nomi nell’Identificatore profilo corrisponda esattamente allo spazio dei nomi dello schema dell’evento.
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”.
Questa sezione contiene informazioni strutturate che supportano l’interpretazione, il recupero e la risposta alle domande relative a questo argomento.
Per una comprensione completa, queste informazioni devono essere unite alla documentazione su questa pagina. Nessuna delle due origini è progettata per essere indipendente; la pagina descrive la funzione, mentre questa sezione fornisce un contesto aggiuntivo che aiuta a non ambiguare la terminologia, le finalità, l’applicabilità e i vincoli.
- TL;DR: In questa pagina viene illustrato come utilizzare la modalità di test in Adobe Journey Optimizer per convalidare un percorso con profili di test persistenti prima della pubblicazione, inclusi l’attivazione della modalità di test, l’attivazione di eventi, la lettura dei registri e la gestione di eventi aziendali e basati su regole.
Intenti:
- Attiva la modalità di test in un percorso in stato di bozza per convalidarla con profili di test AEP preesistenti
- Configurare e attivare eventi per i profili di test tramite l’interfaccia Attiva un evento
- Ignora le durate delle attività di attesa in modalità di test per accelerare la progressione del percorso
- Leggi e interpreta l’output Mostra registro JSON per verificare la progressione del profilo e identificare gli errori
- Testare percorsi basati su regole e percorsi di eventi business in modalità di test
- Comprendere le limitazioni e le differenze comportamentali della modalità di test rispetto alla simulazione
Glossario:
- Modalità test: stato di convalida del percorso che consente ai profili di test AEP persistenti di attraversare un percorso in stato di bozza prima che venga pubblicato (specifico per prodotto)
- Profili di test: Profili contrassegnati esplicitamente come profili di test nel servizio Profilo cliente in tempo reale di Adobe Experience Platform; l’unico tipo di profilo consentito per accedere a un percorso in modalità di test (specifico per prodotto)
- Flusso visivo: la rappresentazione dell’area di lavoro che diventa verde per mostrare il percorso seguito da un profilo di test nel percorso
- Mostra registro: funzionalità della modalità di test che visualizza lo stato di esecuzione del percorso in formato JSON per ogni istanza del profilo di test (specifico per prodotto)
- Eventi di prova Journey Orchestration: il nome di origine con cui gli eventi di esperienza in modalità di prova vengono archiviati in Adobe Experience Platform
Guardrail:
- Solo i profili contrassegnati come profili di test in AEP possono entrare in un percorso in modalità di test
- La modalità di test richiede che il percorso utilizzi uno spazio dei nomi per verificare l’identità del profilo di test
- Massimo 100 profili di test per singola sessione di test
- Gli eventi possono essere attivati solo dall’interfaccia utente della modalità di test; l’attivazione di API esterne non è supportata
- L’arricchimento dell’attributo del pubblico di caricamento personalizzato non è supportato in modalità di test
- Gli eventi attivati in modalità di test generano eventi di esperienza reali che possono anche attivare altri percorsi che ascoltano lo stesso evento
- In modalità di test, le attività Attendi e la maggior parte dei timeout evento sono impostati per impostazione predefinita su 10 secondi; i timeout evento reazione sono impostati per impostazione predefinita su un minimo di 40 secondi
- Disattivazione automatica: i Percorsi che rimangono inattivi in modalità di test per più di una settimana escono automaticamente dalla modalità di test e tornano allo stato Bozza. Non viene perso alcun contenuto di percorso; termina solo la sessione in modalità di test.
- Le modifiche al percorso sono bloccate mentre la modalità di test è attiva, ma è consentita la pubblicazione diretta
- In una suddivisione, il ramo superiore è sempre selezionato; riordina i rami per testare percorsi diversi
- Timeout evento di reazione minimo e tempo di attesa predefinito di 40 secondi
- Gli eventi inviati al di fuori della finestra di data di inizio/fine configurata del percorso vengono eliminati automaticamente
- La disattivazione della modalità di test rimuove tutti i profili dal percorso e cancella i rapporti
Terminologia:
- Nome canonico: modalità di prova — Acronimo: none — varianti: modalità di prova, modalità di prova del percorso
- Nome canonico: Profili di test — Acronimo: none — Varianti: utenti di test (solo etichetta interfaccia utente di simulazione)
- Sinonimi: “Mostra registro” = registro risultati test; “flusso visivo” = visualizzazione percorso area di lavoro
- Non confondere: “Modalità di test” ≠ “Simulazione”: la modalità di test utilizza profili di test AEP persistenti; la simulazione utilizza utenti simulati temporanei generati al volo
Domande frequenti:
- Q: chi può entrare in un percorso in modalità di test? — Solo i profili contrassegnati esplicitamente come profili di test nel servizio Profilo cliente in tempo reale di Adobe Experience Platform.
- Q: quanti profili di test possono essere eseguiti in una singola sessione di test? — Un massimo di 100 profili di test per sessione di test.
- Q: cosa succede quando si disabilita la modalità di test? — Tutti i profili attualmente presenti o precedentemente immessi nel percorso vengono rimossi e il reporting viene cancellato.
- Q: posso modificare un percorso mentre la modalità di test è attiva? — No Non è possibile modificare il percorso mentre la modalità di test è attiva, ma è possibile pubblicarlo direttamente senza disattivare prima la modalità di test.
- Q: perché gli eventi di test vengono ignorati in modo invisibile all’utente? — Gli eventi attivati al di fuori dell’intervallo di data/ora attivo configurato dal percorso vengono automaticamente scartati. Verificare che le date di inizio e di fine del percorso includano l’ora corrente.
- D: cosa indica il campo fase nel registro di test? — Mostra lo stato corrente del profilo: in esecuzione (attivo nel percorso), finito (raggiunto alla fine), errore (arrestato a causa di un errore) o timeout (arrestato a causa di un timeout).