Links profundos permitem que você envie usuários para um lugar específico em um jogo, o que pode tornar o processo de entrada mais fácil, ajudar os usuários a encontrar seus amigos e fornecer atribuição de tráfego. Os dados de lançamento opcionais nesses links permitem que você personalize a experiência do usuário quando alguém entra.
Esse processo está obsoleto. Para criar links profundos públicos, use links de compartilhamento.
Construir um link profundo
Uma URL de link profundo consiste em um formato de URL junto com parâmetros que você especifica. As seções a seguir descrevem como construir cada formato.
Parâmetros da URL
Links profundos suportam os seguintes parâmetros de URL. Todos são opcionais, a menos que indicado de outra forma.
| Parâmetro | Descrição |
|---|---|
| placeId | O ID do lugar a ser acessado. Necessário a menos que userId seja especificado. |
| userId | O ID do usuário a ser acessado. Resulta em um erro "Usuário seguido saiu do jogo" se o usuário saiu do jogo ou está offline. |
| accessCode | O código de acesso ao servidor privado. |
| linkCode | O código de link do servidor privado. |
| gameInstanceId | O identificador exclusivo da instância do jogo a ser acessada, também chamado de DataModel.JobId. |
| launchData | Informações adicionais que você deseja incluir no link profundo, como códigos promocionais ou coordenadas. Processar usando o método Player:GetJoinData(). Veja Incluir dados de lançamento. |
Requisitos e diretrizes
- Você deve codificar em URL caracteres especiais, como espaços. Esses caracteres são decodificados automaticamente quando o usuário entra no seu jogo.
- Os dados de lançamento decodificados não podem exceder 200 bytes.
- Você pode armazenar dados mais complexos como uma string JSON e decodificá-los com HttpService:JSONDecode() no servidor.
- Não envie informações confidenciais no parâmetro launchData; elas são totalmente visíveis na URL. Além disso, os usuários podem modificar a URL, então os dados podem não ser autênticos.
Lista da web para aplicativo
Esse formato envia usuários para a página do jogo Roblox na web e então inicia o aplicativo Roblox. O exemplo fornecido contém um ID de lugar e uma string de dados de lançamento codificada em URL.
| Formato | https://www.roblox.com/games/start?placeId=<id>&launchData=<string> |
| Exemplo | Link de Exemplo |
Direto para o aplicativo
Esse formato envia usuários diretamente para o aplicativo Roblox. O exemplo fornecido contém um ID de lugar e uma string de dados de lançamento codificada em URL.
| Formato | roblox://placeId=<id>&launchData=<string> |
| Exemplo | Link de Exemplo |
Diferido
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 então sigam o link profundo. Para construir esse tipo de link profundo, especifique o https://ro.blox.com/Ebh5? prefix. Forneça o link profundo "direto para o aplicativo" com o parâmetro af_dp e o link profundo "lista da web para o aplicativo" com o parâmetro af_web_dp, que são descritos nas seções anteriores.
| Formato | ro.blox.com/Ebh5?af_dp=<direct_to_app_link>&af_web_dp=<web_listing_to_app_link> |
| Exemplo | 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 |
Processar um link profundo
No seu jogo, obtenha os dados de lançamento com o método Player:GetJoinData(), que retorna um dicionário. Nesse dicionário, a chave LaunchData contém a string que você especificou no parâmetro launchData do seu link profundo.
Veja a documentação de referência de Player:GetJoinData() para exemplos de código sobre como processar os dados de lançamento.