深いリンク

*このコンテンツは、ベータ版のAI(人工知能)を使用して翻訳されており、エラーが含まれている可能性があります。このページを英語で表示するには、 こちら をクリックしてください。

ディープリンクでは、ユーザーをエクスペリエンスの特定の場所に送ることができ、プロセスの参加がよりスムーズになり、ユーザーが友達を見つけ、トラフィックの属性を提供できます。これらのリンクのオプションの発進データでは、誰かが参加するときにユーザーエクスペリエンスをカスタマイズできます。

深紐づけるリンクを構築する

深いリンク URL は、指定したパラメータとともに URL 形式で構成されます。次のセクションでは、各形式を構築する方法を説明します。

URLパラメータ

深いリンクは次の URL パラメータをサポートします。すべて、別に指定がない限り、オプションです。

パラメータ | 説明 :--- | :--- placeId | 参加する場所のID。userId が指定されていない場合は必須です。 userId | 参加するユーザーID。ユーザーがエクスペリエンスを終了した、またはオフラインになった場合、「フォローユーザーがエクスペリエンスを終了しました」エラーが発生します。 accessCode | プライベートサーバーアクセスコード。linkCode | プライベートサーバーリンクコード。 gameInstanceId | 参加するゲームインスタンスのユニークな識別子、通称 DataModel.JobIdlaunchData | プロモーションコードや座標など、深いリンク内に含めたい追加情報。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() を参照してください。