This guide is intended for publishers who want to use the MoPub SDK to load and display ads from Tapjoy via mediation. Below, you will find information about the ad network, integration/setup instructions, and more. For more information about how MoPub mediation works, visit this guide.

Supported Ad Formats

The following ad formats are currently supported by Tapjoy. For the latest support, visit the Tapjoy homepage.

  • Interstitial
  • Rewarded Video

Download and Integration

To download the Tapjoy adapters, navigate to the Mediation Integration Tool. You must also download the Tapjoy SDK:

For the latest download and integration instructions, consult Tapjoy’s tutorials before you integrate the SDK and adapters.

Android Integration Help

Tapjoy adapters are now released as an Android Archive (AAR) file, starting with version The adapters now include the manifest file for Tapjoy’s manifest dependencies. You no longer have to update the AndroidManifest manually for any generic data, such as permissions and Activities. Any other app-level placement configuration required by Tapjoy must be manually entered into the AndroidManifest.

Set Up Tapjoy on the MoPub Dashboard

SDK Key and Placement Name are required.

Network Reporting and Auto CPM

To enable Tapjoy network reporting and Auto CPM, you must enter the Publisher OAuth key and the MoPub Mediation Key.

Tapjoy reporting 1

To find the Publisher OAuth key, from Settings navigate to App Info, and select the API Keys tab at the bottom.

Tapjoy reporting 2

To find the MoPub Mediation Key, from Settings navigate to App Info, and select the Mediation Keys tab at the bottom.

This setup is required to take advantage of Auto CPM.

Migrate Tapjoy from Custom Native Setup

  1. Transfer SDK Key and Placement Name (if applicable) from the old custom native connection to the supported Tapjoy instance.

  2. MoPub will initiate the following Tapjoy mediation adapter class names to render the ads:

    • iOS

      • TapjoyInterstitialCustomEvent
      • TapjoyRewardedVideoCustomEvent
    • Android

      • com.mopub.mobileads.TapjoyInterstitial
      • com.mopub.mobileads.TapjoyRewardedVideo

    If you are manually entering these class names, migrate to the new network setup and pause the “Custom Native Network.” If you are using your own mediation adapter class names, have both the old custom native network and the new Tapjoy network UI set up for backward compatibility.

Important: During migration, make sure the custom native network and the Tapjoy network are not both live at the same time because this may impact your revenue.

Set Up Reporting

You can locate your credentials in your Tapjoy dashboard by navigating to your App Settings API Keys and Mediation Keys sections.

Test Ad

While testing your SDK integrations and network setups, we recommend that you leverage test ad placements for a consistent fill rate. To set up test mode, follow the instructions in Tapjoy’s test ad article.

For details about available error codes and potential resolutions, refer to Tapjoy’s documentation.

Additional Support

For inquiries and support, visit Tapjoy’s support center.

Last updated June 09, 2020

TWITTER, MOPUB, and the Bird logo are trademarks of Twitter, Inc. or its affiliates. All third party logos and trademarks included are the property of their respective owners.

© 2020 MoPub (a division of Twitter, Inc.)