Les liens profonds vous permettent d'envoyer les utilisateurs à un endroit spécifique dans une expérience, ce qui peut rendre le processus d'adhésion plus transparent, aider les utilisateurs à trouver leurs amis et fournir une attribution de trafic.Les données de lancement facultatives dans ces liens vous permettent de personnaliser l'expérience utilisateur lorsque quelqu'un rejoint.
Construire un lierprofond
Une URL de lien profond comprend un format d'URL ainsi que des paramètres que vous spécifiez. Les sections suivantes décrivent comment construire chaque format.
Paramètres d'URL
Les liens profonds supportent les paramètres URL suivants. Tous sont optionnels à moins qu'il n'en soit autrement noté.
Paramètre | Description :--- | :--- placeId | L'ID de lieu à rejoindre.Obligatoire à moins que userId ne soit spécifié.userId| L'ID d'utilisateur à rejoindre.Résultats dans une erreur « Suivi de l'utilisateur a quitté l'expérience » si l'utilisateur a quitté l'expérience ou est offline.accessCode | Le code d'accès au serveur privé.| Le code de lien du serveur privé.gameInstanceId | L'identifiant unique de l'instance de jeu à rejoindre, également appelé le DataModel.JobId.launchData | Informations supplémentaires que vous souhaitez inclure dans le lierprofond, telles que des codes promotionnels ou des coordonnées.Processus en utilisant la méthode Player:GetJoinData() .Voir Inclure les données de lancement .
Exigences et directives
- Vous devez encoder en URL des caractères spéciaux, tels que des espaces. Ces caractères sont automatiquement décodés lorsque l'utilisateur rejoint votre expérience.
- Les données de lancement décodées ne peuvent pas dépasser 200 octets.
- Vous pouvez stocker des données plus complexes sous forme de chaîne JSON et les décoder avec HttpService:JSONDecode() sur le serveur.
- Ne pas envoyer d'informations confidentielles dans le paramètre launchData ; elles sont entièrement visibles dans l'URL.De plus, les utilisateurs peuvent modifier l'URL, de sorte que les données peuvent ne pas être authentiques.
Liste Web à l'application
Ce format envoie les utilisateurs à la page d'expérience Roblox sur le web, puis lance l'application Roblox.L'exemple fourni fournit un identifiant de lieu et une chaîne de données de lancement codée en URL.
| Format | https://www.roblox.com/games/start?placeId=<id>&launchData=<string> |
| Exemple | Lien d'exemple |
Directement à l'application
Ce format envoie les utilisateurs directement à l'application Roblox. L'exemple fourni fournit une ID de lieu et une chaîne de données de lancement codée en URL.
| Format | roblox://placeId=<id>&launchData=<string> |
| Exemple | Lien d'exemple |
Reporté
Pour les utilisateurs qui n'ont pas Roblox installé sur leurs appareils mobiles, utilisez la version d'AppsFlyer d'un lien profond pour permettre aux utilisateurs de télécharger l'application Roblox puis de suivre le lierprofond.Pour construire ce type de lien lier, spécifiez le préfixe https://ro.blox.com/Ebh5?.Fournir le lien de profondeur "direct à l'application" avec le paramètre af_dp et le lien de profondeur "liste Web à l'application" avec le paramètre af_web_dp, qui sont décrits dans les sections précédentes.
| Format | ro.blox.com/Ebh5?af_dp=<direct_to_app_link>&af_web_dp=<web_listing_to_app_link> |
| Exemple | 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 |
Traiter un lierprofond
Dans votre expérience, obtenez les données de lancement avec la méthode Player:GetJoinData(), qui renvoie un dictionnaire.Dans ce dictionnaire, la clé LaunchData contient la chaîne que vous avez spécifiée dans le paramètre launchData de votre lierprofond.
Voir la documentation de référence Player:GetJoinData() pour des échantillons de code sur la façon de traiter les données de lancement.