Bonus choices in bundles
What's new
Items take a new optional nested_items_choices object that defines bonus slots the player fills
before purchase. The bundle's nested_items are still always delivered. The choices come on top.
Impact
nested_items_choices has two required fields:
groups: 1 to 20 groups of bonuses. Each group has akey(lowercase letters, digits, and dashes, up to 32 characters, unique within the bundle) and 1 to 100itemsto pick from, each with its count and an optional quantity expression.slots: 1 to 20 group keys, in slot order. Each slot lets the player pick one bonus from the group behind it.
Responses that expose items to players, such as the nested items of daily rewards, use a public variant of the object where the items' quantity expressions are hidden.
Changes
| Resource | Change |
|---|---|
| create_item | Added optional nested_items_choices to the request and response |
| update_item | Added optional nested_items_choices to the request and response |
| bulk_create_or_update_items | Added optional nested_items_choices to each item in the request and response |
| bulk_update_items | Added optional nested_items_choices to each item in the request and response |
| get_items, get_item, translate_item | Added nested_items_choices to the response |
| get_daily_rewards, create_daily_reward, get_daily_reward, update_daily_reward, copy_daily_reward | Added nested_items_choices, without quantity expressions, to reward items in the response |
| get_coupons, create_coupon, bulk_update_coupon, get_coupon, update_coupon, get_user_coupons | Added nested_items_choices to coupon items in the response |
| get_loyalty_tiers, update_loyalty_tiers | Added nested_items_choices to tier items in the response |
| get_store_items, get_all_store_items, create_store_item, bulk_update_store_items, update_store_item | Added nested_items_choices to bonus_items in the response |
Upgrade
- No action is required. Bundles without
nested_items_choicesbehave as before. - To let players pick bonuses, set
nested_items_choiceson the bundle with at least one group and one slot that points to it.
Need help?
Contact our integration team at [email protected]