Tapjoy

This Guideline will instruct you step-by-step on how to set Tapjoy live as an ad network on the AdTiming Mediation platform.

Before You Start

Make sure you have correctly integrated AdTiming's Interstitial, Rewarded Video Ads in your application.

Important! The ADAPTERS for ad networks are modularized, which means that you need to download Not Only the SDK of mediation networks  you choose to work with But Also the adapters for those ad networks. Be sure to follow this Guide to mediation Tapjoy's Ads.

Step 1. Create an Tapjoy Account

  1. Create an account with Tapjoy. You can do so here.
  2. Click on the link in the confirmation email to verify your account. Once your account has been verified, you can log in to their partner login here.

Step 2. Create an Application in Tapjoy

1. Once you log in, add an app by clicking on the top-right corner and select '+ Add App'.

tapjoy_1.png

 

2. Define the settings of your app.

tapjoy_2.png

  • Platform – iOS or Android.
  • App Name – Enter a custom name for your application.
  • Screen Orientation – Landscape, Portrait, Both.
  • Time Zone
  • Currency
  • App Store URL

Step 3. 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.

tapjoy_3.png

 

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

tapjoy_4.png

 

Step 4. Add a Virtual Currency

You need to add a virtual currency to your Tapjoy account. All content units on Tapjoy must be associated with a virtual currency. Learn more on creating a Tapjoy Virtual currency on the Tapjoy Knowledge Center.

1. In the Monetization tab, navigate to the Virtual Currency section. Select the 'Create Virtual Currency' button on the top right.

tapjoy_5.png

2. The below window will appear.

tapjoy_6.png

tapjoy_7.png

 

  • Platform – iOS or Android.
  • Currency Name – E.g. coins, gold, chips, etc.
  • Currency Usage Description
  • Default Exchange Rate
  • Initial Balance – The currency amount your user is given when s/he starts using your app.
  • Callback URL or No_Callback – Self Managed currency only.

3. Click 'Create Now' and you will see your defined virtual currency as Enabled on your Virtual Currency dashboard.

tapjoy_8.png

 

Step 5. Add a Currency

You must add the relevant content card to the placement. Our mediation platform supports both Rewarded Video and Interstitial content for Tapjoy.

1. To add content to your placements, go to 'Monetization' on the top menu bar. Navigate to 'Create Content' on the left sidebar. You will then see the list of Tapjoy's Monetization products.

tapjoy_9.png

2. Select the relevant ad unit. (For example: Interstitial Video and Rewarded Video)

tapjoy_10.png

3. Complete details.tapjoy_11.png

  • Content Name
  • Description
  • Platform – if your app supports both platforms, create two separate content units for each platform.

tapjoy_12.jpeg

tapjoy_13.jpeg

 

Step 6. Configure Tapjoy’s Parameters into AdTiming Account

1. Once you have both of these parameters, log in to your AdTiming account and go to Mediation -> Ad Network Setup

 

2. Select Tapjoy from the list of Available Ad Networks

tapjoy111.jpeg

3. Fill in the 'Tapjoy Report Key' and the 'Tapjoy SDK Key' and click 'Save'.

tapjoy222.png

4. You will then see Tapjoy as Active for Mediation Status on your Setup list.

tapjoy333.png

Step 7. Add the Tapjoy SDK&Adapter to Your Build

Android

1. Add the Tapjoy SDK

  •   Add to your application-level build.gradle file.
dependencies {
...
implementation 'com.tapjoy:tapjoy-android-sdk:12.4.2@aar'
}

2. Add the Tapjoy Adapter

    AdTiming supports both Gradle dependencies and Manual download mechanisms.

       Gradle dependencies

  • Add the following in your project-level build.gradle file.
 ...
allprojects {
repositories {
...

jcenter()
maven {
url "https://dl.adtiming.com/android-sdk"
}
}
}
  • Add the following in your application-level build.gradle file.
 implementation 'com.adtiming.adapters:tapjoy:3.1.3@aar'

       Manual download

  • Download the Tapjoy Adapter from here.
  • Add the Tapjoy Adapter to Your Project
    Move the TapjoyAdapter-x.x.x.aar to the libs folder in your Android Project.

mceclip0.png

  • Make sure you add the following to your Gradle build file under the dependencies section:
implementation (name:'TapjoyAdapter-3.1.3', ext:'aar')

3. Update AndroidManifest.xml

  •  Configure Android Manifest.xml to add permissions.
 <uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.READ_PHONE_STATE" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
  • Configure Android Manifest.xml to add activities.
 <activity
android:name="com.tapjoy.TJAdUnitActivity"
android:configChanges="orientation|keyboardHidden|screenSize"
android:hardwareAccelerated="true"
android:theme="@android:style/Theme.Translucent.NoTitleBar.Fullscreen" />
<activity
android:name="com.tapjoy.TJContentActivity"
android:configChanges="orientation|keyboardHidden|screenSize"
android:hardwareAccelerated="true"
android:theme="@android:style/Theme.Translucent.NoTitleBar" />

 

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):

 -dontwarn com.tapjoy.**
-keep class com.tapjoy.** { *; }
-keep class com.google.android.gms.ads.identifier.** { *; }

 

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

 

 

 

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

Comments

0 comments

Please sign in to leave a comment.