バンドル

どのように動作するか

バンドルとは、複数のアイテムを1つにまとめて販売するセットのことです。

主な特徴:

  • さまざまなタイプのアイテムをバンドルに追加します:
    • 仮想通貨(プラットフォームに依存する通貨を含む)
    • 仮想通貨パッケージ
    • 事前に選択されたプラットフォームのゲームキー
    • 期間限定アイテムを含む仮想アイテム
    • バンドル
  • 実際通貨と仮想通貨のバンドル価格を構成します。
  • 購入できるバンドル数を制限します

バンドルは、次の後に自動的にアンパックされます:

バンドルに別のバンドルが含まれている場合、含まれているバンドルは自動的にスタンドアロンのアイテムに分離されます。

アンパックされたバンドルからのアイテムの配信方法は、アイテムのタイプによって異なります:

  • 仮想通貨パッケージ、仮想アイテム、 期間限定アイテム、またはバンドルは以下へ配信されます:
  • ゲームキーは以下へ配信されます:

お知らせ
サーバーにゲーム内ストアロジックを実装した場合、アイテム購入ウェブフックを設定することができます。ウェブフックには、バンドルとそのすべてのコンテンツが含まれます。

購入者が取引をキャンセルするなどしてバンドルを返却すると(例えば)、バンドルから付与されたすべてのアイテムが自動的にユーザーから引き出されます。ユーザーがアイテムの一部を使用した場合でも、残りのアイテムは撤回されます。

制限:

  • 以下の項目をバンドルに追加することはできません:
    • 同じバンドル
    • 物理的な商品
  • 空のバンドルを作成することはできません。
  • バンドルセールはキーを使い切ってから一時停止しており、これらのキーはバンドルに含まれています。
  • バンドル価格は、実際通貨および/または仮想通貨の固定値です。
  • バンドルの地域制限は、APIを介してのみ構成できます。

購入できるバンドル数を制限する

バンドル購入の制限をすることができます。例えば、以下の制限することができます:

  • 1ユーザーあたりのバンドル数
  • 一度しか購入できないウェルカムバンドル

ユーザーが指定された上限に達している場合、バンドルはカタログに表示されません。バンドルに購入制限のある仮想通貨パッケージやアイテムが含まれていて、ユーザーがすでに許容量に達している場合、そのバンドルはカタログに表示されません。

ユーザーが利用できる最大バンドル数および残りのバンドル数を表示することができます。

パブリッシャーアカウントでバンドルを作成する時に購入制限を設定するには、1 人のユーザーがこのバンドルを購入できる回数を制限するのトグルをオンに切り替え、バンドル購入可能回数を指定します。

バンドルに関する情報を取得するには、バンドルメソッドグループから カタログサブセクションのメソッドを使用します。

応答では、バンドルに関する情報のほか、以下の情報を受け取ることができます:

  • 1ユーザーが購入できる最大バンドル数
  • ユーザーが購入可能なバンドル数の残数

応答の例:

Copy
Full screen
Small screen
{
  "items": [
    {
      "sku": "kg_1",
      "name": "kg_10.00_bundle",
      "type": "bundle",
      "description": "pricePoint_44056_1",
      "image_url": null,
      "long_description": null,
      "attributes": {
        "external_id": "genre",
        "name": "Genre",
        "values": [
          {
            "external_id": "genre_e3364991f92e751689a68b96598a5a5a84010b85",
            "value": "Casual"
          },
          {
            "external_id": "genre_eba07bfd0f982940773cba3744d97264dd58acd7",
            "value": "Strategy"
          },
          {
            "external_id": "genre_b8d0c6d8f0524c2b2d79ebb93aa3cd0e8b5199a8",
            "value": "Mobile"
          }
        ]
      },
      "is_free": false,
      "order": 999,
      "groups": [],
      "price": {
        "amount": 9.99,
        "currency": "USD",
        "amount_without_discount": 9.99
      },
      "total_content_price": {
        "amount": 10.99,
        "currency": "USD",
        "amount_without_discount": 10.99
      },
      "media_list": [],
      "virtual_prices": [],
      "can_be_bought": true,
      "bundle_type": "standard",
      "limits": {
        "$ref": "./Catalog_item_limits.yaml"
      },
      "content": [
        {
          "sku": "big_rocket",
          "name": "Big Rocket",
          "description": "Big Rocket - short description.",
          "image_url": "https://popmedia.blob.core.windows.net/popyourself/male/outfit/male_armor_white_a-01.png",
          "type": "virtual_currency",
          "quantity": 100,
          "virtual_item_type": "non_consumable",
          "attributes": {
            "external_id": "size",
            "name": "Size",
            "values": [
              {
                "external_id": "size_e3364991f92e751689a68b96598a5a5a84010b85",
                "value": "Large"
              }
            ]
          },
          "is_free": false,
          "groups": [],
          "price": {
            "amount": 10.99,
            "currency": "USD",
            "amount_without_discount": 10.99
          },
          "virtual_prices": [],
          "limits": {
            "per_user": {
              "total": 5,
              "available": 5
              },
            "per_item": null
           },
          }
        }
      ]
    }
  ]
}

お知らせ

エクソラは制限を実施し、ユーザーが設定された上限を超えてバンドルを購入することを防ぎます。

決済インターフェースを開き、バンドルの代金を支払うと、そのバンドルの未払い注文はすべて無効となります。

:ユーザーは、バンドルが購入されるまで、いくつかのブラウザータブで購入制限のあるバンドルの決済フォームを開くことができます。これにより、自動的に同じバンドルの注文が複数作成されます。1つのタブでバンドルを購入した後、エクソラは同じバンドルの未払い注文をすべて無効にします。

使用に適した方

バンドルに含まれる全アイテムの初期合計よりも安い価格でセット販売を行い、売上アップや新規プレイヤー獲得に貢献したいと考えているパートナー様で、以下のいずれかの商品(または両方)を統合した方は:

  • 仮想アイテムまたは仮想通貨モジュールを構成されたゲーム内ストア
  • ゲームキーモジュールを構成されたBuy Button

入手方法

統合フロー

  1. バンドルをセットアップします。
  2. カタログでバンドルの取得を実装します。

バンドルをセットアップする

以下のいずれかの方法でバンドルをセットアップします:

パブリッシャーアカウント経由のセットアップ

  1. パブリッシャーアカウント > ストア > バンドルに移動して、バンドルを作成するをクリックします。
  2. バンドルには以下のパラメーターを指定します:
    1. イメージ
    2. 名前
    3. 説明
    4. 内容
    5. 価格
    6. 店内表示
  3. 設定をチェックして、保存をクリックします。

APIメソッド経由のセットアップ

バンドルをセットアップするには、AdminサブセクションのBundlesメソッドグループのメソッドを使用します。

注意
Adminサブセクションのメソッドは、フロントエンド側のストアでカタログを構築するために作成されたものではありません。ランディングページ、ウェブストア、ゲーム内ロジックに使用してください。

バンドルにゲームキーを追加する

選択したプラットフォームのゲームキーをバンドルに追加するには、必要なプラットフォームのSKUを持つ配列をCreate bundleまたはUpdate bundleメソッドに渡します。

Copy
Full screen
Small screen
"content": [{
     “sku”: “brilliant_game_sku_steam”,
     “quantity”: 1
  }
]

地域制限をセットアップする

バンドルに地域制限を設定するには、サポートされている地域のIDを持つ配列をCreate bundleまたはUpdate bundleメソッドに渡します。

お知らせ
APIメソッドを使用してプロジェクトにリージョンを設定するか、アカウントマネージャーに連絡して設定してください。
Copy
Full screen
Small screen
"regions": [{
     “id”: “123”
  }, {
     “id”: “456”
  }
]

地域別の価格を設定する

バンドルの地域価格を設定するには、Create bundleまたはUpdate bundleメソッドに、地域の価格設定を持つオブジェクトの配列を渡します。

お知らせ
APIメソッドを使用してプロジェクトにリージョンを設定するか、アカウントマネージャーに連絡して設定してください。
Copy
Full screen
Small screen
"regional_prices": [{
     “region_id”: “123”,
     “country_iso”: “CHN”,
     “amount”: 40,
     “currency_iso”: “CNY”,
     “is_default”: true,
     “is_enabled”: true
  }
]

カタログでバンドルを取得する

バンドルのカタログを取得するには、CatalogサブセクションのBundlesメソッドグループのメソッドを使用します。

お知らせ
Catalogサブセクションからのメソッドは、フロントエンド側のストアでカタログを作成するために作成されます。認証は必要ありません。
この記事は役に立ちましたか?
ありがとうございます!
改善できることはありますか? メッセージ
申し訳ありません
この記事が参考にならなかった理由を説明してください。 メッセージ
ご意見ありがとうございました!
あなたのメッセージを確認し、体験を向上させるために利用させていただきます。
このページを評価する
このページを評価する
改善できることはありますか?

答えたくない

ご意見ありがとうございました!
最終更新日: 2022年11月25日

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

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