Tapjoy

The purpose of this article is to guide publishers who want to use the DT FairBid SDK to load and display ads from Tapjoy via DT FairBid mediation.

This is a six-step process:

  1. Create or login to your Tapjoy account
  2. Create an app in Tapjoy
  3. Create an App Placement
  4. Retrieve the parameters from the Tapjoy
  5. Insert the Tapjoy parameters into the DT Console
  6. Add the Tapjoy SDK to your integration

Tapjoy currently supports the following ad formats:

  • Interstitials
  • Rewarded Videos

Refer to Tapjoy for updates on supported ad formats. 

Step 1: Create or login to your Tapjoy Account

  1. Create or login to your Tapjoy account. You can do it here.
  2. Click the link in the confirmation email to verify your account.
  3. After account verification, log in to their partner login here

Step 2: Create an App in Tapjoy

To access Tapjoy’s inventory within the DT‘s Mediation platform, add your app and set up Ad Zones in your Tapjoy account.

Adding Your App

  1. If you are a new user on Tapjoy click Create App and follow the instructions.
  2. If you are already a registered user, click your name in the top right corner and from the dropdown menu click +Add App:

Defining Your App Settings

The Create your App Now window opens:

  1. Operating platform – iOS or Android or both
  2. Enter the following details:
  • App Name
  • Screen orientation
  • Time Zone
  • Currency
  • Tapjoy Usage Case

For newly created placements select the mediated under DT option.

  • Enter the App Store URL or select the checkbox if the app is not yet in the store
  • Click Create Now to finish.

Adding Virtual Currency

Now that you have created your app, the next step is mediation integration.

  1. On the Monetization Overview page, click the Monetization tab and then click Virtual Currency on the left menu bar.

All content units on Tapjoy must be associated with a virtual currency.

For more information on creating a Tapjoy Virtual currency, click here.

  1. Click Create Virtual Currency.
    392e6df-Screen_Shot_2019-08-14_at_11.25.41.png
  1. Click Create Virtual Currency to open the Create Virtual Currency window
    8d87cd7-Screen_Shot_2019-04-01_at_8.28.09.png
  1. Enter the relevant details:
  • Platform: iOS or Android
  • Currency Name, e.g. coins, gold, chips, etc.
  • Currency Usage Description
  • Default Exchange Rate
  • Callback URL or No_Callback (Self Managed currency only)
  • We recommend inserting NO_CALLBACK
  • Initial Balance, the currency amount your user is given when s/he starts using your app.
  • In-app virtual currency exchange to real world resources: no

The remaining fields are not required; leave them as is.

  1. Click Create Now.

Your newly defined virtual currency appears on your Virtual Currency dashboard and its status marked as Enabled.

  1. Click Create Virtual Currency to add another virtual currency.

Step 3: Create an Ad Placement

Set out below are the instructions for configuring ad placement with Tapjoy.

Now you have added your application, Tapjoy creates default placements for you. A placement is a specific point in your application where you can display content to your users. . This is the placement in your app where Tapjoy’s Video or Interstitial is triggered through DT‘s Mediation.

Important

Placements must be user-initiated to work in conjunction with DT‘s Mediation platform.

  1. From the top-right toolbar click Create Placement:
  1. Enter the new placement Name and Description

Ad Content

Use the information set out below to create content for the placement.

  1. From the Tapjoy dashboard go to Monetization >> Create Content to open the Create Content window.
  1. Select the relevant ad unit you want to use and click Create.
  1. Complete the details to create your content
  1. Click Save to complete the process.

Step 4: Retrieve the Parameters from the Tapjoy Dashboard

To enable Tapjoy to work as an Ad Network on the DT FairBid Mediation platform, you must obtain five parameters from your Chartboost account and later insert them into the DT Console.

Set out below are the details of what parameters are required, how and where to obtain them.

Tapjoy Parameter Description
SDK Key The unique identifier of your application in Tapjoy’s system.
Placement Name The unique placement through which Tapjoy delivers ads.
Publisher Reporting API Key The unique identifier for the DT platform in Tapjoy’s system.
Ad App ID The unique identifier of the app.

Alternatively, watch and listen to the video below to find out how to obtain the required parameters:

Once you have this information, you must configure Tapjoy’s Parameters in your DT Account and can take full advantage of Tapjoy’s ad inventory and reporting data on DT's Mediation platform.

Retrieving the SDK Key

Follow these steps to retrieve the SDK Key from Tapjoy:

  1. Click the app you want from the dropdown menu on the top right hand corner of the window:
    1b295ba-Screen_Shot_2019-04-01_at_9.55.48.png

The App Overview window opens.

  1. Click Settings >> App Settings:
    a8d44c8-Screen_Shot_2019-04-01_at_9.57.49.png
  1. Scroll down to display the SDK API Key:

Retrieving the Placement Name

  1. Go to Monetization >> Placements and you can view the Placement Name:

Retrieving the Publisher Reporting API Key

  1. In the same place as the SDK Key, click the API Keys tab:

Retrieving the Tapjoy Ad App ID

To obtain the Tapjoy Ad App ID, follow these steps:

  1. Go to Settings >> App Settings

  1. Scroll down to the bottom of the page
  1. Click Check ID and the Tapjoy Ad App ID is displayed

External Documentation

In the third step, Tapjoy provides you with links to external documentation for your configuration.

  1. Click Finish to complete these three steps.

Now that you have obtained the required parameters, you can complete the configuration of Tapjoy in your DT Account.

Step 5: Insert the Tapjoy Parameters into the DT Console

To enter the parameters obtained from Tapjoy and insert them into the DT Console, follow these steps.

  1. Sign-in to your DT account
  2. Select your app from the App Management window

  3. On the App Management page, click Mediated Networks

  4. Select Tapjoy from the list

  5. The Tapjoy Mediation window opens. Enter the Tapjoy app credentials and set the Instance name. Instance name should be distinguishable in case you have multiple Tapjoy Instances
    Screen_Shot_2023-02-19_at_16.27.20.png

  6. Click Save

  7. To complete the set up, you must associate the network instance that you just created to the relevant Placement set up on the DT Console. For a detailed guide click here.

Step 6 Adding the Tapjoy SDK to your Integration

To add the Tapjoy SDK go to the Supported Networks page and follow the guide while selecting the Configuration for Tapjoy.

SDK Bidding

Tapjoy’s whitelists are applied automatically. However, the Tapjoy team likes to ensure that publishers have set everything up properly.

For more details about Tapyjoy’s SDK Bidding, click here

Prerequisites

Integration with DT FairBid SDK and mediation set up.

  • Meta - All SDKs
  • TapJoy and AdColony - All SDKs

iOS Frameworks

Add the following frameworks to your project,

  1. libz
  2. libc++

Add the libxml2.tbd and libz.tbd lib to the target by clicking the application target -> Build Phases -> Link Binary With Libraries.

Back to Top ⇧