Buy Button

Buy Buttonはデジタル商品販売のための包括的なソリューションです。

Note: エクソラ製品をすでに使用していて、Buy Buttonを統合したい場合は、アカウントマネージャーにお問い合わせください。

仕組み

ステップ 1

ステップ 2

ステップ 3

ユーザーフロー

統合フロー

Buy Buttonを統合するには、

  1. エクソラパブリッシャーアカウントを登録します。
  2. プロジェクトを作成します。
  3. 収益化オプションを選択します。
  4. アイテムを販売するためのオプションを選択します。

Note: こちらのガイドは、すぐに機能を使い始める場合に必要な、最低限の設定について説明しています。ご不明な点がございましたら、アカウントマネージャーまでご連絡ください。

プロジェクトの作成

  1. まずプロジェクトを開き、新規プロジェクトの作成をクリックする。
  2. 設定モードでは：
    1. ウェブフックURLを指定する。
    2. プロジェクトのウェブフックに署名するための秘密キーを生成する。

収益化オプション

仮想通貨

バーチャル通貨オプションにより、ゲーム開発者はゲーム内の通貨を販売することができます。主要機能：

  • ゲーム内通貨パッケージの販売
  • プロモーションキャンペーンを実施する
  • ゲーム内通貨のユーザー残高の管理、
  • ユーザーの通貨と国の自動検出。

設定

  1. 仮想通貨設定に移動し、次のパラメータを設定する：
    • 名前。
    • 単位当たりの価格。
    • 画像。
  2. 必要な量の仮想通貨パッケージを作成し、それぞれ次のパラメーターを設定する。
    • 価格。
    • 画像。
  3. ストアのパッケージ表示をオンにする。

ウェブフックの設定

仮想通貨を使用する際は、以下のウェブフックを実装する必要があります：

メッセージ本文なし、HTTPコード204ありの応答でウェブフックの受信を承認します。APIリファレンスから、ウェブフックについて（例など）詳しくご参照いただけます。

ウェブフックのハンドラをテストするときは、プロジェクト設定>ウェブフックセクションを開いてください。

レシピ

こちらのレシピは、次のような仮想通貨の上級機能を試すときに役立ちます：

仮想アイテム

仮想アイテムオプションにより、現金または仮想通貨でゲームコンテンツを販売することができます。主要機能：

  • 実際の通貨と仮想通貨の価格を設定
  • 1または複数レベルのカタログを設定
  • コンテンツへのアクセス管理たとえば、一定のレベルに達したユーザーのみが特定のアイテムを利用可能にできます。
  • 簡潔なアイテムカードと詳しいアイテムカードを設定
  • プロモーションキャンペーンを実施する
  • ゲーム内通貨のユーザー残高の管理
  • ユーザーの通貨と国の自動検出

設定

  1. 仮想アイテムの設定を開く。
  2. ストアのカタログを入力：
    1. アイテムグループの作成。
    2. アイテムを作成。それぞれ次の項目を指定する：
      • アイテムが属するべき1つ以上のグループ
      • SKU
      • 名前と短い説明文
      • 実際の通貨と仮想通貨の価格
      • 画像
  3. ストアでグループのディスプレイをオンにします。

ウェブフックの設定

仮想アイテムを使用する際は、次のウェブフックを実装する必要があります：

メッセージ本文なし、HTTPコード204ありの応答でウェブフックの受信を承認します。APIリファレンスから、ウェブフックについて（例など）詳しくご参照いただけます。

ウェブフックのハンドラをテストするときは、プロジェクト設定>ウェブフックセクションを開いてください。

レシピ

こちらのレシピは、次のような仮想アイテム の上級機能を試すときに役立ちます：

ゲームキー

ゲームキーオプションにより、ゲーム開発者は直接、ゲームのウェブサイトからキーの販売やパッケージの配布ができます。ユーザーはゲームキーウィジェットを使用して、ストアにアクセスできます。主要機能：

  • キーと配布用パッケージを配布するDRMプラットフォームの
  • 各DRMプラットフォーム向けに作動するシステムやゲームのコンソールバージョンの選択
  • 様々なDRMプラットフォームへの異なる価格の設定
  • ウィジェットのサイズおよび色のテーマの設定
  • 開発者へのチップの支払い
  • プレオーダー

オプションは、基本もしくは高度モードのいずれかで統合できます。

基本的な統合

基本的な統合：

  • 迅速な実装。
  • トークンの生成やサーバーの実装が不要。
  • ユーザーの事前承認を必要としないゲームにも最適。

統合にはプロジェクトIDパラメーターが必要です。プロジェクト設定>ウェブフックでご確認いただけます。

モジュールの設定：

  1. プロジェクト設定>統合設定でトークンなしの統合をオンにする。
  2. プロジェクト設定>ウェブフックでウェブフックをオフにする。
  3. ゲームキー設定を開いて、新しいパッケージを押す。
  4. パッケージのパラメーターを設定：
    • SKU-固有ID
    • ゲームタイトル
    • ゲームの概要
  5. DRMとプラットフォームを選択。
  6. 選択したDRMの価格を設定。
  7. 選択したDRM用のキーをアップロード。
  8. ランディングページにウィジェットコードを埋め込む。

基本的な統合のためのウィジェットパラメータの完全なリストは、ウィジェット経由の販売のセクションにあります。

高度な統合

高度な統合：

  • ゲーム側でさらにリンクするためにユーザーと購入データの安全な転送が可能です
  • サーバー側の実装設定で必要：トークン生成とウェブフック

統合には次のパラメータが必要です。

  • マーチャントIDはプロジェクト設定>ウェブフックでご確認いただけます
  • APIキー。パラメーターは会社設定>APIキーで生成できます
  • プロジェクトIDはプロジェクト設定>ウェブフックでご確認いただけます
  • 秘密キー。パラメーターはプロジェクト設定>ウェブフックで生成できます

モジュールを設定：

  1. ゲームキーを開いて新しいパッケージをクリック。
  2. 設定パッケージのパラメーター：
    • SKU-固有識別子
    • ゲームタイトル
    • ゲームの短い解説
  3. DRMとゲームのプラットフォームを選択。
  4. 選択されたDRMプラットフォームの価格を設定する。
  5. 選択したDRMプラットフォームのキーをアップロードする。
  6. ウィジェットコードをランディングページに追加。

ウィジェットパラメータの高度な統合用の完全なリストは、APIリファレンスを参照してください。

ウェブフックの設定

ゲームキーの高度な統合には、次のウェブフックを実装する必要があります：

メッセージ本文なし、HTTPコード204ありの応答でウェブフックの受信を承認します。APIリファレンスから、ウェブフックについて（例など）詳しくご参照いただけます。

ウェブフックのハンドラをテストするときは、プロジェクト設定>ウェブフックセクションを開いてください。

レシピ

こちらのレシピは、次のような ゲームキーの上級機能を試すときに役立ちます：

アイテムの販売

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

直接リンクは、新しいウィンドウまたはウェブサイトのiframeで決済UIを開くために使用されます。例：クリック可能なバナーを配置して、決済UI経由でウェブサイトでアイテムを購入します。

ゲームアクセス、仮想アイテム、および仮想通貨を販売するためのリンク設定は異なります。

ゲームへのアクセスの販売

基本的な統合

ゲーム販売の基本的な統合中に、次のリンクを使用して決済UIを開きます：

https://store.xsolla.com/pages/buy.php?type=digital_content&project_id={YOU_PROJECT_ID}&sku={YOUR-ITEM-SKU}&drm=steam

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

  • パブリッシャーアカウントでのあなたのプロジェクトID（あなたのプロジェクト–プロジェクト設定–一般設定–プロジェクトID）
  • アイテムSKU

追加の設定：

テストには次のURLを使用します：
https://store.xsolla.com/pages/buy.php?type=digital_content&project_id={YOU_PROJECT_ID}&sku={YOUR-ITEM-SKU}&mode=sandbox

高度な統合

ゲーム販売の高度な統合中に、決済UIを開くために次のリンクが使用されます：

https://store.xsolla.com/pages/buy.php?type=digital_content&project_id={YOUR_PROJECT_ID}&sku={YOUR_ITEM_SKU}&{TOKEN_TYPE}=ACCESS_TOKEN
このリンクに次のデータを追加します：
  • YOUR_PROJECT_ID – パブリッシャーアカウントでのあなたのプロジェクトID（あなたのプロジェクト–プロジェクト設定–一般設定–プロジェクトID）
  • YOUR_ITEM_SKU – アイテムSKU
  • TOKEN_TYPE – トークンタイプ：エクソラログインJWTン用のxsolla_login_tokenと決済ステーションアクセストークンのaccess_token
  • ACCESS_TOKEN-は認証タイプに応じて形成されるトークンです

テストには次のURLを使用します：

https://store.xsolla.com/pages/buy.php?access_token=ACCESS_TOKEN&mode=sandbox

仮想アイテムと仮想通貨の販売

次のリンクは、仮想アイテムと仮想通貨を販売するときに決済UIを開くために使用されます：
https://store.xsolla.com/pages/buy.php?type={ITEM_TYPE}&project_id={YOUR_PROJECT_ID}&sku={YOUR_ITEM_SKU}&{TOKEN_TYPE}={ACCESS_TOKEN}

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

テストには次のURLを使用します：
https://store.xsolla.com/pages/buy.php?type={ITEM_TYPE}&project_id={YOUR_PROJECT_ID}&sku={YOUR_ITEM_SKU}&{TOKEN_TYPE}={ACCESS_TOKEN}&mode=sandbox
トークンを作成するには：
  1. 購入のオーダーを作成するため認証トークンを取得します。
  2. オーダーを作成します。決済UIを開くためのトークンが応答に渡されます。

ウィジェット経由の販売

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

Info: ウィジェット設定は、プロジェクトの統合タイプによって異なります。統合設定は、プロジェクト設定>統合設定にあります。

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

<script>
    var options = {
        project_id: "YOUR-PROJECT-ID",
        item_type: "YOUR-ITEM-TYPE",
        sku: "YOUR-ITEM-SKU",
        widget_ui: {
            target_element: '#widget-example-element'
        }
    };
    var s = document.createElement('script');
    s.type = "text/javascript";
    s.async = true;
    s.src = "//cdn.xsolla.net/embed/pay2play/3.0.0/widget.min.js";
    s.addEventListener('load', function (e) {
        var widgetInstance = XPay2PlayWidget.create(options);
    }, false);
    var head = document.getElementsByTagName('head')[0];
    head.appendChild(s);
</script>
上記のコードに次のデータを追加します：
  • YOUR-PROJECT-ID– パブリッシャーアカウントでのあなたのプロジェク（あなたのプロジェクト–プロジェクト設定–一般設定–プロジェクトID）
  • YOUR-ITEM-TYPE-アイテムタイプ：
    • ゲーム – digital_content（古い管理方法のプロジェクトの場合）またはgame_key（新しい管理方法のプロジェクトの場合）
    • 物品 – physical_good
    • 仮想アイテム – virtual_item
    • 仮想通貨 –virtual_currency
  • YOUR-ITEM-SKU-アイテムSKU。プロジェクトが新しいストア管理方法を使用し、その中でゲームキーを販売する場合、YOUR-ITEM-SKU_DRMフォマードでDRMを追加します。
ウィジェット構成の詳細については、GitHubをご覧ください。

ストアUI経由の販売

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

Store APIに基づく

Store APIメソッドを統合することにより、ストアのフロントエンド部分を作成できます：
  1. アイテムリストを取得する。
  2. アイテムを購入する：
    • 1つのアイテムの迅速な購入。決済UIを開くためのトークンが応答に渡されます。
    • いくつかのアイテムを購入する：
      • カートに商品を追加する
      • カート内のアイテムのリストを取得する
      • カート内のアイテムを支払う。決済UIを開くためのトークンが応答で渡されます
メソッドが正しく機能するように、適切な認証オプションを選択してください。

デモ版に基づく

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

認証設定

認証されたユーザーと認証されていないユーザーの両方が購入を行うことができます。

認証されていないユーザー

ユーザーは認証なしでゲームや物理的な商品を購入できます。

ゲームを販売するための基本的な統合で購入オプションを使用します。

物品を販売するためのStore APIメソッドを呼び出すときは、タイトルにx-unauthorized-idユーザー識別子を渡す必要があります。識別子は、フロントエンド側の番号または行として生成できます。識別子を生成するためのライブラリの例。

認証されたユーザー

ユーザーの認証には次のオプションがあります：
  1. エクソラログインを統合した場合、リクエストはエクソラログインJWTトークンを介して認証されます。
  2. 独自の認証システムがある場合、リクエストは決済ステーションアクセストークンを介して認証されます。

エクソラログイン経由での認証設定

  1. 指示に従って、パブリッシャーアカウントでプロジェクトを設定します。
  2. 認証メソッドコールバックを実装するには：JSON Web TokenまたはOAuth 2.0プロトコルに基づいています。
ユーザーデータがエクソラストレージに保存されている場合は、次のメソッドを実装します：ユーザーデータがPlayFabデータベースに保存されている場合は、PlayFabストレージのレシピを使用します。 ユーザーデータをカスタムストレージに保存する場合は、カスタムストレージのレシピを使用してください。

決済ステーションアクセストークン経由の認証設定

認証フロー：
  1. クライアントが認証リクエストをサーバーに送信します。
  2. あなたのサーバーはMerchant IDとAPI keyをエクソラサーバーに渡し、access_tokenをリクエストします。
  3. エクソラサーバーがaccess_tokenをあなたのサーバーに送信します。
  4. あなたのサーバーはaccess_tokenをクライアントに送信します。
返されたaccess_tokenは、ゲームクライアントから送信されたリクエストを認証するための認証トークンとして使用されます。

プロモーションオプション

クーポン

クーポン機能を使うと、パートナーはクーポンコードのついたクーポンキャンペーンを作成できます。このコードは、パートナーがアップロードする、もしくは、パブリッシャー・アカウントから生成することが可能です。ユーザーはクーポンを使って、仮想通貨や仮想アイテム、サブスクリプションプランの体験期間を受け取れます。必要に応じて、交換回数と有効期限を変更してください。

レシピをご覧ください

ラベル

ラベル機能を使うと、パートナーは仮想アイテムや仮想通貨パッケージのプロモーションにラベルを貼れます。例えば、"Best Value"などです。

レシピをご覧ください

ボーナス

ボーナス機能によって、ユーザーは何かを購入するとボーナスアイテムを受け取れます。ボーナスに指定できるのは次のものです。

  • 仮想通貨
  • サブスクリプションの体験期間
  • 仮想アイテム
  • ゲーム
  • 物品（例：グッズ）

レシピをご覧ください

レシピ

レシピは、次のBuy Buttonの上級機能を試すときに役立ちます：

チュートリアル