Scrivere un percorso
Passi, frasi di attivazione e come l'assistente capisce che un passo è finito.
Un percorso ha un nome (come lo chiama l'assistente ad alta voce), una frase di attivazione e i suoi passi in ordine. Lo scrivi nella pagina Journeys; anche un agente di programmazione collegato tramite MCP può prepararne una bozza per te, e una bozza non viene mai eseguita finché non la pubblichi.
La frase di attivazione#
La frase di attivazione viene confrontata con quello che ha scritto il visitatore, quindi scrivi una frase e non un'etichetta di menu: *"quando il visitatore vuole restituire o rimandare indietro qualcosa che ha acquistato"*. Un sostantivo come "Resi" non corrisponde quasi a nulla.
Come finisce un passo#
Ogni passo indica come sappiamo che è finito. È un elenco chiuso, senza condizioni in testo libero, perché una condizione che il motore non può verificare è una condizione che, in silenzio, non scatta mai.
| Finisce quando | Richiede |
|---|---|
click_self | È stato fatto clic sul target del passo stesso. |
visible / hidden | Un elemento target compare o scompare. |
filled | Un campo target ha un valore. |
url_change | L'indirizzo cambia in quello che indichi. |
settled | Un target smette di cambiare. |
attempts | Un numero di tentativi. |
user_continue | Il visitatore preme Continua. Obbligatorio per i passi hold. |
Regola: Un passo che apre una pagina deve finire con qualcosa che la pagina può mostrare. Aprire una pagina smonta lo script e lo ricostruisce sulla nuova pagina, quindi un evento atteso, come un clic, non può mai arrivare: il passo riaprirebbe la pagina a ogni caricamento. Per questo l'editor propone solo url_change, visible e filled per un passo "apri una pagina", e il server rifiuta un piano che dica il contrario. Il motore inoltre ferma un passo dopo due navigazioni, così un piano sbagliato non può mai lasciare il tuo sito a ricaricarsi.
C'è un'altra cosa che il motore fa per te: aspetta che il target di un passo compaia (qualche secondo, controllando di continuo) prima di decidere che manca. Una pagina che mostra il suo modulo un attimo dopo il caricamento è normale, e non deve fermare un percorso.
Pubblicazione#
Ciò che viene pubblicato è una versione specifica. Modificare un percorso pubblicato lo mette offline, così un piano che nessuno ha approvato non può mai essere in esecuzione sul tuo sito. Rileggi i passi, poi pubblica di nuovo.
Suggerimento: Gran parte del lavoro su un percorso consiste nell'indicare gli elementi giusti della pagina. Il target di un passo deve corrispondere a un solo elemento: #country-select o select[aria-label="Passport"] vanno bene se sulla pagina c'è una sola cosa che vi corrisponde, mentre un semplice button viene rifiutato: un riferimento che può indicare quaranta cose non è un puntatore. Se hai collegato un agente di programmazione (vedi Agenti di programmazione), può leggere le tue pagine e preparare i passi: tu controlli e pubblichi.