Before You Start

Step 1. Create an Tapjoy Account

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

To gain access to Tapjoy’s inventory withinironSource‘s Mediation platform, you must first add your app and set up Ad Zones in your Tapjoy account.

Add Your App

Log into your Tapjoy account.

If you are a new user on Tapjoy you will be presented with this window, and can simply select ‘Create App‘:

If you are a registered user, add an app by clicking on the top-right corner and select ‘+Add App‘:

Define App Settings

Platform – iOS or Android or both

Note: While Tapjoy allows you to create your app with both platforms, you will need a unique Tapjoy SDK Key per platform (iOS + Android) to enable it in yourironSource account. If you use a combined Dashboard on Tapjoy it will give you both an iOS and Android SDK key.

App Name

Orientation

Time Zone

Currency

Select ‘Create Now’ to finish.

Step 3. Add Placement, Virtual Currency and Content

Ad Placement

Once your application has been added, Tapjoy will create default placements for you. Placements are the ad zones to which Tapjoy delivers ads. This will thus be the placement in your app where Tapjoy’s Video or Interstitial will be triggered throughironSource‘s Mediation.Important!Placements must be user-initiated to work in conjunction withironSource‘s Mediation platform.

Go to the Monetization tab in the top menu and in the left side bar select ‘Placements‘.
Click on the settings icon on one of the default placements:

If you are using the auto created placements, you can rename the placement if you wish. Note that the placement name must later be inserted on theironSource Dashboard. If you are serving both Tapjoy’s Video and Interstitial, you will need two separate placements, one for Rewarded Video and another for Interstitial.

If you decide to create a new placement to work in conjunction withironSource‘s mediation platform, select ‘Create Placement’ on the right-hand side.

Enter the name and description for this placement and Click ‘Create‘.

Virtual Currency

Next, 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.

In the Monetization tab, navigate to the Virtual Currency section.

Select the ‘Create Virtual Currency’ button on the top right.

The below window will appear. Tapjoys recommends the Tapjoy Managed currency but if you choose to use the Self Managed option, we recommend inserting “NO_CALLBACK” in the “Callback URL or NO_CALLBACK” field, as this will avoid unnecessary currency calls as the ironSource SDK handles the rewarding for ads served through our mediation.

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

Targeting– leave this section as is.

Placement– select the relevant placement created to run in conjuction withironSource’s Mediation.

Schedule & Frequency– leave this section as is.

Virtual Currency– select the virtual currency created in the former step.

Note: Tapjoy Content Units must be associated with a virtual currency, even if you are usingironSource rewards to reward your users. Learn more on creating a Tapjoy Virtual currency on the Tapjoy Knowledge Center.

Reward OptionsWhen serving Tapjoy’s Rewarded Video or Interstitials through the ironSource Mediation platform, you should set the Tapjoy reward to zero and hide the reward message.

For Rewarded Video, this will ensure you don’t award the user twice and will prevent user confusion when seeing a Tapjoy generated message with a different reward amount.

For Interstitial, Interstitials you serve through our Mediation are non-incentivized so you just need to ensure you configure these settings in Tapjoy’s dashboard.
To do this simply set the Reward Type to Fixed Rewards, enter 0 for the Reward Amount and check the box to Hide Rewards:

Click ‘Save‘.

Step 4. Activate Tapjoy onironSource SDK Networks Module

There are a few pieces of data from your Tapjoy account which need to be inserted into yourironSource Network Setup Module in order for Tapjoy to work correctly in connection withironSource:

SDK Key

This is the unique identifier of your application in Tapjoy’s system.

Reporting API Key

This is the unique identifier for the Supersonic (by ironSource) Mediation platform in Tapjoy’s system.

Placement Name

This is the unique zone which Tapjoy will deliver ads through.

Once you obtain this information, you must configure Tapjoy’s Parameters in yourironSource Account. By adding the above information correctly, you will be able to take full advantage of Tapjoy’s ad inventory and reporting data onironSource’s Mediation platform.

SDK Key

Navigate to the ‘Settings‘ tab on the top menu and choose App Settings from the dropdown. On the App Info page, scroll down to the bottom of the page. Under Application Platforms, you’ll find the SDK Key for the app you want to run Tapjoy’s Video ads with on theironSource Mediation platform:

Reporting API Key

On the same page as the SDK Key, simply navigate to the ‘Mediation Keys’ tab. There you will find a dedicated API Key for Supersonic (by ironSource):

Placement Name

Under ‘Monetization‘, navigate to ‘Placements‘ ➣ User Initiated tab. There you will see the Placement Name.

Configure Tapjoy Parameters intoironSource Account

Once you have all of these parameters, log in to yourironSource account and in the left sidebar, navigate to ‘Monetize‘ ➣ ‘Mediation‘ ➣ ‘NetworkSetup‘. There you will see a list of all supported mediation networks.

Select Tapjoy from the list of Available Ad Networks and click on ‘Activate‘ and then ‘Save‘. Tapjoy will then be enabled in the Available Ad Networks table.

Make sure to select the app on which you’d like to runironSource’s Mediation with Tapjoy. Next, go to Tapjoy in the Setup list of Ad Networks and click on the ‘Define‘ icon.

Insert the ‘SDKKey‘ and‘Placement Name’ for the relevant ad unit. Set status to Active and click ‘Save’.

You will then see Tapjoy as Active for the defined app and ad unit on your Mediation Setup dashboard.

New! Verify your integration with the Reporting API; this column will check your integration through the Reporting API and return three possible responses: Verified, Failed and No Response. Double check your integration and the information you entered above; then click ‘Retry‘ until you see ‘Verified’.

Manual Download

Download the Tapjoy Adapter:Add the Tapjoy Adapter to your build. You can find the latest Tapjoy Adapter here.Important! The Tapjoy Adapter also contains the Tapjoy jar. You DON’T need to additionally add the Tapjoy jar directly.

Add the Tapjoy Adapter to your Project:After you download the Adapter; drop the Tapjoy Adapter jar into the libs folder in your Android Project.

Make sure you add the following to your Gradle build file under the dependencies section:

compile files('libs/tapjoyadapter:4.1.0@jar')

Step 6. Update AndroidManifest.xml

Manifest PermissionsAdd the following permissions inside the <manifest> tag:

Manage the debug logs for your integrated mediation ad networks with this boolean

IronSource.setAdaptersDebug(true);

When set to TRUE, this line of code will enable debug logs to help you troubleshoot issues with all of your mediation ad networks. Remove this code before your app goes live with our ad units!Supported for SDK versions 6.5.2 and up.