# How bounties work

Bounties provide you with a means to reward creators that are part of your Referral Program for their referrals, Nexus sales, or even for playing your game.

Initially, Nexus creates and manages Bounties on your behalf; eventually you will be able to create and manage your own. To get started defining your Bounties, please contact your account manager or ask in a shared Slack or Discord channel.

## Bounty properties

| Property | Description |
| --- | --- |
| Name | Name of the bounty |
| `imageSrc` | URL of the thumbnail image for this bounty |
| Description | Description of the bounty |
| Reward Description | Text description of the bounty rewards |
| Limit | How many times the bounty may be completed (infinite if not set) |
| `startsAt` | Date/time that the bounty becomes available |
| `endsAt` | Date/time that the bounty ends |
| Prerequisites | Bounties that must be completed at least once before this bounty is available |
| Objectives | Requirements for completion |
| Rewards | Rewards offered upon completion |

### Objectives

A bounty may have any number of objectives. Each objective has a type and condition which describe its requirements for completion.

#### Objective types

<Tabs syncKey="bounty-objective-type">
<TabItem label="Referral">
A referral objective completes when the creator receives a specified number of referrals.

![A bounty objective card to refer five players, showing the reward and progress toward completion.](../../../../assets/docs/additional-features/bounties/overview/bounty-refer-players-objective.webp)
</TabItem>

<TabItem label="Event">
An event objective completes after Nexus receives a specific number of events for a given Creator Group Event Code. These objectives reward in-game progress, for either Referral or Creator events.

#### Referral event objectives

A Referral Event objective progresses when Nexus receives Creator Group Events originating from a user that has referred a creator.

![A bounty objective that progresses when a referred player reaches a milestone, such as reaching level 20.](../../../../assets/docs/additional-features/bounties/overview/bounty-referred-player-milestone.webp)
*When a Creator Group Event is received that represents a player "Reaching level 20," it will apply progress to the objective shown above for the creator that referred the player.*

#### Creator event objectives

A Creator Event objective progresses when Nexus receives Creator Group Events that originate from the creator themselves in game.

![A bounty objective that progresses when the creator themselves reaches a milestone, such as reaching level 20.](../../../../assets/docs/additional-features/bounties/overview/bounty-creator-self-milestone.webp)
*When a Creator Group Event is received that represents a player "Reaching level 20" and that player is the creator themselves, it will apply progress to the objective shown above.*
</TabItem>

<TabItem label="Nexus Purchase">
A Nexus Purchase objective completes when the creator makes a specified number of sales on their Nexus storefront. A Nexus purchase objective type limits which purchases count toward it.

#### Category purchase objective type

SKUs sold on a Nexus storefront may be assigned a category and an objective. The "Category" purchase objective type counts only sales in a given category. For example, if the "Great Game" includes microtransaction SKUs that may be sold on a creator's Nexus, they would all be assigned a category of "Great Game." An objective with this category would progress with any purchase of a "Great Game" microtransaction SKU.

#### Publisher purchase objective type

Any SKUs you have for sale on Nexus are associated with your Publisher account. An objective with the "Publisher" purchase objective type progresses on a purchase of any of your SKUs.

#### SKU purchase objective type

An objective with the "SKU" purchase objective type progresses only on the purchase of a SKU in a specified list.

#### Examples

![A bounty objective that counts any sale in your Nexus, regardless of SKU, publisher, or category.](../../../../assets/docs/additional-features/bounties/overview/bounty-any-sale-no-sku-filter.webp)
*This bounty would count any sale in your Nexus, regardless of the SKU, publisher, or category.*

![A bounty objective that counts only sales of a single titled product in your Nexus.](../../../../assets/docs/additional-features/bounties/overview/bounty-single-sku-filter.webp)
*This bounty would count only sales of "Great Game" in your Nexus.*
</TabItem>

<TabItem label="Attribution">
An attribution objective completes when the creator receives a specified number of attributions, reaches a specific subtotal across attributions, or earns a specific amount of revenue share through attributions.

#### Examples

##### Quantity

![A bounty objective requiring the member to receive ten attributions of any amount or revenue share.](../../../../assets/docs/additional-features/bounties/overview/bounty-attribution-count-threshold.webp)
*This bounty requires the member to receive 10 attributions, of any amount or revenue share.*

##### Amount

![A bounty objective requiring the member to receive attributions totaling $100 in subtotal.](../../../../assets/docs/additional-features/bounties/overview/bounty-attribution-subtotal-threshold.webp)
*This bounty requires the member to receive attributions totaling $100 in subtotal.*

##### Revenue share

![A bounty objective requiring the member to receive $50 in revenue share from attributions.](../../../../assets/docs/additional-features/bounties/overview/bounty-revenue-share-threshold.webp)
*This bounty requires the member to receive revenue share from attributions totaling $50.*
</TabItem>
</Tabs>

#### Objective condition

An objective carries a condition of either `AND` or `OR`. A bounty can mix the two across its objectives.

* A bounty requires every `AND` objective.
* Where it has several `OR` objectives, any one of them satisfies that side.
* Where it has both, the bounty completes once the creator finishes all of the `AND` objectives and at least one of the `OR` objectives.

![A bounty objective counting sales of specific SKUs, requiring set quantities of each to complete.](../../../../assets/docs/additional-features/bounties/overview/bounty-multi-sku-requirements.webp)
*This bounty would count any sales of the SKUs "Great Game", "Great Game Microtransaction 1", and "Great Game Microtransaction 2". For completion of the bounty, the creator must sell 3 copies of "Great Game" and 3 copies of either "Great Game Microtransaction 1" or "Great Game Microtransaction 2."*

### Rewards

A bounty may have any number of rewards. A reward may be of type External, SKU, or Payment.

<Tabs syncKey="bounty-reward-type">
<TabItem label="External">
An external bounty reward is one you provide to the creator yourself, instead of Nexus handling it. For example, this reward type would be used in the event that a user would be automatically awarded some amount of in-game currency upon bounty completion, instead of having Nexus provide them with a key to redeem in-game.

When a creator completes a bounty with an external reward, Nexus notifies you by [webhook](/additional-features/webhooks/). The reward also appears in the response from any [Bounty Creator Progress API](/api/bounties/operations/getmemberbountiesbyid/) route.
</TabItem>

<TabItem label="SKU">
When a creator completes a bounty with a SKU reward, Nexus delivers a key they can redeem for the reward (in-game, Steam, and so on). They retrieve it the same way a buyer retrieves a key after purchasing a SKU from a Nexus store.
</TabItem>

<TabItem label="Payment">
A bounty with a payment reward generates a creator transaction for the payment amount. Nexus pays these bounty rewards in its normal monthly payment process.

You will be invoiced monthly for these payments.
</TabItem>
</Tabs>
