Các liên kết sâu cho phép bạn gửi người dùng đến một địa điểm cụ thể trong trải nghiệm, có thể làm cho quá trình tham gia trở nên mượt hơn, giúp người dùng tìm thấy bạn bè của họ và cung cấp phân bổ lưu lượng.Dữ liệu phát hành tùy chọn trong các liên kết này cho phép bạn tùy chỉnh trải nghiệm người dùng khi ai đó tham gia.
Xây dựng một liên kết sâu
Một URL liên kết sâu bao gồm một định dạng URL cùng với các tham số mà bạn xác định. Các phần tiếp theo mô tả cách xây dựng mỗi định dạng.
Tham số URL
Các liên kết sâu hỗ trợ các tham số URL sau. Tất cả đều tùy chọn trừ khi có ghi chú khác.
Tham số | Mô tả :--- | :--- placeId | ID địa điểm để tham gia.Yêu cầu trừ khi userId được định nghĩa.userId | ID người dùng để tham gia.Kết quả trong lỗi "Người dùng đã theo dõi đã rời khỏi trải nghiệm" nếu người dùng rời khỏi trải nghiệm hoặc ngoại tuyến.| Mã truy cập máy chủ riêng.| Các mã liên kết máy chủ riêng tư. gameInstanceId | Nhận dạng duy nhất của instânce trò chơi để tham gia, cũng được gọi là DataModel.JobId. launchData | Thông tin bổ sung bạn muốn bao gồm trong liên kết sâu, chẳng hạn như mã khuyến mãi hoặc điểm đến.Xử lý bằng cách sử dụng phương pháp Player:GetJoinData().Xem Bao gồm dữ liệu khởi chạy .
Yêu cầu và hướng dẫn
- Bạn phải mã hóa URL các ký tự đặc biệt, như khoảng trống. Những ký tự này được giải mã tự động khi người dùng tham gia trải nghiệm của bạn.
- Dữ liệu khởi chạy giải mã không thể vượt quá 200 bayt.
- Bạn có thể lưu trữ dữ liệu phức tạp hơn dưới dạng một chuỗi JSON và giải mã nó với HttpService:JSONDecode() trên máy chủ.
- Không gửi thông tin mật trong tham số launchData; nó hoàn toàn hiển thị trong URL.Ngoài ra, người dùng có thể thay đổi URL, do đó dữ liệu có thể không được xác thực.
Danh sách web sang ứng dụng
Định dạng này gửi người dùng đến trang trải nghiệm Roblox trên web và sau đó khởi động ứng dụng Roblox.Ví dụ được cung cấp cung cấp một ID địa điểm và một chuỗi dữ liệu khởi chạy được mã hóa bằng URL.
| Định dạng | https://www.roblox.com/games/start?placeId=<id>&launchData=<string> |
| Ví dụ | Ví dụ liên kết |
Trực tiếp đến ứng dụng
Định dạng này gửi người dùng trực tiếp đến ứng dụng Roblox. Ví dụ cung cấp cung cấp một ID nơi và một chuỗi dữ liệu khởi động được mã hóa bằng URL.
| Định dạng | roblox://placeId=<id>&launchData=<string> |
| Ví dụ | Ví dụ liên kết |
Bị trì hoãn
Đối với người dùng không có Roblox được cài đặt trên thiết bị di động của họ, sử dụng phiên bản AppsFlyer của một liên kết sâu để cho phép người dùng tải xuống ứng dụng Roblox và sau đó theo dõi liên kết sâu.Để xây dựng loại liên kết sâu này, hãy xác định tiền tố https://ro.blox.com/Ebh5? .Cung cấp liên kết sâu "trực tiếp đến ứng dụng" với tham số af_dp và liên kết sâu "danh sách web đến ứng dụng" với tham số af_web_dp, được mô tả trong các phần trước.
| Định dạng | ro.blox.com/Ebh5?af_dp=<direct_to_app_link>&af_web_dp=<web_listing_to_app_link> |
| Ví dụ | 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 |
Xử lý một liên kết sâu
Trong trải nghiệm của bạn, lấy dữ liệu khởi động với phương pháp Player:GetJoinData(), trả về một từ điển.Trong bản từ điển đó, chìa khóa LaunchData bao gồm chuỗi mà bạn đã đặc trưng trong tham số launchData của liên kết sâu của bạn.
Xem tài liệu tham khảo Player:GetJoinData() để có được các mẫu mã lệnh về cách xử lý dữ liệu khởi động.