Currencies

๐Ÿ’ฐCurrencies

The Tyr SDK supports multiple virtual currencies, allowing you to display campaign rewards across different currency types that match your app's economy (e.g., coins, gems, points, tickets).

๐Ÿ’ช๐Ÿผ How It Works

Each placement in your app can be associated with one or more virtual currencies. When a placementId is provided during SDK initialization, the SDK filters and returns all currencies available for that specific placement โ€” enabling users to see and earn multiple reward types simultaneously.

If no placementId is provided, the SDK will fall back to the default currency configured for your account.

๐Ÿ“Œ Placement-Based Multi-Currency

A single placement can expose multiple currencies at once. This is useful when your app rewards users across several in-game economies simultaneously.

Example: A placement can be configured to reward users in both coins and gems at the same time, so users see all applicable reward units in a single SDK session.

Placement ID
Currencies Available

1

๐Ÿช™ Coins

2

๐Ÿช™ Coins, ๐Ÿ’Ž Gems

3

๐Ÿช™ Coins, ๐Ÿ’Ž Gems, ๐ŸŽŸ๏ธ Tickets

(none)

Default account currency

circle-info

๐Ÿ’กPro Tip: Configure placements with multiple currencies to maximize reward relevance. Users are more engaged when they earn currencies tied directly to the in-game economy of the screen they're currently on.

Example Usage

Use the placementId parameter to load the SDK with all currencies available for that placement:

<!-- Load SDK for a placement that rewards users in both Coins and Gems -->
https://sdk.tyrads.com?token=<TOKEN>&placementId=1

๐Ÿ–ผ๏ธ Screenshots

Last updated