Create an Application in Tapjoy

1. Log in to the Tapjoy platform, click 'Application' and select 'Apps'., add an app by clicking on the top-right corner and select '+ Add App'.En-1.jpg

2. Define the settings of your app.tapjoy_en_2.jpg

  • Platform – iOS or Android.
  • App Name – Enter a custom name for your application.
  • Screen Orientation – Landscape, Portrait, Both.
  • Time Zone
  • Currency
  • Tapjoy Usage Case - Generally choose Full Use of Tapjoy's Mobile Impact Platform.
  • App Store URL
  • This app is not in the App Store yet - If your app is not yet available, please check this option.

Add Virtual Currency

If you need to use the Tapjoy virtual currency service, please fill in the relevant content according to the guide below. If you do not intend to use the Tapjoy virtual currency service, filling in any content will have no actual impact.

1. After the application is created, click on the upper right corner to enter the selection application, click MonetizationVirtual CurrencyCreate Virtual Currency.En-3.jpg

2. Enter the interface for creating virtual currency and fill in the information.tapjoy_en_4.jpg

  • Choose a currency hosting model:
    • Tapjoy Managed:
      • Developers can use Tapjoy's server to store the user's currency amount. This is a free service provided by Tapjoy for all developers who integrate the Tapjoy SDK, which saves the back-end work that usually needs to store user currency data for the App.
    • Self Managed:                                                            
      • Developers need to use their own servers to process the user's currency balance. This method allows you to better control the virtual currency, but it also means that the developer is fully responsible for the back-end work of storing and processing currencies for all users.

        Note: After creating virtual currency, you will not be allowed to delete it. Learn More.
  • Platform: iOS or Android.
  • Currency Name: Name the virtual currency, such as diamonds, gold coins, etc.
  • Currency Usage: You can customize the description of currency usage.
  • Exchange Rate: The exchange rate defines the amount of virtual currency that users receive for every dollar you earn through Tapjoy. Virtual currency does not support decimal values, and decimal rewards will be rounded to the nearest whole number. The recommended exchange rate is equal to or higher than $1 = 100.
  • Initial Balance: This represents the initial balance of the virtual currency that users have when they start using your app.
  • Does you app allow users to purchase any real world system of payment? : Misrepresentation (deliberate or otherwise) is a violation of the Tapjoy Terms of Services and will result in non-payment of earnings. No exceptions will be made.
  • Maturity Setting on the ads:
    • Everyone: Strictest filter. Only ads rated for everyone
    • Low: Includes ads rated Low Maturity and Everyone, but not Medium, High, or Mature
    • Medium: Includes ads rated Medium Maturity, Low, and Everyone, but not High or Mature
    • High: Includes ads rated High Maturity, Medium, Low, and Everyone, but not Mature
    • Mature:21+(no filter) ad categories(gambling, alcohol, dating, political). Toggle to opt-in or block
  • Fixed Reward for Video(Optional): A fixed amount of rewards can be set for rewarded videos.


Add a Placement

Go to the Application drop-down in the upper-right corner. Select the application you created, go to the Monetization tab in the top menu and in the left side bar select 'Placements'.

1. Click the 'Create Placement' on the right side of the page.En-5.jpg

2. Enter the name and description for this placement and Click 'Create'.tapjoy_en_6.jpg


Create Content

1. Click Monetization, select Create Content in the left navigation bar.En-7.jpg

  • When creating a rewarded video ad, choose Rewarded video instead of Programmatic Rewarded Video.

  • When creating an interstitial video ad, please choose Interstitial Video instead of Programmatic Interstitial Video.

2. . Improve advertising content information.tapjoy_en_8.jpg

  • Deployment: Contents set to OFF will not deploy until you set them ON.

  • Content name: The naming needs to be exactly the same as the ad unit name.

  • Test: Only for Test Devices.

  • Virtual Currency: Please select platform first.

  • Exchange Rate: Exchange rate defines the amount of virtual currency your users receive for every $1 that you earn via Tapjoy. Virtual currency does not support fractional value. Fractional rewards will be rounded down to the nearest integer.

  • Reward Type: Use default rewards to allow dynamic offer-based rewards (most common); use fixed reward if the publisher requested a fixed reward regardless of offer.

  • Hide RewardUsers will see no messaging of the rewards for this placement, but will still receive them.

  • Default Sound Status : Set the default video sound status by selecting the option. Users can mute and unmute the video whichever is selected as a default.

  • Select Placement: Select the previously created advertising location.

  • Note: Your ad location and content name need to be consistent.


OpenMediation Platform Configuration

Ad Network

1. Enter the OpenMediation publisher platform, click on Ad Network → click Edit behind Tapjoy.En-9.jpg

2. After filling in the relevant information, click Save.


SDK Key & Publisher reporting API Key & Ad Reporting API Key:

a. Enter the Tapjoy platform, click on the account in the upper right corner and select the corresponding application.En-11.jpg

b. Click Settings → App Settings.En-12.jpg

c. Obtain the SDK Key from the Application Platforms below.En-13.jpg

d. Click on API Keys to get the Publisher Reporting API Key and Ad Reporting API Key.En-14.jpg

  • Currency: Select the corresponding currency unit in your AdColony report module.


Add Instance

1. Click MediationAd unitAdd Instance.En-15.jpg

2. After filling in the relevant information, click Save.En-16.jpg

  • Ad NetworkSelect Tapjoy.

  • Instance Name: You can define the name of your ad unit yourself, we suggest you name it:  Placement ID_Ad Network Name_ Country_Floor Price.(E.g: 6539_Tapjoy_USA_40)

  • Unit ID: On the Tapjoy platform, click on the account in the upper right corner → select the corresponding application → copy the name of the corresponding ad unit on the left side, which is the Unit ID.En-17.jpg


Tapjoy Test Mode

1. Enter the Tapjoy platform, click on the account in the upper right corner and select the corresponding application.En-18.jpg

2. Click Settings → App Settings → select Test DevicesCreate Test Device and enter your device name and IDFA or GAID.En-19.jpg

3. Click Monetization, select the Placements in the left navigation bar, click Edit in the ad unit (content) to be tested.En-20.jpg

4. Check the Only for Test Devices and Save.En-21.jpg

Be sure to turn off this option after the test is successful.


Add the Tapjoy SDK&Adapter to Your Build


1. Add the Tapjoy SDK

  • Add to your project-level build.gradle file.
allprojects {
  repositories {
      maven {
          url "https://sdk.tapjoy.com/"
  •  Add to your application-level build.gradle file inside dependencies section.
implementation 'com.tapjoy:tapjoy-android-sdk:+

2. Add the Tapjoy Adapter

    OpenMediation supports both Gradle dependencies and Manual download mechanisms.

       Gradle dependencies

  • Add the following in your application-level build.gradle file.
implementation 'com.openmediation.adapters:tapjoy:+'

       Manual download

  • Download the Tapjoy Adapter from here.
  • Add the Tapjoy Adapter to Your Project.

3. Update AndroidManifest.xml

  •  Configure Android Manifest.xml to add permissions.
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />


4. For Proguard Users Only
If you are using ProGuard with the Tapjoy adapter, you must add the following code to your ProGuard configuration (Android Studio: proguard-rules.pro or Eclipse: proguard-project.txt):

-keep class com.tapjoy.** { *; }
-keep class com.moat.** { *; }
-keepattributes JavascriptInterface
-keepattributes *Annotation*
-keep class * extends java.util.ListResourceBundle {
protected Object[][] getContents();
-keep public class com.google.android.gms.common.internal.safeparcel.SafeParcelable {
public static final *** NULL;
-keepnames @com.google.android.gms.common.annotation.KeepName class *
-keepclassmembernames class * {
@com.google.android.gms.common.annotation.KeepName *;
-keepnames class * implements android.os.Parcelable {
public static final ** CREATOR;
-keep class com.google.android.gms.ads.identifier.** { *; }
-dontwarn com.tapjoy.**



OpenMediation supports both Cocoapods and Manualdownload mechanisms.


To Integrate the Tapjoy SDK with Cocoapods, enter the following line in your podfile and you are good to go!

pod 'TapjoySDK'

Manual Download

1. Download the Tapjoy framework

  • you can find the lastest Tapjoy SDK here.

2. Add the Tapjoy frameworks to your Project

You are now all set to deliver Tapjoy Ads within your application.

Was this article helpful?
1 out of 1 found this helpful



Article is closed for comments.