Rolling offers
What's new
The API now returns rolling offers, a new kind of item that walks the player through a sequence of
cards. The item type accepts a new rolling value, store items gain a rolling_offer object type,
and a new RollingRead schema describes the offer itself.
Impact
Rolling offers can show up anywhere the API returns an item or a store item. RollingRead carries
the usual item fields (name, price, images, SKU) plus a settings object with the list of
rolling_items (at least two), each with its own quantity, free-item flag, discount, badge, and
bonus items. Settings also hold the block background and an optional schedule for cyclic
restarts. effective_at records when player progress in the offer was last reset.
Changes
| Resource | Change |
|---|---|
| get_items | Added RollingRead to the item variants in the response and the rolling value to the item type |
| get_store_items | Added RollingRead to the store item item variants and the rolling_offer value to object_type |
| get_all_store_items | Added RollingRead to the store item item variants and the rolling_offer value to object_type |
| create_store_item | Added RollingRead to the store item item variants and the rolling_offer value to object_type in the response |
| bulk_update_store_items | Added RollingRead to the store item item variants and the rolling_offer value to object_type in the response |
| update_store_item | Added RollingRead to the store item item variants and the rolling_offer value to object_type in the response |
| create_item, update_item, bulk_create_or_update_items, bulk_update_items | Added the rolling value to the item type in the request and response |
| get_item, translate_item | Added the rolling value to the item type in the response |
| Coupons, daily rewards, loyalty tiers, and get_player_store_items | Added the rolling value to the type of nested, bonus, and reward items in responses |
| Components | Added the RollingRead, RollingOfferSettings, and RollingItem schemas. Added rolling to ItemType and rolling_offer to StoreItemObjectType and ItemSource |
Upgrade
- If you parse item
type, store itemobject_type, or the itemsource, handle the newrollingandrolling_offervalues, or fall back gracefully on values you don't recognize. - If you deserialize store items into a fixed set of item variants, add
RollingRead. Itsmodel_typeisRollingRead.
Need help?
Contact our integration team at [email protected]