ディープリンクでは、ユーザーをエクスペリエンスの特定の場所に送ることができ、プロセスの参加がよりスムーズになり、ユーザーが友達を見つけ、トラフィックの属性を提供できます。これらのリンクのオプションの発進データでは、誰かが参加するときにユーザーエクスペリエンスをカスタマイズできます。
深紐づけるリンクを構築する
深いリンク URL は、指定したパラメータとともに URL 形式で構成されます。次のセクションでは、各形式を構築する方法を説明します。
URLパラメータ
深いリンクは次の URL パラメータをサポートします。すべて、別に指定がない限り、オプションです。
パラメータ | 説明 :--- | :--- placeId | 参加する場所のID。userId が指定されていない場合は必須です。 userId | 参加するユーザーID。ユーザーがエクスペリエンスを終了した、またはオフラインになった場合、「フォローユーザーがエクスペリエンスを終了しました」エラーが発生します。 accessCode | プライベートサーバーアクセスコード。linkCode | プライベートサーバーリンクコード。 gameInstanceId | 参加するゲームインスタンスのユニークな識別子、通称 DataModel.JobId 。 launchData | プロモーションコードや座標など、深いリンク内に含めたい追加情報。Player:GetJoinData() メソッドを使用したプロセス。参照してください 発進データを含める。
要件とガイドライン
- スペースなどの特殊文字は 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 アプリをダウンロードし、その後ディープリンクに従わせます。この種類の深いリンクを構築するには、https://ro.blox.com/Ebh5? プレフィックスを指定します。前のセクショ紐づけるで説明されている af_dp パラメータと af_web_dp パラメータで、「アプリへの直接リンク」深リンクと「ウェブリストへのアプリへのリンク」深リンクを提供します。
形式 | 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%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 |
深いリンクを処理す紐づける
あなたの経験では、Player:GetJoinData() メソッドで発進データを取得し、辞書 を返す。その辞書では、LaunchData キーには、深いリンクのパラメータ launchData で指定した文紐づける列が含まれています。
起動データを処理する方法に関するコードサンプルの参照文書は、Player:GetJoinData() を参照してください。