May 2023 Release

Production Release Date: May 31

REST APIs

The following API changes are documented on https://api.bunchball.com/docs.

GET /users/{userId}/exchanges/{exchangeId}/recipients - Updated to return a new response structure when the preferences parameter is not set. When a preferences parameter is set, the old request structure is returned (for backward compatibility only).
GET /users - Updated to return additionalName.
User model - Updated to include additionalName. Any API with the User model response type now returns the additionalName parameter.

* API Discontinuation Notice *

Effective with the November 2023 release, we will deprecate and remove the following API and parameter from the platform. Update any code that uses these calls in advance of the November release.

GET /search - Update your code to call the API for the specific object you want to search on (for example, /actions, /challenges, etc.).
GET /users/{userId}/exchanges/{exchangeId}/recipients preferences parameter - Update your code to stop sending preferences with the API call.

Product Enhancements

Recognitions Block BETA Release

Introducing blocks, a new way to embed gamification elements on your site! We're excited to announce that our first block, Recognitions, is now available for beta testing! Contact Bunchball Support if you're interested in beta testing the Recognitions block.

The Recognitions block:

Is built using new CSS structure and technologies making it easier to embed and style.
Shows all the exchanges a user is eligible for in the same block.
Allows a user to send a recognition to multiple people in one submission.
Allows a user to send a recognition to multiple people with the same or different point amounts.

Recognitions Exchange Selection Page

Recognitions List View Example

New Point Category Options

You can now add a starting balance and a yearly maximum for a point category. These two options can be set when creating or editing a point category.

Initial Credits - The number of points a user is given as their starting balance in this point category when the user is added to Nitro.
Yearly Max Credits - The maximum number of points a user can earn in this point category in a calendar year (January - December).

Note: Web components do not indicate that a user has reached their yearly maximum. The user will see the points that can be earned for a mission, but they will not receive them if they've reached the yearly limit.

Data Import Points File Updates

When importing points in Data Import, you can now add a description and/or bill codes to the points record. See Batch File Requirements for details.

Example Points Import File

Product Fixes

Fixed an issue where you were unable to delete a group if the group was used in a mission with multiple prerequisites.
Fixed an issue where you were unable to select an action when building an actions leaderboard.
Fixed an issue where reporting did not return information correctly when a mission had double quotes in its description.

Documentation Updates

Added an example of leaderboard filtering to the Create a Leaderboard page.

* Report Discontinuation Notice *

Effective with the August 2023 release, we will deprecate and remove Chart reports from the analytics platform. Chart reports will not be available in Nitro Studio after August 2023. You can use Quick Insights to see report data in chart format.