販売アイテムを設定する

直接リンクウィジェット、またはストアUI経由でアイテムを販売できます。

決済UIを開くには以下のリンクを利用します:

Copy
Full screen
Small screen
https://store.xsolla.com/pages/buy.php?type={YOUR-ITEM-TYPE}&project_id={YOU_PROJECT_ID}&sku={YOUR-ITEM-SKU}

このリンクに次のデータを追加します:

  • YOUR-ITEM-TYPE — アイテムタイプ:
    • game — ゲーム;game_key — 確定したDRMゲームを販売する場合。
    • physical_item — 物理的な商品。
    • virtual_item — 仮想アイテム。
    • virtual_currency — 仮想通貨。
    • bundle — 仮想通貨パッケージまたはバンドル。
  • YOUR-PROJECT-IDパブリッシャー アカウントのプロジェクトID(あなたのプロジェクト > プロジェクト設定 > 一般設定 > プロジェクトID)。
  • YOUR-ITEM-SKU — アイテムSKU。確定したDRMゲームを販売するには、あなたのストアに追加されたバーチャルアイテムの完全なリストに表示されているGet games listで、DRMのSKUを取得する必要があります。このSKUは通常にunit_name_drm_skuのようになります。

  • 決済UIスタイル:テーマ(ダークはdarkパラメータ、またはライトはdefaultのパラメーター)サイズ、およびその他のパラメーター。URLでui_settingsパラメーターを指定し、値としてBase64エンコードを持つsettings.uiJSON-objectを渡します。UI設定を含むURLの例:

Copy
Full screen
Small screen
https://store.xsolla.com/pages/buy.php?type={YOUR-ITEM-TYPE}&project_id={YOU_PROJECT_ID}&sku={YOUR-ITEM-SKU}&ui_settings=ewoJCQkic2l6ZSI6ICJzbWFsbCIsCgkJCSJ0aGVtZSI6ICJkYXJrIgoJCX0=

  • ユーザーデータを渡すためのトークン。認証されたユーザーにアイテムを販売する際にのみ使用され、仮想アイテムや仮想通貨を販売する際に必要となります。このトークンは認証メソッドに依存します。トークンを含むURLの例:

Copy
Full screen
Small screen
https://store.xsolla.com/pages/buy.php?type={YOUR-ITEM-TYPE}&project_id={YOUR_PROJECT_ID}&sku={YOUR_ITEM_SKU}&xsolla_login_token={ACCESS_TOKEN}

  • 決済テストのmode=sandboxパラメータ。テスト銀行カードを使用して、決済を完了することができます。テスト用のURLの例:

Copy
Full screen
Small screen
https://store.xsolla.com/pages/buy.php?type={YOUR-ITEM-TYPE}&project_id={YOU_PROJECT_ID}&sku={YOUR-ITEM-SKU}&mode=sandbox

ウィジェット経由の販売

ウィジェットは、アイテムを販売するためにウェブサイトに実装できるスクリプトです。動作するウィジェットの例はデモページにあります。

ウィジェットを実装するためのコード:

Copy
Full screen
Small screen
<script>
    var options = {
        project_id: "YOUR-PROJECT-ID",
        item_type: "YOUR-ITEM-TYPE",
        sku: "YOUR-ITEM-SKU",
        user: "ACCESS_TOKEN",
        widget_ui: {
            target_element: '#widget-example-element'
        }
    };
    var s = document.createElement('script');
        s.type = "text/javascript";
        s.async = true;
        s.src = "https://cdn.xsolla.net/embed/buy-button/3.1.2/widget.min.js";
        s.addEventListener('load', function (e) {
          var widgetInstance = XBuyButtonWidget.create(options);
          }, false);
    var head = document.getElementsByTagName('head')[0];
    head.appendChild(s);
</script>

上記のコードに次のデータを追加します:

  • YOUR-PROJECT-ID — パブリッシャーアカウント のプロジェクトID(あなたのプロジェクト > プロジェクト設定 > 一般設定 > プロジェクトID)。
  • YOUR-ITEM-TYPE — アイテムタイプ:
    • game — ゲーム;game_key — 確定したDRMゲームを販売する場合。
    • physical_item — 物理的な商品。
    • virtual_item — 仮想アイテム。
    • virtual_currency — 仮想通貨。
    • bundle — 仮想通貨パッケージまたはバンドル。
  • YOUR-ITEM-SKU — アイテムSKU。確定したDRMゲームを販売するには、あなたのストアに追加されたバーチャルアイテムの完全なリストに表示されているGet games listで、DRMのSKUを取得する必要があります。このSKUは通常にunit_name_drm_skuのようになります。
  • ACCESS_TOKEN — ユーザーデータを渡すためのトークン。認証されたユーザーにアイテムを販売する際にのみ使用され、仮想アイテムや仮想通貨には必要です。このトークンは、認証方法によって異なります。

ウィジェット構成の詳細については、GitHubをご覧ください

ストアUI経由の販売

ストアUIを介して仮想アイテムと仮想通貨を販売するには、ゲームに別のウェブアプリケーションを実装するか、ストアUIを実装します。アイテムのリストを取得して操作するには、Commerce APIを使用するか、またはデモ版に基づいて独自のストアを作成します。

Commerce APIに基づく

Commerce APIメソッドを統合することで、ストアのフロントエンド部分を作成できます:
  1. 仮想アイテム仮想通貨パッケージゲームのアイテムリストを取得する。
  2. アイテムを購入する:

メソッドが正しく機能するように、適切な認証オプションを選択してください。

Note
Commerce APIメソッドを介してゲームを販売するには、フロントエンド側でDRMの選択を実装する必要があります。ゲームリクエストをSKUとして取得するからのitems.unit_items.skuパラメータ値を渡します。

デモ版に基づく

ストアデモバージョンを使用してAPI機能を確認できます。そのコードはGitHubにアップロードされます。独自のバージョンを作成するためのベースとして使用できます。

この記事は役に立ちましたか?
ありがとうございます!
改善できることはありますか? メッセージ
申し訳ありません
この記事が参考にならなかった理由を説明してください。 メッセージ
ご意見ありがとうございました!
あなたのメッセージを確認し、体験を向上させるために利用させていただきます。
このページを評価する
このページを評価する
改善できることはありますか?

答えたくない

ご意見ありがとうございました!

続きを読む

次のステップ

ウェブフックの設定
最終更新日: 2021年7月12日

誤字脱字などのテキストエラーを見つけましたか? テキストを選択し、Ctrl+Enterを押します。

問題を報告する
当社は常にコンテンツを見直しています。お客様のご意見は改善に役立ちます。
フォローアップ用のメールをご提供してください
ご意見ありがとうございました!