Los enlaces profundos te permiten enviar a los usuarios a un lugar específico en una experiencia, lo que puede hacer que el proceso de unión sea más fluido, ayudar a los usuarios a encontrar sus amigos y proporcionar atribución de tráfico. Los datos de lanzamiento opcionales en estos enlaces te permiten personalizar la experiencia del usuario cuando alguien se une.
Construyendo un enlace profundo
Un enlace profundo URL consiste en un formato de URL junto con parámetros que especifica. Las siguientes secciones describen cómo construir cada formato.
Requisitos y directrices
Al construir enlaces profundos, considere los siguientes requisitos y guías:
- Debes encodar caracteres especiales, como espacios. Estos caracteres se decodifican automáticamente cuando el usuario se une a tu experiencia.
- Los datos de lanzamiento descompuestos no pueden exceder los 200 bytes.
- Puedes almacenar datos más complejos como una cadena JSON y descompilarlo con HttpService:JSONDecode() en el servidor.
- No envíe información confidencial en el parámetro launchData; se muestra completamente en la URL. Además, los usuarios pueden modificar la URL, por lo que los datos pueden no ser auténticos.
Listado web para la aplicación
Este formato envía a los usuarios a la página de experiencia de Roblox en el sitio web y luego lanzar el servicio de aplicaciones de Roblox. El ejemplo proporcionado proporciona un ID de lugar y una cadena de datos de lanzamiento codificada en URL.
| Formato | https://www.roblox.com/games/start?placeId=<id>&launchData=<string> |
| Ejemplo | Ejemplo de enlace |
Enlace a la aplicación
Este formato envía a los usuarios directamente a la aplicación (app)Roblox. El ejemplo proporcionado proporciona un ID de lugar y una cadena de datos de lanzamiento codificada.
| Formato | roblox://placeId=<id>&launchData=<string> |
| Ejemplo | Ejemplo de enlace |
Aplazado
Para los usuarios que no tienen Roblox instalado en sus dispositivos móviles, use la versión AppsFlyer de un enlace profundo para permitir que los usuarios descarguen la aplicación Roblox y luego sigan el enlace enlazar. Para construir este tipo de enlazarprofundo, especifique el https://
| Formato | ro.blox.com/Ebh5?af_dp=<direct_to_app_link>&af_web_dp=<web_listing_to_app_link> |
| Ejemplo | ro.blox.com/Ebh5?af_dp=roblox%3A%2F%2FplaceId%3D6900305353 |
Procesando un enlace profundo
En tu experiencia, obtén los datos de lanzamiento con el método Player:GetJoinData() , que devuelve un diccionario . En ese diccionario, la llave LaunchData contiene la cadena que especificaste en el parámetro 1> launchData1> de tu enlazarprofundo.
Vea la referencia de la documentación de Player:GetJoinData() para obtener ejemplos de código sobre cómo procesar los datos de lanzamiento.