If you plan to use the MoPub SDK to load and display ads from Tapjoy via mediation, use this article for integration instructions and information unique to the ad network. To learn more about how MoPub mediation works, refer to our MoPub Network Mediation article.

Supported Ad Formats

Tapjoy currently supports the following ad formats. For support information, visit the Tapjoy homepage.

MoPub Formats Tapjoy Ad Formats
Interstitial Interstitial
Rewarded Video Rewarded Video

Download and Integrate

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.

Set Up Tapjoy on the MoPub Dashboard

SDK Key and Placement Name are required.

Network Reporting and Auto CPM

The following setup is required to take advantage of Auto CPM. To enable Tapjoy network reporting and Auto CPM:

  1. Navigate to the MoPub UI’s Networks tab. (Refer to these additional instructions that provide more detail for the remaining steps.)

  2. In the Network settings page for Tapjoy:

    • enable reporting access

    • provide the Publisher OAuth key and the MoPub Mediation Key

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

      Tapjoy reporting 1

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

      Tapjoy reporting 2

  3. Navigate to the Auto CPM preferences page and turn on 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, make sure that both the old custom native network and the new Tapjoy network UI are set up for backward compatibility.

Important: During migration, make sure that 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 App SettingsAPI KeysMediation Keys.

Test an Ad

As you test your SDK integrations and network setups, we recommend that you leverage test ad placements to ensure a consistent fill rate.

With test mode enabled, you can request ads using the ad unit ID you created earlier for this purpose and receive a Tapjoy test ad. Be sure to disable test mode after testing!

Additional Support

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

Last updated December 03, 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.)