Rewards

Rewards can be added to Links and Messages as an incentivization or prize. These may be personalized and customized for specific situations and applied using Audience criteria.

Items and Currency

Your engineering team can assign items and currency within the code. Once they have released the update, you can begin using these rewards. You must have the exact name used in the code to set it up.

Setting up a new item or currency

  1. On the left rail, select "Rewards"

  2. Navigate to the "Items & Currencies" tab

  3. If you do not see what you’re looking for, add it by clicking the "New Item or Currency" button

  4. Give it a display name, and fill in the Internal ID from the name used in the code

Once setup, you will be able to slect this currency when creating Reward Bundles.

Display names are for your reference only — they don’t appear in messages or link copy.

Bundle creation

Bundles are reusable reward configurations. Once you create a bundle for, say, 1,000,000 coins, you can attach that same bundle to any message or link. You never have to recreate the same reward twice.

Setting up a bundle

  1. Select "Rewards" from the left rail

  2. Click the "New Reward Bundle" button

  3. Give your bundle a name

  4. Select the Reward Type and set an amount

  5. Click "Save"

You can add multiple reward types, create a random distribution, segment rewards by audience with tiered rewarding, or a combination of these options.

Randomized rewards

A bundle can randomly select from a list of potential rewards. This lets you offer players a chance at a particularly valuable reward while keeping your average payout predictable. For example, a drop table that ranges from 1M to 100M coins can have the same average payout as a fixed 5M coin bundle. This is also a useful way to add a dynamic element to your messaging, encourging players to continue engaging to see what they’ve won.

To configure a bundle with randomized rewards:

  1. Check the "Use Random Rewards" checkbox

  2. Add an entry for each potential reward.

    For example, to create a bundle that selects from 10k, 50k, or 100k coins, add three "Coins" entries with the respective amounts

  3. Assign the odds of winning to each entry. The odds must sum to 100%.

    For example, the Bundle could have a 60% chance of giving 10k coins, a 30% chance of giving 50k coins, and a 10% chance of giving 100k coins

Average claim amount

Teak calculates the average amount each claim is worth. This is the number to check for economy balancing. It tells you what you’re giving out on average per claim, regardless of how the odds are distributed across options.

In the example above, each claim is worth on averge 31k coins. No player will receive exactly 31k coins, but if 10 players claim the reward from this Bundle you will give out approximately 310k coins total.
Personalization

When using a bundle with randomized rewards you can template the minimum or maximum reward amount into notification or email text with a Custom Tag.
When "Use Random Rewards" is on, Teak picks one reward option per claim based on weighted chances. When it’s off, players receive every reward in the bundle — all items and all amounts.

Tiered rewarding

Tiered rewarding lets you send one notification or email to a broad audience while giving different rewards to different player segments — for example, giving more in-game currency to players who have spent than to players who have never purchased, without creating separate messages for each group.

Setting up tiered rewarding

  1. Create your audiences. This includes broad audience you’re targeting, plus any segments for reward tiers. For details on setting up audiences, see Audiences.

  2. Select "Rewards" on the left rail

  3. In the "Reward Bundles" tab, click the "New Reward Bundle" button

  4. Check the "Use Reward Tiers" checkbox

  5. Click "Add Reward Tier" and select an audience for that tier

  6. Add the rewards players in that audience should receive

  7. Use the reorder buttons to place your most specific audiences at the top — Teak evaluates tiers in order and stops at the first match for individual players

  8. Repeat for each additional tier; the default "All remaining claimants" tier catches anyone who doesn’t match

Combining tiers and randomized rewards

You can enable both "Use Reward Tiers" and "Use Random Rewards" on the same bundle. Teak evaluates tiers first to select the reward set for that player, then randomizes within that set. Each tier can have its own reward options and independent odds. This lets you offer your VIPs better minimum and maximum rewards than other players, for example.

Archiving a bundle

Archiving removes a bundle from the active list without deleting it. Use this to retire seasonal or outdated bundles while keeping them available for reference or reuse.

To archive: Open the actions menu for the bundle and select Archive.

To restore: Open the Filter dropdown, enable "Show archived", find the bundle, and click Restore.

If a bundle is attached to an active message or link, Teak won’t delete it — it will offer to archive it instead.

Testing a bundle

Test a bundle to verify the right tier resolves and the reward payload is correct before attaching it to a live message.

  1. Open the actions menu for the bundle and select Test

  2. Under "Test Reward for Audience", select the tier to simulate. By default, the base catchall tier "Everyone Else" will be selected

  3. Enter the User ID — the game-assigned ID of the player who should receive the reward

  4. Set Posting User ID to 0 for app-to-player notifications, or to the sharing player’s ID for social rewards

  5. Select any applicable Extra Flags (is_mobile, is_unity_webgl)

  6. Click Test

Teak sends a real POST request to your reward endpoint. The dialog shows the full request and your server’s response.

Verifying reward collection

The Audit Log shows successful and failed responses from your server after Teak sends a reward request. This is useful for QA and customer support.

Audit log

  1. Select "Rewards" on the left rail

  2. Choose the "Audit Log" tab

  3. In the "Clicking User ID" box, enter the unique identifier you use to identify players within Teak

  4. Use the Status filter to narrow to Successes or Failures

  5. Set the date range

  6. Search

Results will show:

  • Time: when the player initiated receipt of the reward

  • Identifier: the name of the message or link clicked

  • Reward: the item or currency and amount

  • Server Response: the success or failure response from the server