Links profundos permitem enviar usuários para um local específico em uma experiência, o que pode tornar o processo de entrada mais suave, ajudar os usuários a encontrar seus amigos e fornecer atribuição de tráfego. Os dados de lançamento opcionais nesses links permitem personalizar a experiência do usuário quando alguém se juntar.
Construindo um Deep Link
Um URL de link profundo consiste em um formato de URL, juntamente com parâmetros que você especifica. As seções a seguir descrevem como construir cada formato.
Requisitos e Diretrizes
Ao construir links profundos, considere os seguintes requisitos e diretrizes:
- Você deve encodificar caracteres especiais, como espaços. Esses caracteres são automaticamente decodificados quando o usuário se juntar à sua experiência.
- Os dados de lançamento decodificados não podem exceder 200 bytes.
- Você pode armazenar dados mais complexos como uma string JSON e decodê-los com HttpService:JSONDecode() no servidor.
- Não envie informações confidenciais no parâmetro launchData, pois elas são totalmente visíveis na URL. Além disso, os usuários podem modificar a URL, para que os dados possam não ser autênticos.
Lista de Web para App
Este formato envia usuários para a página de experiência do Roblox na web e, em seguida, lança o aplicativo Roblox. O exemplo fornecido fornece um ID de local e uma string / cadeia / textode dados de lançamento codificada em URL.
| Formato | https://www.roblox.com/games/start?placeId=<id>&launchData=<string> |
| Ejemplo | Ejemplo de enlace |
Ir para o Aplicativo
Este formato envia usuários diretamente para o aplicativo Roblox. O exemplo fornecido fornece um ID de local e uma string / cadeia / textode dados de lançamento codificada em URL.
| Formato | roblox://placeId=<id>&launchData=<string> |
| Ejemplo | Ejemplo de enlace |
Adiado
Para usuários que não têm o Roblox instalado em seus dispositivos móveis, use a versão AppsFlyer de um link profundo para permitir que os usuários baixem o aplicativo Roblox e depois sigam o víncular / conectarprofundo. Para construir este tipo de víncular / conectarprofundo, especifique o
| 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 |
Processando um Deep Link
Na sua experiência, obtenha os dados de lançamento com o método Player:GetJoinData(), que retorna um dicionário. No dicionário, a chave LaunchData contém a string que você especificou no parâmetro 1> launchData1> do seu víncular / conectarprofundo.
Veja a referência de código Player:GetJoinData() para exemplos de código sobre como processar dados de lançamento.