Bounty activity

The bounty activity is used to allow a user to start a bounty. A bounty is a way for a user to offer points in exchange for another user's action. For example: take a question and answer situation or a discussion forum. When a user posts a question they can associate a number of points which are up for grabs to any user who answers the question in a way that the initial user deems satisfactory. Once a bounty is started, the user who started the bounty can cancel or award the bounty to another user. In many cases it's worth disabling the ability to cancel a bounty in order to avoid the bounty creator pulling the bounty after having had their question answered or their desired action fulfilled. The ability to cancel is left in for completeness.

Bounty stages and point changes

The different stages of a bounty activity will impact the points of the users involved in different ways. It is important to keep in mind that any change in a user's points will also be reflected on all the mechanics that track points, such as Leaderboards, KPIs and Levels. The list below describes in more detail the point changes associated with bounty activities:

Started: when a bounty is started, the user who started the bounty will have their total points decreased by the number of points associated to the bounty.
Cancelled: when a bounty is cancelled, the user who started the bounty will have their total points increased by the number of points associated to the bounty.
Awarded: when a bounty is awarded, the user to whom the bounty was awarded will have their point balance and total increased by the number of points associated to the bounty.

note

The bounty activity requires that the points being used be bountiable.

Example

Here's an example of a bounty activity data that creates a bounty for answering a question:

JSON

var bountyActivity = {
  uuid: "john@doe.com",
  url: "http://www.domain.com",
  reason: "Best answer wins the bounty!",
  attrs: {
    type: "bounty",
    points: [
      {
        pointId: "55cbb97a5d7fa839a2cc8f92",
        points: 100,
      },
    ],
  },
};

In this example:

The user creating the bounty is identified by the email 'john@doe.com'
The reason field explains what the bounty is for
The points array specifies which point type(s) to offer and how many

Bounty stages and point changes​

Example​

Related topics​

Bounty stages and point changes

Example

Related topics