Tapsell Mediation


Tapsell Mediation

Tapsell Mediation, is a Mediated solution helping businesses increase their mobile apps’ revenue with the inclusion of other supported Programmatic & Mediated Ad Solutions.

Getting Started

Integrating the Tapsell SDK into your app is the first step toward displaying ads and earning revenue. Once you’ve integrated the SDK, you can choose an ad format (such as banner or rewarded video) and follow the steps to implement it.

Note: Tapsell Mediation currently targets Android platform only.

Configure Your Project

A few steps are required before you start serving ads to your users:

Setting up Tapsell Mediation Account

Before you are able to display ads to your users, you must have a Tapsell Mediation account. You can create one from the Tapsell Mediation dashboard.

Install the Tapsell Mediation plugin

NPM Version

yarn add react-native-tapsell-mediation/tapsell

The main package that you need to install is @react-native-tapsell-mediation/tapsell

Set Your Tapsell Mediation App ID

Open the app.json or app.config.js (if using Expo) file from the root of your React Native project and add the TapsellMediationAppKey key with the ID provided from the Tapsell Mediation dashboard:

app.json

{
  "react-native-tapsell-mediation": {
    "TapsellMediationAppKey": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
  }
}

app.config.js

module.exports = {
  "react-native-tapsell-mediation": {
    "TapsellMediationAppKey": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
  }
};

Make sure to add a valid App ID in the app.json or app.config.js file before building your app. Otherwise, it will cause the app to crash on start or fail to build.

Android 13 support

Apps updating their target API level to 33 (Android 13) will need to declare a Google Play services permission in the manifest file as follows:

<uses-permission android:name="com.google.android.gms.permission.AD_ID"/>

Read more about Google Advertising ID changes here.

Add Mediation Adapters

The react-native-tapsell-mediation/tapsell package doesn’t serve any ads itself; which means you must install at least one of the following packages for Tapsell to work. Adding more adapters helps the SDK to get ads from different ad networks and increases the possibility of serving ads. The Tapsell Mediation SDK currently supports the following 3rd-party programmatic & mediated partner SDKs:

NameDownloadsVersion 
Legacy Mediation AdapterbadgeNPM Version 
Admob Mediation AdapterbadgeNPM Version 
Mintegral Mediation AdapterbadgeNPM Version 
Applovin Mediation AdapterbadgeNPM Version 
Liftoff (Vungle) Mediation AdapterbadgeNPM Version 
IronSource Mediation AdapterbadgeNPM Version 
Fyber (Digital Turbine Exchange) Mediation AdapterbadgeNPM Version 
UnityAds Mediation AdapterbadgeNPM Version 
Wortise Mediation AdapterbadgeNPM Version 
ChartBoost Mediation AdapterbadgeNPM Version 

You can install each adapter in your project using the command below:

yarn add @react-native-tapsell-mediation/<adapter>

Additional Configuration

  • Admob:

    Open the app.json or app.config.js (if using Expo) file from the root of your React Native project and add the TapsellMediationAdmobAdapterSignature key with the ID provided from the Tapsell Mediation dashboard:

    app.config.js

    {
  "react-native-tapsell-mediation": {
    "TapsellMediationAdmobAdapterSignature": "ca-app-pub-xxxxxxxx~xxxxxxxx"
  }
}

  • Applovin:

    Open the app.json or app.config.js (if using Expo) file from the root of your React Native project and add the TapsellMediationApplovinAdapterSignature key with the ID provided from the Tapsell Mediation dashboard.

    app.config.js

    {
  "react-native-tapsell-mediation": {
    "TapsellMediationApplovinAdapterSignature": "YOUR_APPLOVIN_SIGNATURE"
  }
}

Build your app

For the changes to take effect, rebuild your project:

npx react-native run-android

Initialize the Tapsell Mediation SDK

No need to initialize the Tapsell Mediation SDK. It will be initialized automatically when you run your app.

The Tapsell SDK respects the GDPR user privacy policy. Considering this policy is required for the apps published in markets like GooglePlay. All ad networks support the user consent policies as well as Tapsell SDK. The Tapsell mediation SDK manages the user consent for all implemented ad networks automatically. The correct approach to manage the GDPR consent is showing a consent dialog in your application to choose an option by user. After user selection, you need to pass the user consent result to the Tapsell SDK. You can pass the result after initialization is completed by adding the following code:

import { setUserConsent } from '@react-native-tapsell-mediation/tapsell';

setUserConsent(true || false);

To avoid showing consent dialog to the user each time, you can store user preferences to your app. But you need to pass the latest stored user consent to the Tapsell SDK by invoking the above function.


Family Policy

According to the GooglePlay Family Policy, if any of the target audiences for your app is children (especially if you’re developing a game), your app’s content must be appropriate for these type of users. Also, you are not allowed to collect some personal information like Google Advertising ID. However, the third party advertising SDKs need this advertising id to provide and serve personalized ads for users. As a result, in Tapsell SDK all users are treated as 13 or older. So as an application developer if you’re going to publish your app in GooglePlay, you need to express that your app targets audiences with age of 13 or older. Otherwise, your app will be removed from GooglePlay according to this policy.


Sample project

for more info you can use Sample App on GitHub repository.

Test keys

To use test app keys and zones, you can refer to this link

Next Steps

After setting up and configuring Tapsell Mediation, you can go ahead and start to display different ads for users. The Tapsell package provides integration with different following types: