バンドル

どのように動作するか

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

主な特徴：

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

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

成功する購入
インベントリ管理方法を経由してプレイヤーのインベントリに付与することに成功しました

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

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

仮想通貨パッケージ、仮想アイテム、期間限定アイテム、またはバンドルは以下へ配信されます:
- インベントリ（デフォルトメソッド）
- PlayFab、統合を構成する場合
ゲームキーは以下へ配信されます:
- メール（デフォルトメソッド）
- PlayFab、統合を構成する場合

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

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

制限：

以下の項目をバンドルに追加することはできません：

同じバンドル
物理的な商品

空のバンドルを作成することはできません。
バンドルセールはキーを使い切ってから一時停止しており、これらのキーはバンドルに含まれています。
バンドル価格は、実際通貨および／または仮想通貨の固定値です。
バンドルの地域制限は、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つのタブでバンドルを購入した後、エクソーラは同じバンドルの未払い注文をすべて無効にします。

ストアでのバンドルの表示時間を制限する

ストア内のアイテムの表示期間を次のように設定できます。

ホリデーセール中など、特定の時間帯にカタログの関連性を維持する
カタログに表示せずに事前にバンドルを作成する
アイテムの横にタイマーを表示して、ユーザーがバンドルを購入するように動機付ける

サイトビルダーを使用してカタログインターフェイスを作成すると、タイマーが自動的に表示されます。独自のインターフェースでカタログを作成するときは、タイマーを実装する必要があります。

アドミンページでストアにバンドルを表示する時間制限を設定するには、「期間」を選択し、タイムゾーン、期間の開始日と終了日を指定します。バンドル表示期間の終了を示さないようにするには、「終了日なし」ボックスにチェックを入れます。

API を使用してストアにバンドルを表示する時間制限を設定するには、Create bundleまたはUpdate bundle APIコールで次のパラメータを渡します：

periods[0].date_fromはアイテムの表示期間の開始日時のYYYY-MM-DDThh:mm:ss±TMZ形式です。TMZはhh:mm GMT形式のタイムゾーンインジケーターです。
periods[0].date_untilはアイテムの表示期間の終了日時のYYYY-MM-DDThh:mm:ss±TMZ形式です。TMZはhh:mm GMT形式のタイムゾーンインジケーターです。アイテムの表示期間の終了を示さないようにするには、nullを渡します。

ストアにバンドルを表示する期間を複数設定できます。これを行うには、Create bundleまたはUpdate bundleメソッドで、すべての期間の開始日と終了日を含むオブジェクトの配列を渡します。

例：

Copy

Full screen

Small screen

"periods": [
      {
        "date_from": "2022-06-10T14:00:00+03:00",
        "date_until": "2022-06-30T14:00:00+03:00"
      },
       {
        "date_from": "2022-07-10T14:00:00+03:00",
        "date_until": "2022-07-30T14:00:00+03:00"
      },
       {
        "date_from": "2022-08-10T14:00:00+03:00",
        "date_until": "2022-08-30T14:00:00+03:00"
      }
]

使用に適した方

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

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

入手方法

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

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

アドミンページ経由
APIメソッド経由

アドミンページ経由のセットアップ

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

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サブセクションからのメソッドは、フロントエンド側のストアでカタログを作成するために作成されます。認証は必要ありません。

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

あなたのメッセージを確認し、体験を向上させるために利用させていただきます。

このページを評価する

答えたくない

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

最終更新日: 2023年10月10日

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

Your browser is not supported. Please try a different browser

ゲームキーの直接販売

バンドル

どのように動作するか

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

ストアでのバンドルの表示時間を制限する

使用に適した方

入手方法

統合フロー

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

アドミンページ経由のセットアップ

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

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

この記事は役に立ちましたか？

このページを評価する

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