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 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 de usuario cuando alguien se una.
Construir un enlazarprofundo
Una URL de enlace profundo consiste en un formato de URL junto con parámetros que especifiques. Las siguientes secciones describen cómo construir cada formato.
Parámetros de URL
Los enlaces profundos admiten 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 para unirse.Requerido a menos que se especifique userId. userId | La ID de usuario para unirse.Resulta en un error "El usuario seguido ha dejado la experiencia" si el usuario dejó la experiencia o está sin conexión.accessCode | El código de acceso privado al server.linkCode | El código de enlace del servidor privado gameInstanceId | El identificador único de la instancia del juego para unirse, también llamado DataModel.JobId. launchData | Información adicional que quieres incluir dentro del enlazarprofundo, como códigos promocionales o coordenadas.Proceso que utiliza el método Player:GetJoinData().Vea Incluir datos de lanzamiento .
Requisitos y directrices
- Debes codificar URL caracteres especiales, como espacios. Estos caracteres se decodifican automáticamente cuando el usuario se une a tu experiencia.
- Los datos de lanzamiento decodificados no pueden exceder 200 bytes.
- Puedes almacenar datos más complejos como una cadena JSON y decodificarlos con HttpService:JSONDecode() en el servidor.
- No envíe información confidencial en el parámetro launchData; está 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 aplicación (app)
Este formato envía a los usuarios a la página de experiencia de Roblox en la web y luego lanza la aplicación (app)de Roblox.El ejemplo proporcionado proporciona una identificación 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 la aplicación (app)
Este formato envía a los usuarios directamente a la aplicación (app)de Roblox. El ejemplo proporcionado proporciona una identificación de lugar y una cadena de datos de lanzamiento codificada en URL.
| Formato | roblox://placeId=<id>&launchData=<string> |
| Ejemplo | Enlace de ejemplo |
Aplazado
Para los usuarios que no tienen Roblox instalado en sus dispositivos móviles, use 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 enlazar.Para construir este tipo de enlace enlazar, especifique el prefijo https://ro.blox.com/Ebh5?.Proporcione el enlace profundo "directo a la aplicación (app)" con el parámetro af_dp y el enlace profundo "listado web a la aplicación (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 enlazar
En tu experiencia, obtén los datos de lanzamiento con el método , que devuelve un diccionario .En ese diccionario, la clave LaunchData contiene la cadena que especificaste en el parámetro launchData de tu enlazarprofundo.
Vea la documentación de referencia Player:GetJoinData() para muestras de código sobre cómo procesar los datos de lanzamiento.