Głębkie linki pozwalają wysyłać użytkowników do określonego miejsca w doświadczeniu, które może ułatwić proces dołączania, pomóc użytkownikom znaleźć znajomych i zapewnić przypisanie ruchu.Opcjonalne dane o uruchomieniu w tych linkach pozwalają dostosować doświadczenie użytkownika, gdy ktoś dołączy.
Stwórz głębkie łączyć
Głębki link URL składa się z formatu URL wraz z parametrami, które określasz. Poniższe sekcje opisują, jak konstruować każdy format.
Parametry URL
Głębokie linki wspierają następujące parametry URL. Wszystkie są opcjonalne, chyba że inaczej zaznaczono.
Parametr | Opis: --- | :--- placeId | ID miejsca dołączenia.Wymagane, chyba że userId zostanie określone.userId | ID użytkownika dołączającego.Wyniki w błędzie "Obserwowany użytkownik opuścił doświadczenie" jeśli użytkownik opuścił doświadczenie lub jest offline.accessCode | Prywatny kod dostępu do serwera.linkCode | Kod linku prywatnego serwera.gameInstanceId | Unikalny identyfikator instancji gry dołączającej, również nazywany DataModel.JobId.launchData | Dodatkowe informacje, które chcesz uwzględnić w głębokim łączyć, takie jak kody promocyjne lub koordynaty.Proces korzystający z metody Player:GetJoinData().Zobacz Uwzględnij dane o uruchomieniu.
Wymagania i wytyczne
- Musisz kodować URL specjalne znaki, takie jak spacje. Te znaki są automatycznie dekodowane, gdy użytkownik dołącza do twojego doświadczenia.
- Zdekodowane dane uruchamiania nie mogą przekroczyć 200 bajtów.
- Możesz przechowywać bardziej złożone dane jako ciąg JSON i dekodować je za pomocą HttpService:JSONDecode() na serwerze.
- Nie wysyłaj poufnych informacji w parametrze launchData ; są one w pełni widoczne w URL.Ponadto użytkownicy mogą modyfikować URL, więc dane mogą nie być autentyczne.
Lista sieciowa do aplikacja
Ten format wysyła użytkowników na stronę doświadczenia Roblox w sieci, a następnie uruchamia aplikacjaRoblox.Podane przykłady zapewniają identyfikator miejsca i stronę URL, zaszyfrowaną ciągdanych o uruchomieniu.
| Formatowanie | https://www.roblox.com/games/start?placeId=<id>&launchData=<string> |
| Przykład | Przykładowy link |
Bezpośrednio do aplikacja
Ten format wysyła użytkowników bezpośrednio do aplikacjaRoblox. Podany przykład dostarcza identyfikator miejsca i stronę URL z ciąguruchomienia.
| Formatowanie | roblox://placeId=<id>&launchData=<string> |
| Przykład | Przykładowy link |
Odłożone
Dla użytkowników, których nie ma Roblox zainstalowanego na ich urządzeniach mobilnych, użyj wersji AppsFlyer głębkiego linku, aby użytkownicy pobrali aplikację Roblox, a następnie podążali za głębkim łączyć.Aby skonstruować ten typ głębkiego łączyć, określ prefiks https://ro.blox.com/Ebh5?.Zapewnij głębokie linki "direct to aplikacja" z parametrem af_dp i "web listing to aplikacja" z parametrem af_web_dp, które opisano w poprzednich sekcjach.
| Formatowanie | ro.blox.com/Ebh5?af_dp=<direct_to_app_link>&af_web_dp=<web_listing_to_app_link> |
| Przykład | 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 |
Przetwarzanie głębkiego łączyć
W swoim doświadczeniu uzyskaj dane o uruchomieniu za pomocą metody , która zwraca słownik .W tej słowniku klucz LaunchData zawiera ciąg, który określiłeś w parametrze launchData twojego głębokiego łączyć.
Zobacz dokumentację odniesienia Player:GetJoinData() dotyczącą próbek kodu na temat sposobu przetwarzania danych o uruchomieniu.