深いリンクを使用すると、ユーザーをエクスペリエンス内の特定の場所に送信できます。これにより、ユーザーが参加するプロセスをよりスムーズにすることができ、ユーザーが友達を見つけるのを助け、トラフィックのアトリビューションを提供できます。これらのリンク内のオプションの発売データを使用して、ユーザーエクスペリエンスをカスタマイズできます。
深いリンクを構築する
深いリンク URL は、指定したパラメータを含む URL 形式で構成されています。次のセクションでは、各形式を構築する方法を説明します。
要件とガイドライン
深いリンクを構築するときは、次の要件とガイドラインを考慮してください：
- 特殊な文字を URL エンコードしなければなりません。たとえば、スペース。これらの文字は、ユーザーがあなたのエクスペリエンスに参加すると自動的にデコードされます。
- デコードされたランチャデータは 200 バイトを超えることはできません。
- 複雑なデータをJSONストリングとして保存し、サーバー上で HttpService:JSONDecode() でデコードできます。
- launchData パラメータに機密情報を送信しないでください； URL で完全に表示されます。さらに、ユーザーは URL を変更できるため、データが正当でない可能性があります。
ウェブリストをアプリにリスト
このフォーマットは、ウェブ上の Roblox エクスペリエンスページにユーザーを送信し、Roblox アプリを起動します。提供された例には、場所IDと URL エンコードされたローンチデータストリング文字列あります。
| フォーマット | https://www.roblox.com/games/start?placeId=<id>&launchData=<string> |
| 例 | リンクの例 |
アプリに直接
この形式は、ユーザーを Roblox アプリに直接送信します。提供された例には、場所IDと URL エンコードされたローンチデータストリング文字列あります。
| フォーマット | roblox://placeId=<id>&launchData=<string> |
| 例 | リンクの例 |
遅延
Roblox をモバイルデバイスにインストールしていないユーザ紐づけるの場合は、深いリンクの AppsFlyer バージョンを使用して、ユーザーが Roblox アプリをダウンロードしてから、深いリンクをフ
| フォーマット | ro.blox.com/Ebh5?af_dp=<direct_to_app_link>&af_web_dp=<web_listing_to_app_link> |
| 例 | ro.blox.com/Ebh5?af_dp=roblox%3A%2F%2FplaceId%3D690030535 |
深いリンクを処理する
エクスペリエンスで、 Class.Player:GetJoinData() メソッドを使用して、LaunchData を返す、これは 1> リンク深度1> の 4>LaunchData4> キーを含みます。そのディクション内、 7>LaunchData7> キーには、深度リンクの Player:GetJoinData()0> パラメータの紐づける
Class.Player:GetJoinData() のコードサンプルについては、Class.Player:GetJoinData() の参照ドキュメントを参照してください。