I deep link ti consentono di inviare utenti a un luogo specifico in un gioco, il che può rendere il processo di accesso più fluido, aiutare gli utenti a trovare i propri amici e fornire attribuzione del traffico. I dati di avvio opzionali in questi link ti consentono di personalizzare l'esperienza dell'utente quando qualcuno si unisce.
Questo processo è deprecato. Per creare deep link pubblici, utilizza i link di condivisione.
Costruire un deep link
Un URL di deep link consiste in un formato di URL insieme ai parametri che specifichi. Le sezioni seguenti descrivono come costruire ciascun formato.
Parametri URL
I deep link supportano i seguenti parametri URL. Tutti sono facoltativi, salvo diversa indicazione.
| Parametro | Descrizione |
|---|---|
| placeId | L'ID del posto da unire. Richiesto a meno che non venga specificato userId. |
| userId | L'ID utente da unire. Risulta in un errore "L'utente seguito ha lasciato il gioco" se l'utente ha lasciato il gioco o è offline. |
| accessCode | Il codice di accesso del server privato. |
| linkCode | Il codice di collegamento del server privato. |
| gameInstanceId | L'identificatore unico dell'istanza di gioco a cui unirsi, chiamato anche DataModel.JobId. |
| launchData | Ulteriori informazioni che desideri includere nel deep link, come codici promozionali o coordinate. Elaborati utilizzando il metodo Player:GetJoinData(). Vedi Includere dati di avvio. |
Requisiti e linee guida
- Devi codificare in URL i caratteri speciali, come gli spazi. Questi caratteri vengono decodificati automaticamente quando l'utente si unisce al tuo gioco.
- I dati di avvio decodificati non possono superare i 200 byte.
- Puoi memorizzare dati più complessi come una stringa JSON e decodificarli con HttpService:JSONDecode() sul server.
- Non inviare informazioni riservate nel parametro launchData; sono completamente visibili nell'URL. Inoltre, gli utenti possono modificare l'URL, quindi i dati potrebbero non essere autentici.
Elenco web all'app
Questo formato invia gli utenti alla pagina del gioco Roblox sul web e poi avvia l'app Roblox. L'esempio fornito fornisce un ID del posto e una stringa di dati di avvio codificata in URL.
| Formato | https://www.roblox.com/games/start?placeId=<id>&launchData=<string> |
| Esempio | Link di esempio |
Diretto all'app
Questo formato invia direttamente gli utenti all'app Roblox. L'esempio fornito fornisce un ID del posto e una stringa di dati di avvio codificata in URL.
| Formato | roblox://placeId=<id>&launchData=<string> |
| Esempio | Link di esempio |
Rinviato
Per gli utenti che non hanno Roblox installato sui propri dispositivi mobili, utilizza la versione AppsFlyer di un deep link per consentire agli utenti di scaricare l'app Roblox e poi seguire il deep link. Per costruire questo tipo di deep link, specifica il prefisso https://ro.blox.com/Ebh5?. Fornisci il deep link "diretto all'app" con il parametro af_dp e il deep link "elenco web all'app" 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 |
Elaborare un deep link
Nel tuo gioco, ottieni i dati di avvio 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 link.
Vedi la documentazione di riferimento Player:GetJoinData() per esempi di codice su come elaborare i dati di avvio.