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 fluide, 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 de l'utilisateur lorsque quelqu'un rejoint.
Construction d'un lien profond
Une URL de lien profond contient un format URL ainsi que des paramètres que vous spécifiez. Les sections suivantes décrivent comment construire chaque format.
Exigences et lignes directrices
Lors de la construction de liens profonds, tenez compte des exigences et des lignes directrices suivantes :
- Vous devez encodifier des caractères spéciaux, tels que les espaces. Ces caractères sont automatiquement déchiffré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 en tant que chaîne JSON et le décodez avec HttpService:JSONDecode() sur le serveur.
- Ne envoyez pas d'informations confidentielles dans le launchData paramètre ; il est entièrement visible dans l'URL. De plus, les utilisateurs peuvent modifier l'URL, afin que les données ne soient pas authentiques.
Liste Web à l'application
Ce format envoie les utilisateurs sur la page d'expérience Roblox sur le web et lance ensuite le appRoblox. L'exemple fourni fournit un ID de lieu et une chaîne de données d'url encodée.
| Format | https://www.roblox.com/games/start?placeId=<id>&launchData=<string> |
| Exemple | Exemple de lien |
Aller à l'application
Ce format envoie les utilisateurs directement à l'application Roblox. L'exemple fourni fournit un ID de lieu et une chaîne de données de lancement encodée.
| Format | roblox://placeId=<id>&launchData=<string> |
| Exemple | Exemple de lien |
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 et puis de suivre le lierprofond. Pour construire ce type de lierprofond, spécifiez le https
| 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 |
Traiter un lien profond
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 1> launchData1> paramètre de votre lierprofond.
Voir la référence de données de classe Player:GetJoinData() pour les échantillons de code sur la façon de traiter les données de lancement.