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.