Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
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
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified assets/platform/emails/choose_template.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file not shown.
Binary file added assets/platform/emails/email_font_setting.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
14 changes: 11 additions & 3 deletions experimentation/trophy-impact-score.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,13 @@ icon: percent

## What Is The Trophy Impact Score?

By default, Trophy only enrolls 90% of your users in any gamification emails. It leaves the other 10% out as a 'control cohort'.
Trophy has a built-in A/B testing feature that allows you to test the impact of your gamification features on retention and engagement.

Through manipulating the [Control Ratio](#customizing-the-control-ratio), you can assign a certain percentage of your users to a 'control cohort'. Each new user that you tell Trophy about will be automatically assigned to the control cohort or not based on this setting.

Trophy then exposes the `control` attribute through the [GET user API](/api-reference/endpoints/users/get-a-single-user#response-control) to allow developers to hide gamification UI and features from users in the control cohort.

Similarly, if you use the [Emails](/platform/emails) feature, Trophy only sends emails to users who are not in the control cohort.

Trophy then automatically tracks the 14-day retention of the two cohorts and compares them, resulting in the Trophy Impact Score.

Expand All @@ -28,11 +34,13 @@ The Trophy Impact Score reflects the percentage difference in 14-day retention b
cohort.
</Tip>

## Customizing the control ratio
## Customizing The Control Ratio

By default, Trophy will use a 90/10 ratio of non-control/control users. However, you can customize this as you wish.

If you'd prefer to use a different ratio of control to non-control users then you can do so on the [Integration](https://app.trophy.so/integration) page.

Use the slider to change the percentage of your userbase that will be set as control users and opted out of gamification emails.
Use the slider to change the percentage of your userbase that will be set as control users and opted out of gamification features.

<Frame>
<video
Expand Down
33 changes: 24 additions & 9 deletions platform/emails.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -9,9 +9,9 @@ Trophy can send automated emails to users based on key triggers without requirin

## Types Of Emails

Trophy supports 3 types of emails, each of which is designed to suit a common scenario in building gamification experiences.
Trophy supports 4 types of emails, each of which is designed to suit a common scenario in building gamification experiences.

All emails are optional, but all three can be used simultaneously and can be controlled from the [Emails](https://app.trophy.so/emails/configure) page in the Trophy dashboard.
All emails are optional, but all four can be used simultaneously and can be controlled from the [Emails](https://app.trophy.so/emails/configure) page in the Trophy dashboard.

<Frame>
<img height="200" noZoom src="../assets/platform/emails/email_types.png" />
Expand All @@ -37,6 +37,10 @@ Emails are sent as follows:
- After 14 days of inactivity
- After 30 days of inactivity

### Streak Reminder Emails

Streak reminder emails are automatically sent to users up to 4 hours before they are about to lose their [Streak](/platform/streaks).

## Designing Emails

Trophy has a fully-featured block-based email builder that allows you to design templates, controlling all email copy and subject lines. Within the [Emails](https://app.trophy.so/emails/configure) page you can create templates and assign them to the 3 different [Email Types](#types-of-emails).
Expand Down Expand Up @@ -530,30 +534,41 @@ Additionally, the editor support pluralization. In the below example we show dif

## Email Customization

On the [Configure](https://app.trophy.so/emails/configure) page you'll find a couple of different settings you can control to manage email design across your Trophy account.
### Aggregation Period

<Frame>
<img
height="200"
width="75%"
noZoom
src="../assets/platform/emails/email_customization_settings.png"
src="../assets/platform/emails/aggregation_period_setting.png"
/>
</Frame>

### Aggregation Period
The aggregation period controls the timeframe over which blocks like the [Progress Chart](#progress-chart) display usage. It also controls the frequency at which [Recap Emails](#recap-emails) are sent. Possible values are daily, weekly, monthly or yearly.

The aggregation period controls the timeframe over which blocks like the [Progress Chart](#progress-chart) track usage. It also controls the frequency at which [Recap Emails](#recap-emails) are sent. Possible values are daily, weekly, monthly or yearly.
Head into the [Integration](https://app.trophy.so/integration) page to manage this setting.

### Font Style

Changes the font style used across all email templates. Additional styles are pulled from your Trophy account's [Branding](https://app.trophy.so/branding) settings.
On the [email configure page](https://app.trophy.so/emails/configure), you'll find a setting to change the font style used in all emails.

<Frame>
<img
height="200"
width="75%"
noZoom
src="../assets/platform/emails/aggregation_period_setting.png"
/>
</Frame>

Other email styles are pulled from your Trophy account's [Branding](https://app.trophy.so/branding) settings.

## Send-time Optimization

By default all emails sent by Trophy are sent at **17:00PM ET**, however sending emails to users based on their local timezone usually results in better engagement rates.
In most cases, emails sent by Trophy are sent at **17:00PM ET**, however sending emails to users based on their local timezone usually results in better engagement rates.

That's why if through [User Identification](/platform/users#param-tz) you specify a timezone for each user, Trophy will optimize the send-time for you.
That's why if through [User Identification](/platform/users#param-tz) you specify a timezone for each user, Trophy will optimize the send-time for you by sending emails to users at 17:00PM in their local timezone.

## Setting up Emails

Expand Down