Links profundos permitem que você envie usuários para um local específico em uma experiência, o que pode tornar o processo de adesão mais suave, ajudar os usuários a encontrarem 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 se juntar.
Construir um víncular / conectarprofundo
Um URL de ligação profunda consiste em um formato de URL, juntamente com parâmetros que você especifica. As seções a seguir descrevem como construir cada formato.
Parâmetros de URL
Links profundos suportam os seguintes parâmetros de URL. Todos são opcionais, a menos que seja observado de outra forma.
Parâmetro | Descrição :--- | :--- placeId | O ID do local para se juntar.Requerido a menos que userId seja especificado. userId | O ID do usuário para se juntar.Resulta em um erro "Seguido usuário deixou a experiência" se o usuário deixou a experiência ou está desconetado / offline.accessCode | O código de acesso ao servidor privado. linkCode | O código de link do servidor particular. gameInstanceId | O identificador exclusivo da instância do jogo para se juntar, também chamado de DataModel.JobId. launchData | Informação adicional que você deseja incluir dentro do víncular / conectarprofundo, 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 URL caracteres especiais, como espaços. Esses caracteres são decodificados automaticamente quando o usuário se junta à 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 decodificá-los com HttpService:JSONDecode() no servidor.
- Não envie informações confidenciais no parâmetro launchData ; ela é totalmente visível na URL.Além disso, os usuários podem modificar o URL, então os dados podem não ser autênticos.
Lista da web para o aplicativo
Este formato envia os 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.
| Padrão | https://www.roblox.com/games/start?placeId=<id>&launchData=<string> |
| Exemplo | Exemplo de Link |
Direto para o aplicativo
Este formato envia os 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.
| Padrão | roblox://placeId=<id>&launchData=<string> |
| Exemplo | Exemplo de Link |
Diferido
Para usuários que não têm o Roblox instalado em seus dispositivos móveis, use a versão do 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 prefixo https://ro.blox.com/Ebh5?.Forneça o link de profundidade "direto para o aplicativo" com o parâmetro af_dp e o link de profundidade "listagem da web para o aplicativo" com o parâmetro af_web_dp, que são descritos nas seções anteriores.
| Padrão | 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 víncular / conectarprofundo
Na sua experiência, obtenha os dados de lançamento com o método , que retorna um dicionário .Nesse dicionário, a chave LaunchData contém a string que você especificou no parâmetro launchData do seu víncular / conectarprofundo.
Veja a Player:GetJoinData() para amostras de código sobre como processar dados de lançamento.