Les liens profonds vous permettent d'envoyer des utilisateurs à un endroit spécifique dans un jeu, ce qui peut rendre le processus de connexion plus fluide, aider les utilisateurs à trouver leurs amis et fournir une attribution de trafic. Les données de lancement optionnelles dans ces liens vous permettent de personnaliser l'expérience utilisateur lorsque quelqu'un rejoint.
Ce processus est obsolète. Pour créer des liens profonds publics, utilisez les liens de partage.
Construire un lien profond
Une URL de lien profond consiste en un format d'URL accompagnée de paramètres que vous spécifiez. Les sections suivantes décrivent comment construire chaque format.
Paramètres d'URL
Les liens profonds prennent en charge les paramètres d'URL suivants. Tous sont facultatifs sauf mention contraire.
| Paramètre | Description |
|---|---|
| placeId | L'ID du lieu à rejoindre. Requis à moins que userId ne soit spécifié. |
| userId | L'ID de l'utilisateur à rejoindre. Cela entraîne une erreur "L'utilisateur suivi a quitté le jeu" si l'utilisateur a quitté le jeu ou est hors ligne. |
| accessCode | Le code d'accès au serveur privé. |
| linkCode | Le code de lien au serveur privé. |
| gameInstanceId | L'identifiant unique de l'instance de jeu à rejoindre, également appelé DataModel.JobId. |
| launchData | Informations supplémentaires que vous souhaitez inclure dans le lien profond, telles que des codes promotionnels ou des coordonnées. Traitez-le à l'aide de la méthode Player:GetJoinData(). Voir Inclure des données de lancement. |
Exigences et directives
- Vous devez encoder en URL les caractères spéciaux, tels que les espaces. Ces caractères sont automatiquement décodés lorsque l'utilisateur rejoint votre jeu.
- 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, donc les données pourraient ne pas être authentiques.
Liste web vers appli
Ce format envoie des utilisateurs à la page de jeu Roblox sur le web puis lance l'application Roblox. L'exemple fourni donne un ID de lieu et une chaîne de données de lancement encodée en URL.
| Format | https://www.roblox.com/games/start?placeId=<id>&launchData=<string> |
| Exemple | Lien d'exemple |
Direction vers l'appli
Ce format envoie directement les utilisateurs vers l'application Roblox. L'exemple fourni donne un ID de lieu et une chaîne de données de lancement encodée en URL.
| Format | roblox://placeId=<id>&launchData=<string> |
| Exemple | Lien d'exemple |
Différé
Pour les utilisateurs qui n'ont pas Roblox installé sur leurs appareils mobiles, utilisez la version AppsFlyer d'un lien profond pour permettre aux utilisateurs de télécharger l'application Roblox puis de suivre le lien profond. Pour construire ce type de lien profond, spécifiez le préfixe https://ro.blox.com/Ebh5?. Fournissez le lien profond "direct vers l'appli" avec le paramètre af_dp et le lien profond "liste web vers appli" 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 lien profond
Dans votre jeu, obtenez les données de lancement avec la méthode Player:GetJoinData(), qui retourne 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 lien profond.
Consultez la documentation de référence Player:GetJoinData() pour des exemples de code sur la façon de traiter les données de lancement.