ゲームからウェブショップを開く
認証されたプレイヤー セッションでゲームがWebショップを開く方法と、プレイヤーの認証方法を理解します。
読み終わるまでの所要時間 3 分最終更新 8日前
Webshop は Unity ゲームコンテキストの外部で実行されます。Webshop でプレイヤーを識別するために、ゲームは認証されたプレイヤーセッションを含むアウトバウンドリンクを使用してショップを開きます。これはショップを開くのに推奨される方法です。プレイヤーは余分なサインインステップなしで購入を完了できます。 プレイヤーは、ブラウザー、ブックマーク、マーケティングリンク、または共有リンクから直接ショップを開くこともできます。ショップがプレイヤー セッションを受信しない場合は、製品リストの代わりに未認証のランディング ページが表示されます。購入後、ショップはディープリンクでプレイヤーをゲームに戻すことができます。また、このリンクを使用して、認証されていないプレイヤーを自動的にハンドルすることもできます。詳細は、「 インバウンドディープリンクのハンドル 」を参照してください。 Web ショップは、ゲームが通過するセッションから認証をハンドルします。個別のサインインフローをビルドする必要はありません。詳細については、プレイヤーの認証とセッションの永続化 を参照してください。
アウトバウンドリンク
ゲームは、プラットフォームの標準外部 URL 処理を使用してショップ URL を開きます。モバイルデバイスでは、通常、システムブラウザーまたはアプリケーション内のビューップを開きます。 URL 形式は以下のとおりです。公開中のショップまたは環境のドラフトプレビューのランタイムにこの URL を解決するには、Webshop を Unity ゲームに統合 を参照してください。 以下のクエリはプレイヤーを識別し、正しいウェブショップコンテキストをロードします。https://shop.unity.com/{studio}/game/{slug}?sessionToken={token}&projectId={projectId}&environment={env}
パラメーター | 目的 |
|---|---|
| Unity Authentication SDK からの短期セッション トークン。ショップは、プレイヤーのブラウザーでこのトークンを交換して、認証されたプレイヤーセッションを行います。 |
| プレイヤーが属する Unity Cloud プロジェクト ID。ショップはこの値を使用して正しい Webshop とカタログをロードします。 |
| ロードする Unity 環境名。このパラメーターは任意で、デフォルトは |
localecurrencyショップは認証とストアのパラメーターを解析した後、それらを URL から削除します。これにより、スクリーンショットや誤って共有された URL がセッショントークンを公開することを防ぐことができます。https://shop.unity.com/acme/game/dungeons?sessionToken=…&projectId=…&environment=production&locale=ja-JP¤cy=JPY
sessionTokenprojectIdプレイヤーの認証とセッションの永続化
Webshop は Unity Authentication でプレイヤー セッションを認証します。ゲームがショップを開くと、sessionTokensessionTokenlocalStorage/_preview/...localStoragesessionStorage認証されていないランディングページのハンドル
プレイヤーが認証コンテキストを使用せず、プロジェクトと環境のlocalStorage購入後のゲームへの帰還
購入後、Webshop はプレイヤーをディープリンク付きでゲームに戻すことができます。ダッシュボードの「Deeplink URL」フィールド、例えば「mygame://purchase-success注
戻りディープリンクは、支払いプロバイダーのリダイレクト URL とは異なります。チェックアウト後、支払いプロバイダーはプレイヤーを Webshop にリダイレクトし、そこで購入結果画面が表示されます。ディープリンクの戻りは、その画面からゲームに戻る Webshop の次のステップです。Back to game ボタンとして表示されます。ディープリンクの戻りを設定しても、プロバイダーリダイレクト URL は変更されません。
Webshop では、購入が完了した後にmygame://purchase-success?status=success&playerId={playerId}
status=successplayerIdゲームはカスタム URL スキームを登録し、クエリを読み取って中断オフたプレイヤーを再開します。 Back to game (ゲームに戻る) ボタンは、以下の条件がすべて満たされた場合にのみ購入結果画面に表示されます。mygame://?status=success
- プレイヤーは、ディープリンクからゲームからショップを開きました。
- プレイヤーはiOSやAndroidなどのモバイルデバイス上にあります。
- ウェブショップには戻りディープリンクが設定されています。