バンドル
どのように動作するか
バンドルとは、複数のアイテムを1つにまとめて販売するセットのことです。
主な特徴：
- さまざまなタイプのアイテムをバンドルに追加します：
- 仮想通貨（プラットフォームに依存する通貨を含む）
- 仮想通貨パッケージ
- 事前に選択されたプラットフォームのゲームキー
- 期間限定アイテムを含む仮想アイテム
- バンドル
- 実際通貨と仮想通貨のバンドル価格を構成します。
- 無料バンドル。
- 購入できるバンドル数を制限します。
- ストアでのバンドルの表示時間を制限します。
バンドルは、購入に成功すると自動的に解凍されます。バンドルに別のバンドルが含まれている場合、含まれているバンドルは自動的に独立したアイテムに分離されます。
アンパックされたバンドルからのアイテムの配信方法は、アイテムのタイプによって異なります：
- 仮想通貨パッケージ、仮想アイテム、期間限定アイテム、またはバンドルは以下へ配信されます:
- インベントリ（デフォルトメソッド）
PlayFab 、統合を構成する場合
- ゲームキーは以下へ配信されます:
- メール（デフォルトメソッド）
PlayFab 、統合を構成する場合
購入者が取引をキャンセルするなどしてバンドルを返却すると（例えば）、バンドルから付与されたすべてのアイテムが自動的にユーザーから引き出されます。ユーザーがアイテムの一部を使用した場合でも、残りのアイテムは撤回されます。
制限：
- 以下の項目をバンドルに追加することはできません：
- 同じバンドル
- 物理的な商品
- 空のバンドルを作成することはできません。
- バンドルセールはキーを使い切ってから一時停止しており、これらのキーはバンドルに含まれています。
- バンドル価格は、実際通貨および／または仮想通貨の固定値です。
- バンドルの地域制限は、APIを介してのみ構成できます。
購入できるバンドル数を制限する
バンドル購入の制限をすることができます。例えば、以下の制限することができます：
- 1ユーザーあたりのバンドル数
- 一度しか購入できないウェルカムバンドル
ユーザーが指定された上限に達している場合、バンドルはカタログに表示されません。バンドルに購入制限のある仮想通貨パッケージやアイテムが含まれていて、ユーザーがすでに許容量に達している場合、そのバンドルはカタログに表示されません。
ユーザーが利用できる最大バンドル数および残りのバンドル数を表示することができます。
アドミンページでバンドルを作成する時に購入制限を設定するには、1人のユーザーがこのバンドルを購入できる回数を制限するのトグルをオンに切り替え、バンドル購入可能回数を指定します。
バンドルに関する情報を取得するには、バンドルメソッドグループからカタログサブセクションのメソッドを使用します。
応答では、バンドルに関する情報のほか、以下の情報を受け取ることができます：
- 1ユーザーが購入できる最大バンドル数
- ユーザーが購入可能なバンドル数の残数
制限を設定または更新する方法の詳細については、ユーザーの制限に関する説明を参照してください。
- json
{
"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 を使用してストアにバンドルを表示する時間制限を設定するには、バンドルを作成するまたはバンドルを更新するAPIコールで次のパラメータを渡します：
periods[0].date_fromはアイテムの表示期間の開始日時のYYYY-MM-DDThh:mm:ss±TMZ形式です。TMZはhh:mmGMT形式のタイムゾーンインジケーターです。periods[0].date_untilはアイテムの表示期間の終了日時のYYYY-MM-DDThh:mm:ss±TMZ形式です。TMZはhh:mmGMT形式のタイムゾーンインジケーターです。アイテムの表示期間の終了を示さないようにするには、nullを渡します。
ストアにバンドルを表示する期間を複数設定できます。これを行うには、バンドルを作成するまたはバンドルを更新するメソッドで、すべての期間の開始日と終了日を含むオブジェクトの配列を渡します。
例：
"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"
}
]
使用に適した方
バンドルに含まれる全アイテムの初期合計よりも安い価格でセット販売を行い、売上アップや新規プレイヤー獲得に貢献したいと考えているパートナー様で。
入手方法
統合フロー
- バンドルをセットアップします。
- カタログでバンドルの取得を実装します。
バンドルをセットアップする
以下のいずれかの方法でバンドルをセットアップします：アドミンページ経由のセットアップ
- アドミンページ > ストア > バンドルに移動して、バンドルを作成するをクリックします。
- バンドルには以下のパラメーターを指定します：
- イメージ
- 名前
- 説明
- 内容
- 価格
- 店内表示
- 設定をチェックして、保存をクリックします。
APIメソッド経由のセットアップ
バンドルをセットアップするには、バンドルメソッドグループのカタログサブセクションのメソッドを使用できます。バンドルにゲームキーを追加する
選択したプラットフォームのゲームキーをバンドルに追加するには、必要なプラットフォームのSKUを持つ配列をバンドルを作成するまたはバンドルを更新するメソッドに渡します。
- http
"content": [{
“sku”: “brilliant_game_sku_steam”,
“quantity”: 1
}
]
地域制限をセットアップする
バンドルに地域制限を設定するには、サポートされている地域のIDを持つ配列をバンドルを作成するまたはバンドルを更新するメソッドに渡します。
- http
"regions": [{
“id”: “123”
}, {
“id”: “456”
}
]
地域別の価格を設定する
バンドルの地域価格を設定するには、バンドルを作成するまたはバンドルを更新するメソッドに、地域の価格設定を持つオブジェクトの配列を渡します。
- http
"regional_prices": [{
“region_id”: “123”,
“country_iso”: “CHN”,
“amount”: 40,
“currency_iso”: “CNY”,
“is_default”: true,
“is_enabled”: true
}
]
カタログでバンドルを取得する
バンドルのカタログを取得するには、バンドルメソッドグループのカタログサブセクションのメソッドを使用できます。誤字脱字などのテキストエラーを見つけましたか？ テキストを選択し、Ctrl+Enterを押します。
