Los enlaces profundos te permiten enviar usuarios a un lugar específico en un juego, lo que puede hacer que el proceso de unirse sea más fluido, ayudar a los usuarios a encontrar a 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.
Este proceso está en desuso. Para crear enlaces profundos públicos, utiliza enlaces para compartir.
Construir un enlace profundo
Una URL de enlace profundo consiste en un formato de URL junto con parámetros que especificas. Las siguientes secciones describen cómo construir cada formato.
Parámetros de URL
Los enlaces profundos soportan los siguientes parámetros de URL. Todos son opcionales a menos que se indique lo contrario.
| Parámetro | Descripción |
|---|---|
| placeId | El ID del lugar al que unirse. Requerido a menos que se especifique userId. |
| userId | El ID del usuario al que unirse. Resulta en un error de "El usuario seguido ha salido del juego" si el usuario dejó el juego o está desconectado. |
| accessCode | El código de acceso del servidor privado. |
| linkCode | El código de enlace del servidor privado. |
| gameInstanceId | El identificador único de la instancia del juego a la que unirse, también llamado DataModel.JobId. |
| launchData | Información adicional que deseas incluir dentro del enlace profundo, como códigos promocionales o coordenadas. Procesar usando el método Player:GetJoinData(). Ver Incluir datos de lanzamiento. |
Requisitos y pautas
- Debes codificar en URL los caracteres especiales, como los espacios. Estos caracteres son decodificados automáticamente cuando el usuario se une a tu juego.
- Los datos de lanzamiento decodificados no pueden exceder 200 bytes.
- Puedes almacenar datos más complejos como una cadena JSON y decodificarlo con HttpService:JSONDecode() en el servidor.
- No envíes información confidencial en el parámetro launchData; es completamente visible en la URL. Además, los usuarios pueden modificar la URL, por lo que los datos pueden no ser auténticos.
Lista web a app
Este formato envía a los usuarios a la página del juego de Roblox en la web y luego lanza la aplicación de Roblox. El ejemplo proporcionado incluye 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 | Enlace de Ejemplo |
Directo a app
Este formato envía a los usuarios directamente a la aplicación de Roblox. El ejemplo proporcionado incluye un ID de lugar y una cadena de datos de lanzamiento codificada en URL.
| Formato | roblox://placeId=<id>&launchData=<string> |
| Ejemplo | Enlace de Ejemplo |
Diferido
Para usuarios que no tienen Roblox instalado en sus dispositivos móviles, utiliza la versión de AppsFlyer de un enlace profundo para permitir que los usuarios descarguen la aplicación de Roblox y luego sigan el enlace profundo. Para construir este tipo de enlace profundo, especifica el prefijo https://ro.blox.com/Ebh5?. Proporciona el enlace profundo "directo a app" con el parámetro af_dp y el enlace profundo "de lista web a app" con el parámetro af_web_dp, que se describen en las secciones anteriores.
| 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%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 |
Procesar un enlace profundo
En tu juego, obtén los datos de lanzamiento con el método Player:GetJoinData() que devuelve un diccionario. En ese diccionario, la clave LaunchData contiene la cadena que especificaste en el parámetro launchData de tu enlace profundo.
Consulta la documentación de referencia de Player:GetJoinData() para ver ejemplos de código sobre cómo procesar los datos de lanzamiento.