For the complete documentation index, see llms.txt. This page is also available as Markdown.

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

๐Ÿ’ก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