ウェブショップ

このセクションでは、独自のウェブショップの設定方法、または既存のウェブショップをアプリに連携してストア手数料を節約する方法を説明します。

ウェブショップの設定方法

• 「ショップを設定」をクリックします。
  「ショップの詳細 – 設定セクション」に移動しますので、必要な詳細を入力してショップを公開します。

ショップの詳細

このセクションでは、ショップの設定を行い、ドラフトまたは公開されたショップを一覧表示します。

設定

このセクションではウェブショップを設定することができます。

ショップを設定するには、「ショップ設定」を選択する必要があります。

以下のどちらかを選択します。

• ウェブショップの作成
  プロダクトを販売するために新しいウェブショップを作成します。
• 既存のウェブショップを使用
  既存のウェブショップとnowStudioを連携してプロダクトを販売します。

ウェブショップの作成

「ショップ設定」で「ウェブショップを作成」を選択した後、ここでウェブショップの設定を続けることができます。

1. ショップのプロダクト

このセクションでは、ウェブショップで販売したいプロダクトを選択することができます。

• 「プロダクトを選択＋」をクリックします。
  
• 追加済みのプロダクトから選択します。
  
• 既存のプロダクトがない場合、または新しいプロダクトを追加したい場合は、「アプリ内プロダクト」セクションで追加できます。
• プロダクトを選択したら、「完了」をクリックします。
• 次のステップでデザインアセットを追加できます。

2. アセットのデザイン

このセクションでウェブショップのデザインアセットを選択できます。

重要な情報

• nowStudioにアプリを追加する際に一般的なゲームアセット（公開タブ内）をアップロードすると、ウェブショップを構築する際に自動的に選択されます。
• 「画像の置換」をクリックして、要件に応じてそれぞれの画像を変更できます。

以下の仕様に基づいてアセットをアップロードできます。

• ゲームアイコン
  • サイズ – 512 x 512px
  • 画像形式 – JPG、JPEG、PNG
  • 最大サイズ – 10 Mb
• ゲームロゴ
  • サイズ – 550 x 300px
  • 画像形式 – PNG、SVG
  • 最大サイズ – 10 Mb
• カバー画像
  • サイズ – 1920 x 1080px
  • 画像形式 – JPEG
  • 最大サイズ – 10 Mb

3. 決済設定

このセクションを使用して、ウェブショップの以下の決済設定を構成することができます。

以下を設定できます

• コールバックURL
  取引後にリクエストデータを送信するコールバックURLを指定します。
• APIキー
  APIキーは、取引後に送信されるリクエストデータと一緒に渡されます。APIコールの信頼性を確保するために、このキーを検証することができます。

重要な情報

• コールバックURLは、ここで提供されるAPI仕様に基づいて「PaymentsProcessingCallback API」を指す必要があります。

4. プライバシーポリシー

このセクションでは、プライバシーポリシーの設定を行うことができます。

• 以下のように、自身の組織のプライバシーポリシーのURLを提供してください。
  

5. プレビュー、公開、ドラフトを保存

ウェブショップの構成が完了したら、次のことが可能になります。

• ウェブショップをドラフトとして保存
  • ウェブショップのプレビュー
• ウェブショップの公開

ドラフトを保存

ウェブショップをドラフトとして保存する方法:

• 画面右下隅にある「ドラフトを保存」をクリックします
• 以下のように、ウェブショップはドラフトとして保存され、「ショップの詳細」セクションに追加されます。
  
• ウェブショップをプレビューするには、「ウェブショッププをプレビュー」をクリックします。
  • ウェブショップをプレビューし、公開する前に必要な変更を加えることができます。
    (新しいウィンドウでプレビューが開きます)
• ウェブショップの編集を続けるには、上記のように「ショップを編集」をクリックします。

ウェブショップの公開

ウェブショップの設定が終わったら、画面右下の「公開」をクリックします。

• 画面右下の「公開」をクリックします。
• 自身のウェブショップが公開され、以下のように「ショップの詳細」セクションに追加されます。
  
• 公開されたURLをコピーするか、「ウェブショップを見る」ボタンをクリックしてウェブショップにアクセスすることができます。
•  ウェブショップに関連する詳細/情報を編集したい場合：
  • 「ショップを編集」をクリックします。
•  編集が終わったら、「公開」をクリックします。
  • 確認ウィンドウが表示されたら、「公開」をクリックします。

ウェブショップの公開停止またはウェブショップへの切り替え

ウェブショップの公開を停止する方法：

• ショップの詳細セクションに移動します。
  • 画面右上の「ショップを編集」をクリックします。
  • 画面右下の「公開を停止」をクリックします。
  • 確認ウィンドウで、以下のように「公開を停止」をクリックします。
    
• ウェブショップの公開は停止し、ドラフト状態になります。
• ドラフト状態のウェブショップにアクセスするには、左のナビゲーションで「ショップの詳細」をクリックしてください。

ウェブショップへの切り替え

公開されたウェブショップから既存のウェブショップに切り替えることができます。

ウェブショップから既存のウェブショップに切り替える方法：

• 以下のように「ショップを編集」をクリックします。
  
  (設定セクションが開きます)

• 設定セクションの「ショップ設定」内に移動します。
  • 「既存のウェブショップを使用」をクリックします。
  • 確認ウィンドウにて「続行」をクリックします。
    
  • now.ggを用いたウェブショップは無効になります。
  • 既存のウェブショップのURLを入力することができます。
  •  「公開」をクリックします。
    • 確認ウィンドウが表示されたら、「公開」をクリックします。

既存のウェブショップを使用する

このセクションを使用して、既存のウェブショップとnowStudioを連携し、プロダクトを販売することができます。

既存のウェブショップを使用する方法：

• 既存のウェブショップのURLを入力します。
  • 「公開」をクリックします。
  • 確認ウィンドウで、「公開」をクリックします。
• ウェブショップが公開され、以下のようにショップ詳細セクションに追加されます。
  
• 自身のウェブショップへのリンクをコピーするか、「ウェブショップを見る」をクリックして新しいブラウザでウェブショップを開きます。
• ウェブショップを編集したい場合は、画面右上の「ショップを編集」をクリックします。
• 編集が終わったら、「公開」をクリックします。

ウェブショップへの切り替え

このセクションを使用して、既存のウェブショップからnow.ggを使用したウェブショップに切り替えることができます。

手順は以下の通りです：

• 「ショップの詳細」セクションで、画面右上の「ショップを編集」をクリックします。
  
  (設定セクションが開きます)
• 設定セクションで、「ショップ設定」に移動します。
  • 「ウェブショップの作成」をクリックします。
  • 確認ウィンドウで「続行」をクリックします。
• こちらに示されている手順に従ってウェブショップを設定します。

内部テスター

内部テストを使用すると、ウェブショップでプロダクトの購入と配信のフローを簡単にテストでき、ウェブショップでの購入を実行するテスターを追加できます。

テスターを追加する方法:

• 「全アプリ」に移動します。
  • 統合をテストしたいアプリに対して「詳細を表示」をクリックします。
  • 左側のサイドバーで「テスター」をクリックします。
    • 「テスターの追加」をクリックします。テストに使用するユーザーのゲーム内ユーザー ID（IN_GAME_ID）を入力します。
      
  • 「追加」をクリックします。
    「テスターが正常に追加されました」という確認画面が表示されます。

テスターを削除する方法：

• 「全アプリ」に移動します。
• 統合をテストしたいアプリの「詳細を表示」をクリックします。
  • 左サイドバーの「テスター」をクリックします。
  • 以下のようにテスターの一覧が表示されます。
    
  • 確認画面が表示されます。
    
  • 「削除」をクリックします。
    「テスターが正常に削除されました」という確認画面が表示されます。

PaymentsProcessingCallback API

(開発者提供)

このセクションでは、ウェブショップでの購入を正常に処理するためにPaymentsProcessingCallbackAPI を提供するためのAPI仕様について説明します。

nowStudioはウェブショップの決済を正常に処理するためにPaymentsProcessingCallback を必要とします。以下は注文処理に関連するワークフローです。

• nowStudioはこのAPIを使用してゲームバックエンドにリクエストデータを送信します。
• 自身のゲームバックエンドは当社が提供するAPIキーを使用することでリクエストを認証できます。(決済設定内)
• 購入済みのプロダクトをユーザーに割り当てることで、購入フローを完了できます。
• nowStudio がステータス コード 200 と成功を true として受け取ると、注文は完了としてマークされます。

リクエストメソッド

 POST

リクエストヘッダー

Authorization: "<API-Key Here>"
 Content-type: application/json

※このセクションを使用してAPIキーを生成/再生成できます。

リクエストボディ

以下のパラメータがリクエストボディに含まれます。

データオブジェクトパラメータ

次のパラメータはデータ オブジェクトに関連付けられます。

予想されるレスポンス

以下は、PaymentsProcessingCallback API に関連付けられた予想されるレスポンスのサンプルです。

{
     "success": true, 
     "reason": "reason_for_failure". // Optional Param. Only required if success is false. 
 }

返金処理

ウェブショップでの返金に関しては以下のプロセスが実装されます。

• 指定されたコールバックURLを使用してリクエストデータを送信した後、APIからのレスポンスを待ちます。
  • 「status code 200 with success as true」の場合、注文は完了となります。
  • 「success」のレスポンスが得られない場合は、しばらく再試行を続けます。 レスポンスが受信されない場合は、注文の返金を開始します。