Documentation

Support

Virtual Currency Overview

Learn about Tapjoy Offerwall's self-managed and Tapjoy-managed virtual currencies to choose and configure the right one based on your app's needs.
Read time 3 minutesLast updated 3 hours ago

There are two ways to integrate virtual currency in your application when using Tapjoy’s products: Tapjoy managed currency and self-managed currency.

Tapjoy managed currency

Tapjoy Managed currency enables you to use Tapjoy’s servers to store your user’s currency amount. This is a free service provided by Tapjoy for all developers that integrate Tapjoy’s publisher SDKs. This eliminates the back-end work normally needed to store your user’s currency data for your application.

Self-managed currency

Self-managed currency is used when you are handling the currency balances of your users with your own servers. This method can give you more control with your user’s currency but it also means that you are completely responsible for the back-end work for storing and handling the currency amounts for all your users.

Choosing a Currency Management Type

Tapjoy prefers that you use a self-managed currency for many reasons but most of them come down to flexibility for the publisher.

Tapjoy Managed

Self Managed

Multiple Currencies
Mediation Compatibility
Control over user balance
Reward IDs for troubleshooting
Visibility into transactions
Easy Setup
Fewer SDK calls

Setting up Virtual Currency in the Tapjoy Dashboard

You will need to create a currency for each platform/app, so make sure you create a currency for your iOS and another currency for your android app.

Dashboard method

  1. Navigate to the app for which you want to create a virtual currency using the app list drop-down menu in the upper-right of the Tapjoy dashboard.
  2. Click the "Monetization" tab in the top navigation bar.
  3. Click "Virtual Currency" in the left menu bar.
  4. Click the "Create Virtual Currency" button on the upper right.
  5. Consider the following best practices as you fill out the form:
    • When setting your currency exchange rate, be sure to have enough "granularity" in your currency. If you set your exchange rate at
      2 = $1 USD
      , then this might impact your fill rate because many offers will not be worth even a single unit of your currency. We recommend at least
      100 = $1 USD
      .
    • You must select a currency type. Your virtual currency can be one of the following:
      • Managed currency: Tapjoy keeps the user’s balance on its own servers.
      • Self-managed currency: Tapjoy notifies your server of currency activity via a Callback URL, but you keep track of the balance yourself.
  6. Your currency should be enabled automatically by our system within 15 minutes. Until your currency is enabled, you will not see any ads from Tapjoy unless your device is a test device.
  7. Meanwhile, you can add your device as a "Test Device" to receive test ads. To do so, click on "Settings" > "App Settings" > "Test Devices" (in the left menu).

Integration Guide method

  1. Go to the Tapjoy Dashboard, and select the app for which you wish to create a virtual currency.
  2. Click the "Tools" menu in the top menu bar.
  3. Select "Integration Guide" from the drop-down menu to run the Dashboard Integration Guide.
  4. Click "Monetize Integration" from the upper menu row.
  5. Click "Virtual Currency" from the navigation bar below where it says "Get started on Monetize Integration".
  6. Click the red "+ Create Virtual Currency" button.
  7. Fill out the resulting form completely.
  8. When setting your currency exchange rate, be sure to have enough "granularity" in your currency. If you set your exchange rate at 2 = $1 USD, then this might impact your fill rate because many offers will not be worth even a single unit of your currency. We recommend at least 100 = $1 USD.
  9. Select which kind of currency you are using: with "Managed" currency, Tapjoy keeps the user’s balance on its own servers. A "Self-managed" currency is one where Tapjoy notifies your server of currency activity via a Callback URL, but you keep track of the balance yourself.
  10. Your currency should be enabled automatically by our system within 15 minutes.
  11. To exit the Integration Guide and return to the regular dashboard, click the red "Tapjoy" box in the upper left.