Currency Settings

The Currency Settings page controls how BitLabs converts USD reward values into your platform currency and how those rewards are displayed to users.

You can configure your platform's underlying currency conversion, define the percentage of reward value passed on to users, and customize how the resulting reward appears across BitLabs experiences.

Important: Make sure your currency and reward settings accurately reflect your platform configuration before going live. These settings directly affect the reward values shown to users.

TL;DR: Basic Setup

For a simple BitLabs integration, you only need to configure a few settings to get started:

1. Base Currency Multiplier
   Enter your platform's normal USD conversion rate.
   Example: If $1 = 1,000 Points, enter 1,000.

2. User Reward Share
   Enter the percentage of the base value you want to pass on to users.
   Example: With a 60% reward share, BitLabs will use 600 Points per $1.

3. Currency Content
   Enter the name of your currency, such as Points, Coins, or Credits.

4. Overriding Rewards
   If you use the BitLabs SDK or iframe, you can usually leave this at the default value.
   If you use an API, select whether you change the reward values returned by BitLabs.

5. Offer Target Margin
   For most simple setups, leave this at 0%. BitLabs will then calculate your target margin from your User Reward Share.

Example

If your platform uses:

• $1 = 1,000 Points
• User Reward Share = 60%
• Currency Content = Points

BitLabs will automatically calculate an effective currency multiplier of:

$1 = 600 Points

That is enough for most standard integrations. The remaining settings are optional and can be adjusted if you need custom reward formatting or more advanced margin handling.

Detailed Information

Reward Preview

The Reward Preview at the top of the page shows an example of how a BitLabs reward will appear to your users based on your current configuration.

Use the preview to verify that the resulting reward amount and currency formatting match what users should see before saving or publishing changes.

Currency Multiplier Settings

The Currency Multiplier Settings determine how USD values are converted into your platform currency and how much of that value is ultimately passed on to the user.

Base Currency Multiplier

The Base Currency Multiplier represents the underlying conversion rate between USD and the currency, points, or other reward units used on your platform.

For example, if:

$1 = 1,000 Points

configure the Base Currency Multiplier as:

$1 = 1,000

This value should represent your platform's conversion rate before applying your user reward share.

User Reward Share

The User Reward Share defines what percentage of the base currency value should be passed on to the user.

For example, if your platform uses:

• Base Currency Multiplier: $1 = 1,000 Points
• User Reward Share: 60%

BitLabs calculates:

1,000 × 60% = 600 Points

The user-facing BitLabs currency multiplier is therefore 1$ = 600 Points.

Your User Reward Share should reflect the portion of the available reward value you intend to give to the user. The remaining percentage represents your intended margin.

Effective BitLabs Currency Multiplier

The Effective BitLabs Currency Multiplier is calculated automatically from your Base Currency Multiplier and User Reward Share.

The calculation is:

Base Currency Multiplier × User Reward Share = Effective BitLabs Currency Multiplier

For example:

1,000 × 60% = 600

BitLabs will therefore use $1 = 600 Points when calculating applicable user rewards.

You do not need to calculate or configure this value manually.

Keeping the Base Currency Multiplier and User Reward Share accurate gives BitLabs visibility into your intended reward structure and margins. This is particularly useful for reward optimization across offer and gaming campaigns.

Overriding Rewards

The Overriding Rewards setting tells BitLabs whether your integration uses the reward values returned by BitLabs or replaces them with independently calculated values on your side.

This setting is primarily relevant when using a BitLabs API integration.

Select the option that best describes your implementation:

• If you use the reward values returned by BitLabs without changing them, indicate that you leave rewards as provided.
• If your system recalculates or replaces the reward before presenting it to the user, indicate that you override rewards.

If you use the BitLabs SDK or iframe Offerwall, you can generally ignore this setting because BitLabs controls the displayed reward values directly.

Providing accurate override information helps BitLabs understand the reward users actually receive and allows us to better optimize campaigns against your intended margins.

Offer Target Margin

The Offer Target Margin defines your overall margin goal for offers and games.

Use this setting when your User Reward Share does not accurately represent the margin you want to achieve across offer and gaming campaigns. This can happen, for example, if your User Reward Share must remain at 100% or if rewards are adjusted elsewhere in your integration.

If you enter a value above 0%, BitLabs will use this as your target margin for offers and games.

If the field is set to 0%, BitLabs will automatically derive the target margin from the inverse of your User Reward Share.

For example:

• User Reward Share: 60%
• Offer Target Margin: 0%
• Effective target margin: 40%

If you instead set the Offer Target Margin to 30%, BitLabs will use 30% as your target margin regardless of the configured User Reward Share.

This setting does not directly change the rewards shown to users. It provides BitLabs with your intended overall margin goal so we can better optimize offer and gaming campaign performance.

Use Image URL

Enable Use Image URL if you want to display an image or icon for your currency instead of a text-based currency name.

When enabled, provide the URL of the currency image in Currency Content.

The image must be hosted on a publicly accessible server that can be reached by BitLabs and your users.

If disabled, Currency Content is treated as text.

Currency Content

The Currency Content setting determines how your currency is displayed alongside reward amounts.

For a text-based currency, enter the name of your currency, for example:

Points

Depending on the integration and display, this could result in a reward such as:

Points600

You can also use the {value} placeholder when you need explicit control over where the reward amount appears.

For example:

{value} Points

would display:

600 Points

instead of placing the configured currency content before the amount.

If Use Image URL is enabled, enter the URL of your hosted currency image instead.

Hide Decimals

Enable Hide Decimals to display reward amounts without decimal places.

When enabled, BitLabs rounds reward values down to the nearest whole currency unit.

For example:

12.8 Points → 12 Points

Be careful when using this setting with a low currency multiplier. Small rewards can round down to 0, which may cause users to see a zero-value reward.

Hide Reward Value

Enable Hide Reward Value if you do not want BitLabs to display reward amounts to users.

In most integrations, we recommend keeping this setting disabled so users can clearly see what they can earn.

Reward values for Magic Receipts are not affected by this setting.

Bonus Percentage

The Bonus Percentage allows you to increase the currency multiplier specifically for survey rewards.

For example, configuring:

0.5

increases survey rewards by 50%.

This adjustment applies to surveys only and does not change the standard currency multiplier used by other BitLabs demand sources.

Different Conversion Rates for Different Demand Sources

By default, the same currency configuration applies to the demand sources available within an app.

If you want to use substantially different conversion rates or reward strategies for different demand sources—for example:

• one reward rate for surveys
• another reward rate for offers or games
• a different configuration for another product experience

you can create multiple BitLabs apps/offerwalls and configure their Currency Settings independently.

This lets each experience use its own Base Currency Multiplier, User Reward Share, and resulting Effective BitLabs Currency Multiplier.

For additional information about how rewards and publisher payouts work for offer and gaming campaigns, see the CPI & CPE Revenue Models documentation.