Gli eventi di viaggio ti aiutano a comprendere i diversi percorsi che i giocatori seguono nella tua esperienza. A differenza di un imbuto lineare, un viaggio può ramificarsi in diversi nodi e riconnettersi in una fase successiva.
Puoi utilizzare gli eventi di viaggio per analizzare i flussi, come ad esempio:
- Onboarding con più scelte
- Progressione in un mondo aperto o in missioni
- Negozi con diversi percorsi di navigazione e acquisto
- Funzionalità che i giocatori possono completare in ordini diversi
Dopo aver configurato un viaggio e iniziato a registrare eventi, puoi visualizzarne i risultati nella pagina Viaggi di Creator Hub.
Configura un viaggio
Per creare un viaggio in Creator Hub:
- Seleziona la tua esperienza.
- Vai su Analisi → Viaggi. Seleziona Crea.
- Inserisci un nome per il viaggio.
- Aggiungi fasi e i nodi che appartengono a ciascuna fase.
- Seleziona Avanti, quindi seleziona Riconosci per salvare e pubblicare la configurazione.
- Nella fase Aggiungi al codice, copia il frammento Luau generato nella tua esperienza, quindi seleziona Fatto per visualizzare il viaggio.

Una fase può contenere più nodi. I nodi nella stessa fase rappresentano azioni alternative che indicano un progresso equivalente.
L'editor di viaggio di Creator Hub supporta:
- 2–10 fasi configurate per viaggio
- 1–10 nodi per fase
- Nomi dei viaggi contenenti lettere, numeri, ., -, e _, fino a 50 caratteri
- Nomi dei nodi fino a 50 caratteri
I nomi dei viaggi non possono iniziare con _. I nomi dei nodi non possono iniziare con __ o contenere virgole, virgolette doppie, apostrofi, interruzioni di riga o caratteri NUL. I nomi dei nodi devono essere unici all'interno di una fase, ma lo stesso nome può essere utilizzato in fasi diverse.
Fase di ingresso automatica
Roblox aggiunge __entry__ come fase 0 all'inizio di ogni viaggio. Non configuri o registri questo nodo. Le 2–10 fasi che configuri sono numerate da 1 a 10 e non includono la fase di ingresso automatica.
Rappresentazione della Configurazione del Creatore
Le configurazioni dei viaggi utilizzano il tipo di repository JourneysConfig di Creator Config. Ogni chiave di voce è il nome del viaggio e il suo valore contiene le fasi e i nodi del viaggio.
Ad esempio, una voce chiamata StoreCheckout può utilizzare questo valore:
{
"stages": [
{
"stage_index": 1,
"nodes": [
{ "node_name": "OpenedStore" }
]
},
{
"stage_index": 2,
"nodes": [
{ "node_name": "ViewedSword" },
{ "node_name": "ViewedArmor" }
]
},
{
"stage_index": 3,
"nodes": [
{ "node_name": "PurchasedItem" }
]
}
]
}Gli indici delle fasi devono essere sequenziali e iniziare da 1. Non includi un indice di fase quando registri un evento. Roblox determina la fase dalla configurazione pubblicata del nodo.
Monitora gli eventi di viaggio
Chiama LogJourneyEvent() dopo che un giocatore ha raggiunto un nodo configurato. Registra eventi dal codice del server e convalida le azioni dei giocatori prima di inviare eventi analitici.
I nomi dei viaggi e dei nodi devono corrispondere esattamente alla configurazione pubblicata:
local AnalyticsService = game:GetService("AnalyticsService")
AnalyticsService:LogJourneyEvent(
player,
"StoreCheckout",
"OpenedStore"
)Monitora viaggi ricorrenti
Utilizza un ID di sessione di viaggio quando lo stesso giocatore può ripetere un viaggio, come aprire un negozio più volte:
local AnalyticsService = game:GetService("AnalyticsService")
local HttpService = game:GetService("HttpService")
local journeySessionId = HttpService:GenerateGUID(false)
AnalyticsService:LogJourneyEvent(
player,
"StoreCheckout",
"OpenedStore",
journeySessionId
)
AnalyticsService:LogJourneyEvent(
player,
"StoreCheckout",
"ViewedSword",
journeySessionId
)
AnalyticsService:LogJourneyEvent(
player,
"StoreCheckout",
"PurchasedItem",
journeySessionId
)Riutilizza lo stesso ID per ogni evento in un tentativo e genera un nuovo ID quando inizia un altro tentativo. Per un viaggio che si verifica solo una volta per giocatore, puoi omettere l'ID di sessione.
Puoi anche allegare fino a tre campi personalizzati agli eventi di viaggio.
Configura viaggi con Open Cloud e Studio MCP
Se gestisci il tuo gioco con MCP, non devi utilizzare l'editor di Creator Hub. I viaggi sono memorizzati come Creator Configs, quindi puoi crearli con una chiave API di Open Cloud e aggiungere il codice di tracciamento con il server Studio MCP.
Le configurazioni dei viaggi utilizzano il tipo di repository JourneysConfig di Creator Config.
Per configurarlo:
Crea una chiave API — Vai su Creator Hub > Open Cloud > Chiavi API, seleziona Crea chiave API e assegnale l'ambito universe:write per il tuo gioco (aggiungi universe:read se desideri anche leggere le configurazioni).
Collegati al Server Studio MCP — Abilita Studio come server MCP, quindi collega il tuo client con Collegamento rapido. Una volta connesso, puoi chiedere al tuo strumento AI di eseguire la configurazione del viaggio end to end. Ad esempio:
"Crea un viaggio StoreCheckout con fasi OpenedStore, poi ViewedSword o ViewedArmor, poi PurchasedItem. Ecco la documentazione sui Viaggi. Usa la mia chiave API di Open Cloud dalla variabile d'ambiente ROBLOX_API_KEY per creare la configurazione. Poi trova dove si apre il negozio, dove vengono visualizzati gli oggetti e dove vengono confermati gli acquisti nei miei script del server, aggiungi chiamate a LogJourneyEvent con un ID di sessione di viaggio e fai un test per controllare che gli eventi vengano attivati."
Comprendere la progressione del viaggio
La progressione del viaggio avanza attraverso le fasi configurate:
- Ripetere il nodo corrente non avanza la progressione.
- Gli eventi dalla stessa fase o da una fase precedente non retrocedono la progressione.
- Passare direttamente a una fase successiva registra le fasi intermedie come saltate.
- Un nodo che non è presente nella versione di configurazione acquisita non avanza il viaggio.
- Raggiungere qualsiasi nodo nell'ultima fase configurata conta come raggiungere l'ultima fase.
Se un utente non ha eventi per un viaggio per più di 180 giorni, il suo progresso salvato scade e conta come un nuovo utente per quel viaggio se ritorna. La sua progressione riparte da __entry__.
Utilizza nomi coerenti e facili da interpretare e registra ogni nodo nello stesso punto nell'azione corrispondente del giocatore.
Visualizza le analisi del viaggio
Da Analisi → Viaggi, trova un viaggio configurato e seleziona Visualizza.
La pagina fornisce viste separate di Sessioni e Utenti:
- La vista Sessioni valuta ogni sessione di viaggio in modo indipendente.
- La vista Utenti mostra la progressione della prima volta di ogni giocatore attraverso le sessioni di viaggio.
Ogni vista include:
- Totale utenti o sessioni di viaggio
- Utenti o sessioni che hanno raggiunto l'ultima fase configurata
- Nodo e fase con il maggior abbandono
- Un grafico di Sankey che mostra i percorsi tra i nodi
- Un'analisi dei percorsi
- Analisi di abbandono per nodo o fase

Puoi filtrare i risultati per:
- Nome e versione del viaggio
- Campi personalizzati 1–3
- Fascia di età e genere
- Stato di pagatore e nuovo utente
- Sistema operativo e piattaforma
Intervalli di date e coorti
L'intervallo di date selezionato definisce la coorte di acquisizione:
- Un utente appartiene alla data in cui è entrato per la prima volta nel viaggio.
- Una sessione appartiene alla data in cui è iniziata quella sessione di viaggio.
- Le analisi includono il progresso di quella coorte per 90 giorni dopo la fine dell'intervallo selezionato.
La progressione dell'utente rimane associata alla versione del viaggio che l'utente ha acquisito per la prima volta. Ogni nuova sessione di viaggio iniziata utilizza la versione attiva quando è iniziata quella sessione.
Modifica un viaggio
Dall'elenco dei Viaggi, puoi:
- Selezionare Visualizza per aprire la pagina di analisi
- Selezionare Modifica per cambiare il viaggio
- Selezionare Elimina per rimuovere permanentemente la configurazione
Salvare una modifica pubblica una nuova versione della configurazione. Il filtro Versione del viaggio mostra una versione alla volta, etichettata con la data e l'ora in cui è stata pubblicata, e predefinita sulla versione più recente che i giocatori hanno acquisito durante l'intervallo di date selezionato. Per analizzare una versione diversa, selezionala dal filtro.
Pubblicare una nuova versione non migra il progresso esistente
Nella vista Utenti, un giocatore che ha già acquisito il viaggio rimane associato a quella versione originale. La nuova versione si applica quando un giocatore acquisisce nuovamente il viaggio.
Nella vista Sessioni, ogni sessione mantiene la versione che ha acquisito quando è iniziata. Una nuova sessione di viaggio acquisisce la versione attualmente pubblicata, anche quando il giocatore ha un progresso a livello utente su una versione precedente.
Le configurazioni dei viaggi vengono elaborate quotidianamente. Se pubblichi più versioni nello stesso giorno, le analisi utilizzano l'ultima versione disponibile quel giorno per gli utenti e le sessioni appena acquisiti.