Derin bağlantılar, kullanıcıları bir deneyimde belirli bir yere göndermenizi sağlar, bu da katılma sürecini daha verimli hale getirebilir, kullanıcıların arkadaşlarını bulmalarına yardımcı olur ve trafik atfedilmesini sağlar.Bu bağlantılardaki opcional başlatma verileri, birisi katıldığında kullanıcı deneyimini özelleştirmenizi sağlar.
Derin bir bağlaoluşturun
Derin bağlantı URL'si, belirttiğiniz parametlerle birlikte bir URL formatundan oluşur. Aşağıdaki bölümler, her formatın nasıl oluşturulacağını açıklar.
URL değerleri
Derin bağlantılar aşağıdaki URL parametlerini destekler. Aksi belirtilmediği sürece hepsi isteğe bağlıdır.
Parametre | Açıklama :--- | :--- placeId | Katılınacak yer kimliği.Gerekli değil, userId belirtilmediği sürece.userId | Katılacak kullanıcı kimliği.Kullanıcı deneyden ayrıldıysa veya çevrimdışıysa "Takip edilen kullanıcı deneyden ayrıldı" hatası sonuçları verir.accessCode | Özel sunucu erişim kodu. linkCode | Özel sunucu bağlantı kodu.gameInstanceId | Katılınacak oyun örneğinin benzersiz tanımlayıcısı, ayrıca DataModel.JobId olarak adlandırılır. launchData | Derin bağlantıya dahil etmek istediğiniz ek bilgiler, örneğin promosyon kodları veya koordinatlar.Player:GetJoinData() yöntemi kullanarak süreç işlemi.Bakın Başlatma verilerini dahil et.
Gereksinimler ve yönergeler
- Boşluklar gibi özel karakterleri URL'ye kodlamalısınız. Bu karakterler, kullanıcı deneyiminize katıldığında otomatik olarak çözülür.
- Şifrelenmiş başlatma verilerinin 200 bayttan fazla olmasına izin verilemez.
- Daha karmaşık verileri bir JSON dize olarak depolayabilir ve sunucuda HttpService:JSONDecode() ile çözülebilir.
- Gizli bilgileri launchData parametresine göndermeyin; URL'de tamamen görülebilir.Ayrıca, kullanıcılar URL'yi değiştirebilir, bu nedenle veriler doğru olmayabilir.
Uygulamaya web listesi
Bu format, kullanıcıları web'deki Roblox deneyim sayfasına gönderir ve ardından Roblox uygulamasını başlatır.Verilen örnek bir yer kimliği ve URL kodlanmış başlatma veri dizisağlar.
| Biçim | https://www.roblox.com/games/start?placeId=<id>&launchData=<string> |
| Örnek | Örnek Bağlantı |
Uygulamaya uygulama
Bu format, kullanıcıları doğrudan Roblox uygulamasına gönderir. Verilen örnek bir yer kimliği ve URL kodlanmış başlatma veri dizisağlar.
| Biçim | roblox://placeId=<id>&launchData=<string> |
| Örnek | Örnek Bağlantı |
Erteleme
Mobil cihazlarında Roblox'un yüklü olmadığı kullanıcılar için, kullanıcıların Roblox uygulamasını indirmesine ve ardından derin bağlantıyı takip etmesine izin vermek için AppsFlyer versiyonu derin bağlantı kullanın.Bu tür derin bağlantıyı oluşturmak için, https://ro.blox.com/Ebh5? ön ekini belirtin.Önceki bölümlerde açıklanan "uyygulamaya doğrudan bağlantı" derin bağlantısını ve "uyygulamaya web listeleme" derin bağlantısını af_dp ve af_web_dp parametreleriyle sağlayın.
| Biçim | ro.blox.com/Ebh5?af_dp=<direct_to_app_link>&af_web_dp=<web_listing_to_app_link> |
| Örnek | 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 |
Derin bir bağlantı işle
Deneyiminizde, başlatma verilerini Player:GetJoinData() yöntemi ile alın, ki bu bir sözlük döndürür.Bu sözlükte, LaunchData anahtarı, derin bağlantınızın launchData parametresinde belirttiğiniz dizeyi içerir.
Başlatma verilerinin işlenmesiyle ilgili kod örnekleri için Player:GetJoinData() referans dokümanına bakın.