Tapjoy

Introduction

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

This is a five-step process:

  1. Download the Tapjoy SDK
  2. Create a Tapjoy account
  3. Obtaining Parameters from Tapjoy
  4. Configure Tapjoy in Fyber
  5. Add the Tapjoy adapter to your build

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.

Note

Tapjoy currently supports the following ad formats:

  • Interstitials
  • Rewarded Videos

Refer to Tapjoy for updates on supported ad formats. 

Downloading the Tapjoy SDK

To download the Tapjoy SDK and view the configuration settings, click here.

Creating a Tapjoy Account

  1. Create an account with Tapjoy. 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

Creating an App in Tapjoy

To access Tapjoy’s inventory within the Fyber‘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

Note

For newly created placements select the mediated under Fyber 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.

Retrieving Parameters from Tapjoy

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

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

The parameters required depend on whether you are configuring the network at the App Level or Placement Level in the Fyber Console.

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

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 Fyber Account and can take full advantage of Tapjoy’s ad inventory and reporting data on Fyber's Mediation platform.

 

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

Obtaining the Placement Name

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

Obtaining the Publisher Reporting API Key

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

Obtaining 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.

Click Finish to complete these three steps.

Adding 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 Fyber‘s Mediation.

Important

Placements must be user-initiated to work in conjunction with Fyber‘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.

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

Configuring Tapjoy with Fyber

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

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

e307d66-Screen_Shot_2020-03-12_at_10.39.11.png

  1. On the App Management page, click Mediated Networks.

  1. Select Tapjoy from the list

The Tapjoy Mediation window opens:

  1. Enter the Tapjoy app credentials and set the Instance name.

Instance name should be distinguishable in case you have multiple Tapjoy Instances.

Note

If you are configuring the mediated network at app level, fewer credentials may be required.

  1. Click Save.
  2. To complete the set up, you must associate the network instance that you just created to the relevant Placement set up on the Fyber dashboard. For a detailed guide click here.

Adding the Tapjoy Adapter

To download the Tapjoy Adapter and view the configuration settings, click here.

You have now successfully integrated Tapjoy into the console.

Was this article helpful?
0 out of 0 found this helpful
Have more questions? Submit a request