I link profondi ti consentono di inviare gli utenti in un luogo specifico in un'esperienza, il che può rendere più fluido il processo di adesione, aiutare gli utenti a trovare i loro amici e fornire l'attribuzione del traffico.I dati di lancio opzionali in questi link ti consentono di personalizzare l'esperienza utente quando qualcuno si unisce.
Costruisci un Callegareprofondo
Un URL di profondo link consiste in un formato URL insieme ai parametri che specifichi. Le seguenti sezioni descrivono come costruire ciascun formato.
Parametri URL
I collegamenti profondi supportano i seguenti parametri URL. Tutti sono opzionali a meno che non diversamente notato.
Parametro | Descrizione :--- | :--- placeId | L'ID del luogo da unirsi.Richiesto a meno che userId non sia specificato. userId | L'ID utente da unirsi.Risultati in un errore "Seguito utente ha lasciato l'esperienza" se l'utente ha lasciato l'esperienza o è Disconneso.accessCode | Il codice di accesso al server privato.linkCode | Il codice del link del server privato. gameInstanceId | L'identificatore univoco dell'istanza di gioco da unirsi, chiamato anche DataModel.JobId.launchData | Informazioni aggiuntive che vuoi includere nel deep Callegare, come codici promozionali o coordinate.Processo utilizzando il metodo Player:GetJoinData() .Vedi Includi i dati di lancio .
Requisiti e linee guida
- Devi URL codificare i caratteri speciali, come gli spazi. Questi caratteri vengono decodificati automaticamente quando l'utente si unisce alla tua esperienza.
- I dati di lancio decodificati non possono superare 200 bytes.
- Puoi archiviare dati più complessi come una stringa JSON e decodificarli con HttpService:JSONDecode() sul Server.
- Non inviare informazioni confidenziali nel parametro launchData; è completamente visibile nell'URL.Inoltre, gli utenti possono modificare l'URL, quindi i dati potrebbero non essere autentici.
Lista web all'applicazione
Questo formato invia gli utenti alla pagina dell'esperienza Roblox sul web e poi lancia l'applicazioneRoblox.L'esempio fornito fornisce un ID luogo e una Stringadi dati di lancio URL codificata.
| Formato | https://www.roblox.com/games/start?placeId=<id>&launchData=<string> |
| Esempio | Link di esempio |
Diretto all'applicazione
Questo formato invia gli utenti direttamente all'applicazioneRoblox. L'esempio fornito fornisce un ID luogo e una Stringadi dati di lancio URL codificata.
| Formato | roblox://placeId=<id>&launchData=<string> |
| Esempio | Link di esempio |
Ritardato
Per gli utenti che non hanno Roblox installato sui loro dispositivi mobili, utilizza la versione di AppsFlyer di un deep link per consentire agli utenti di scaricare l'app Roblox e quindi seguire il deep Callegare.Per costruire questo tipo di deep Callegare, specifica il prefisso https://ro.blox.com/Ebh5?.Fornisci il deep link "diretto all'applicazione" con il parametro af_dp e il deep link "elenco web all'applicazione" con il parametro af_web_dp, che sono descritti nelle sezioni precedenti.
| Formato | ro.blox.com/Ebh5?af_dp=<direct_to_app_link>&af_web_dp=<web_listing_to_app_link> |
| Esempio | ro.blox.com/Ebh5?af_dp=roblox%3A%2F%2FplaceId%3D6900305353%26launchData%3D%257B%2522roomId%2522%253A%25202%257D&af_web_dp=https%3A%2F%2Fwww.roblox.com%2Fgames%2Fstart%3FplaceId%3D6900305353%26launchData%3D%257B%2522roomId%2522%253A%25202%257D |
Elabora un Callegareprofondo
Nella tua esperienza, ottieni i dati di lancio con il metodo Player:GetJoinData(), che restituisce un dizionario.In quel dizionario, la chiave LaunchData contiene la stringa che hai specificato nel parametro launchData del tuo deep Callegare.
Vedi la documentazione di riferimento Player:GetJoinData() per esempi di codice su come elaborare i dati di lancio.