Skip to content
Merged
Show file tree
Hide file tree
Changes from 1 commit
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Binary file modified assets/platform/achievements/create_new_achievement.mp4
Binary file not shown.
Binary file modified assets/platform/achievements/upload_badge.mp4
Binary file not shown.
66 changes: 40 additions & 26 deletions platform/achievements.mdx
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
---
title: Achievements
description: Learn how to use Achievements in a gamified product experience with Trophy.
"og:description": Use multi-stage and one-off achievements to rewards users for continued progress and to encourage them to discover new parts of your app.
"og:description": Use multi-stage, one-off and streak achievements to rewards users for continued progress and to encourage them to discover new parts of your app.
icon: trophy
---

Expand All @@ -17,9 +17,9 @@ Here we'll have a look of the types of achievements you can build with Trophy, t

## Achievement Types

Trophy offers two types of achievements, [Multi-stage](#multi-stage) and [One-Off](#one-off), detailed below.
Trophy offers three types of achievements, [Multi-stage](#multi-stage-achievements), [One-off](#one-off-achievements) and [Streak achievements](#streak-achievements), detailed below.

### Multi-stage
### Multi-stage Achievements

Multi-stage achievements are tied to [Metrics](/platform/metrics) and are best used when you want to incentivize users to take the same action over and over again.

Expand All @@ -40,7 +40,7 @@ When achievements are unlocked, Trophy includes information about the unlocked a

<MetricChangeResponseBlock />

### One-off
### One-off Achievements

One-off achievements can only be completed once and are useful for rewarding users for taking specific actions.

Expand All @@ -54,6 +54,14 @@ One-off achievements serve as an easy way to reward users for completing any act

Just like multi-stage achievements, one-off achievements can also trigger automated [Emails](/platform/emails#achievement-emails) if configured.

### Streak Achievements

Streak achievements are directly tied to a user's [Streak](/platform/streaks) and are automatically unlocked when users reach a particular streak length.

You can create as many streak achievements as you like for increasing lengths of streak, for example 7 days, 30 days and 365 days to motivate users to use your app more and more.

Just like multi-stage and one-off achievements, you can add a custom name and assign a badge to streak achievements.

## Creating Achievements

To create new achievements, head to the [achievements page](https://app.trophy.so/achievements) in the Trophy dashboard and hit the **New Achievement** button:
Expand All @@ -70,32 +78,36 @@ To create new achievements, head to the [achievements page](https://app.trophy.s
</Frame>

<Steps>
<Step title="Choose a metric">
If you want to assign this achievement to a metric for use as part of multi-stage achievements, then choose a metric. Otherwise continue to the next step.
</Step>

<Step title="Enter a metric value">
If you're assigning this achievement to a metric as part of multi-stage
achievements then choose the value of the metric that should unlock this
Achievement. Otherwise continue to the next step.
<Step title="Enter a name">
Enter a name for the achievement. This will be returned from APIs and made available for use in emails and other areas of Trophy where appropriate.
</Step>

<Step title="Choose a name">
Choose a name for the achievement. This will be made available for use in
emails and other areas of Trophy where appropriate. If you're assigning this
achievement to a metric as part of multi-stage achievements this is optional
and defaults to `[count] [metric]` e.g. "100 words written".
<Step title="Choose a trigger type">
Choose how you want this achievement to be unlocked.

- Choosing **Metric** will mean the achievement will be automatically unlocked when the user's total reaches the achievement trigger value.

- Choosing **Streak** will mean the achievement will be automatically unlocked when the user's streak length reaches the achievement trigger value.

- Choosing **API Call** will mean the achievement will only be unlocked when explicitly marked as completed by your code through an API call.

</Step>

<Step title="Choose a key">
Choose a key for the achievement. This is a unique string that you'll use to
refer to the achievement when using APIs. Not required for multi-stage
achievements.
<Step title="Set up trigger">
Once you've chosen the trigger type for the achievement, you need to set up the trigger settings.

- If you chose the **Metric** trigger, you'll need to choose the metric you want the achievement to be related to.
Comment thread
cbrinicombe13 marked this conversation as resolved.
Outdated

- If you chose the **Streak** trigger, you'll need to set the streak length that should unlock the achievement.

- If you chose the **API Call** trigger, you'll need to choose a unique reference `key` you'll use the complete the achievement via the [API](/api-reference/endpoints/achievements/mark-an-achievement-as-completed).

</Step>

<Step title="Upload a badge _Optional_">
You can upload and assign a badge to the achievement that will be made
available in emails and other areas of Trophy where appropriate.
You can upload and assign a badge to the achievement that will be returned in
API responses and made available in emails and other areas of Trophy where
appropriate.
</Step>

<Step title="Hit save">
Expand All @@ -105,9 +117,9 @@ To create new achievements, head to the [achievements page](https://app.trophy.s

## Completing Achievements

If you're using Multi-stage Achievements, there's no need to explicitly _complete_ Achievements.
If you're using multi-stage Achievements, there's no need to explicitly _complete_ Achievements. Once you've set up [metric tracking](/platform/events#tracking-metric-events) in your code, all achievements linked to the metric will be automatically tracked.

Once you've [integrated](/platform/events#tracking-metric-events) the Metric into your platform, all achievements linked to it will be automatically tracked.
Similarly, if you're using streak achievements, all achievements related to the user's streak will automatically be unlocked when a user reaches the respective streak length.

However if you're using any one-off achievements, you will have to mark them as completed for each user as appropriate.

Expand Down Expand Up @@ -171,9 +183,11 @@ If you have multi-stage acheivements set up for any of your [Metrics](/platform/
## Frequently Asked Questions

<AccordionGroup>
<Accordion title="Should I use multi-stage or one-off achievements?">
<Accordion title="What type of achievements should I use?">
Use multi-stage achievements for rewarding users for taking the same action over and over again, and to incentivise them to do it more.

Use streak achievements for rewarding users for keeping their streak.

Use one-off achievements when you want to reward users for taking specific actions that they only need to take once.

</Accordion>
Expand Down