TapMind SDK Documentation logo

Flutter Android Integration Guide

App Prerequisite

  • minSdkVersion of 23 or higher
  • compileSdkVersion of 36 or higher

AdMob

PREREQUISITES

  • An Ad Unit must already be in place which will be used for targeting.

Installation

App Prerequisite

  • minSdkVersion of 24 or higher
  • compileSdkVersion of 36 or higher

Configuration Steps

Ensure your android/build.gradle (project-level) includes the required repositories:

allprojects {
    repositories {
        google()
        mavenCentral()
        maven { url 'https://jitpack.io' }  
    }
}

Open the pubspec.yaml file.

Find the dependencies block and add from below for respective mediation platform.

dependencies  
tap_mind_ads_admob: ^0.0.11

Configuration

CREATING CUSTOM EVENTS FOR WATERFALL

  1. Under the Mediation tab : Click on Create Mediation group section
  2. Select Android and type of Ad format and Continue
  3. In the Name field : Type in as provided in the G-sheet
  4. Click on Add ad units
  5. Select the app and the Ad units that you want to use custom targeting on.

Add Custom EventCreate Mediation GroupSelect AndroidAdd NameAdd Ad unitsSelect app and Ad units

AD SOURCES (WATERFALL SECTION)

  1. Click on Water fall source
  2. Click on Setup ad Source and then at the Bottom left Click on custom event
  3. Select the App for the setup (Android)
  4. Select ad unit and add the parameters as follows

For the Below details Please reach out TapMind Account Manger

Mapping name : As Per the G-sheet Provided 
ecpm : As Per the G-sheet Provided
Class : com.tapmind.tech.TapMindMediationAdapterAdmob
Parameter : { "placementName": "As Per the G-sheet Provided"}

Ad Sources → Add Custom Event → Enter Label → Set eCPM → Add Mapping → Enter Mapping Name → Enter Class Name → Add Parameter

The above setup completes our TapMind x ADMOB integration. You should see an Ad if test setup is complete and working fine.

Response can be checked in LOGCAT by using tag: TapMindAdapter

Official Google Documentation for creating a custom event : https://support.google.com/admob/answer/13407144

PREREQUISITES

  • An Ad Unit must already be in place which will be used for targeting.

GOOGLE AD MANAGER CONFIGURATION

Please go through the below steps to integrate TapMind as a demand partner with your GAM account. To begin with the integration, login to your GAM account and follow the below steps.

  1. Under the Admin header : Click on the Companies section
  2. Click on the New Company button : Select Ad Network
  3. In the Name field : Type In TapMind
  4. In the Ad Network field : Select Other Company
  5. Toggle Mediation to ON
  6. Click on Save

Installation

App Prerequisite

  • minSdkVersion of 24 or higher
  • compileSdkVersion of 36 or higher

Configuration Steps

Ensure your android/build.gradle (project-level) includes the required repositories:

allprojects {
    repositories {
        google()
        mavenCentral()
        maven { url 'https://jitpack.io' }  
    }
}

Open the pubspec.yaml file.

Find the dependencies block and add from below for respective mediation platform.

dependencies  
tap_mind_ads_admob: ^0.0.11

Configuration

  • An Ad Unit must already be in place which will be used for targeting.

GOOGLE AD MANAGER CONFIGURATION

Please go through the below steps to integrate TapMind as a demand partner with your GAM account. To begin with the integration, login to your GAM account and follow the below steps.

  1. Under the Admin header : Click on the Companies section
  2. Click on the New Company button : Select Ad Network
  3. In the Name field : Type In TapMind
  4. In the Ad Network field : Select Other Company
  5. Toggle Mediation to ON
  6. Click on Save

Login GAM → Admin → Companies → New Company → Select Company Type (Ad Network) → Enter Name (TapMind) → Select Ad Network (Other Company) → Enable Mediation → Save

CREATING YIELD GROUP AND YIELD PARTNER

For adding TapMind under existing yield groups, skip the steps for creating a new yield group, navigate to your existing yield group and follow the steps for Adding Yield Partner as described in the next section

  1. Under the “Delivery” tab : Click on “Yield Groups” section
  2. Click on “New Yield Group” to create a new yield group
  3. In the Name field : Type in as provided in the G-sheet
  4. Ad Format : As Per the G-sheet Provided
  5. Inventory Type : Mobile
  6. Under Targeting : Select the Ad Units which "TapMind" will target
  7. Scroll to the bottom

Delivery → Yield Groups → New Yield Group → Enter Name (from sheet) → Select Ad Format → Select Inventory Type (Mobile) → Select Ad Units (TapMind) → Scroll Down

ADDING YIELD PARTNER

  1. Click on “Add Yield Partner
  2. Select “TapMind” from the list

Add details as provided below in Yield Partner

Integration Type : Custom Event 
Platform : Android
Status : Active

For the Below details Please reach out TapMind Account Manger

Default Cpm : As Per the G-sheet Provided
Label : As Per the G-sheet Provided
Class Name : com.tapmind.tech.TapMindMediationAdapterAdmob
Parameter : { "placementName": "As Per the G-sheet Provided"}
  1. Click on “Save” and save the configuration.
  2. The actual number of entries, manual eCPM, etc. will be shared once the test setup is complete.

The above setup completes our TapMind x GAM integration. You should see an Ad if test setup is complete and working fine.

Add Yield Partner → Select TapMind → Integration Type (Custom Event) → Platform (Android) → Set Status (Active) → Enter Default CPM (from sheet) → Enable Override CPM → Enter Label (from sheet) → Enter Class Name → Enter Parameter → Save

Response can be checked in LOGCAT by using tag: TapMindAdapter

Official Google Documentation for creating a Yield Group :
https://support.google.com/admanager/answer/7390828?hl=en

AppLovin

Installation

App Prerequisite

  • minSdkVersion of 24 or higher
  • compileSdkVersion of 36 or higher
  • Ensure Google Mobile Ads SDK is already integrated; if not, install it before adding the TapMinds adapter.

Configuration Steps

Ensure your android/build.gradle (project-level) includes the required repositories:

allprojects {
    repositories {
        google()
        mavenCentral()
        maven { url 'https://jitpack.io' }  
    }
}

Open the pubspec.yaml file.

Find the dependencies block and add from below for respective mediation platform.

dependencies  
tapmind_ads_applovin: ^0.0.9
Import Google Mobile Ads SDK
dependencies  
google_mobile_ads: ^7.0.0

Update AndroidManifest.xml

The AdMob app ID must be included in the AndroidManifest.xml. Failure to do so results in a crash on app launch.

Add the AdMob app ID, as identified in the AdMob web interface, to the app's android/app/src/main/AndroidManifest.xml file by adding a <meta-data> tag with the name com.google.android.gms.ads.APPLICATION_ID. For android:value, insert your own app ID in quotes as shown:

<manifest>
    <application>
        <!-- Sample AdMob app ID: ca-app-pub-3940256099942544~3347511713 -->
        <meta-data
            android:name="com.google.android.gms.ads.APPLICATION_ID"
            android:value="ca-app-pub-xxxxxxxxxxxxxxxx~yyyyyyyyyy"/>
    <application>
<manifest>

Use the same value when you initialize the plugin in your Dart code.

Configuration

PREREQUISITES

  • An Ad Unit must already be in place which will be used for targeting.
APPLOVIN CONFIGURATION

Please go through the below steps to integrate TapMinds as a demand partner with your APPLOVIN account. To begin with the integration, login to your APPLOVIN account and follow the below steps.

  1. In the MAX Dashboard, select MAX > Mediation > Manage > Networks.
  2. Click on Click here to add a Custom Network at the bottom of the page. The Create Custom Network page appears.
Custom Network: TapMind Market Place
Android Class: com.tapmind.tech.TapMindMediationAdapterApplovin
  1. Click on Save.

MAX → Mediation → Manage → Networks → Click Add Custom Network → Select Network Type (SDK) → Enter Android Class Name → Save

ADDING YIELD PARTNER

  1. Open MAX > Mediation > Manage > Ad Units in the MAX dashboard.
  2. Select the Ad Unit of type(Banner, Interstital or Rewarded) to which you want to add TapMind as a custom adapter.
  3. Select TapMind from the custom network menu to enable and enter the information for each placement. Below are the test setup details

Contact your account manager to see what values you need to set for the final list of production setup (Placement ID, Custom Parameters and CPM Price).

App ID = Leave it blank (its optional)
Placement ID = "As Per the G-sheet Provided"
eCPM: As Per the G-sheet Provided
Custom Parameters = {"placementName":"As Per the G-sheet Provided"}
  1. Click on “Save” and save the configuration.

MAX → Mediation → Manage Ad Units → Select Ad Unit → Select TapMind → Enter Placement ID → Enter eCPM → Enter Custom Parameters → Save

Response can be checked in LOGCAT by using tag: TapMindAdapter

The above setup completes our TapMind x Applovin integration. You should see an Ad if test setup is complete and working fine.

IronSource LevelPlay

Installation

App Prerequisite

  • minSdkVersion of 24 or higher
  • compileSdkVersion of 36 or higher
  • Ensure Google Mobile Ads SDK is already integrated; if not, install it before adding the TapMinds adapter.

Configuration Steps

Ensure your android/build.gradle (project-level) includes the required repositories:

allprojects {
    repositories {
        google()
        mavenCentral()
        maven { url 'https://jitpack.io' }  
    }
}

Open the pubspec.yaml file.

Find the dependencies block and add from below for respective mediation platform.

dependencies  
tapmind_ads_ironsource: ^0.0.8
Import Google Mobile Ads SDK
dependencies  
google_mobile_ads: ^7.0.0

Update AndroidManifest.xml

The AdMob app ID must be included in the AndroidManifest.xml. Failure to do so results in a crash on app launch.

Add the AdMob app ID, as identified in the AdMob web interface, to the app's android/app/src/main/AndroidManifest.xml file by adding a <meta-data> tag with the name com.google.android.gms.ads.APPLICATION_ID. For android:value, insert your own app ID in quotes as shown:

<manifest>
    <application>
        <!-- Sample AdMob app ID: ca-app-pub-3940256099942544~3347511713 -->
        <meta-data
            android:name="com.google.android.gms.ads.APPLICATION_ID"
            android:value="ca-app-pub-xxxxxxxxxxxxxxxx~yyyyyyyyyy"/>
    <application>
<manifest>

Use the same value when you initialize the plugin in your Dart code.

Configuration

PREREQUISITES

  • An Ad Unit must already be in place which will be used for targeting.
Levelplay UI CONFIGURATION

From Levelplay UI (Operational / Configuration Process)

Create a TapMind waterfall Network

Please go through the below steps to integrate TapMind as a demand partner with your IRONSOUCE-LEVELPLAY account. To begin with the integration, login to your IRONSOUCE-LEVELPLAY account and follow the below steps.

  1. On the Ironsource platform, select Monetize → Setup → SDK Networks.
  2. Select Available Networks → Manage Networks. In the dropdown list of available networks, select Custom Adapter.

  1. To enable the TapMind Adapter, input Network Key 15c101ba1, then click on the Enter key, and save. The name of the network should appear as TapMind.
  2. Click save, your TapMind network is now ready.

Login LevelPlay → Monetize → Setup → SDK Networks → Available Networks → Manage Networks → Select Custom Adapter → Enter Network Key → Press Enter → Save → TapMind Network Created

It is highly recommended to enter the Rate (that has been provided by TapMind for each placement id), as this determines the correct order in the waterfalls. Repeat the above setup for each ad-format type. To start with, only add one instance for each format only, and use the discussed eCPM rate for waterfall.

Setup Instances
  1. In the Left Side Navigation Menu click Instances under Setup.
  2. Click TapMind Network listed under Custom.
  3. Click on Ad Instance and select Ad type as Per the G-sheet Provided.

For the Below details Please reach out TapMind Account Manger

Instance Name : As Per the G-sheet Provided
ecpm : As Per the G-sheet Provided

Setup → Instances → Select TapMind (Custom) → Add Ad Instance → Select Ad Type (from sheet) → Enter Instance Name (from sheet) → Select Mediation Groups → Enter Rate (from sheet)

Response can be checked in LOGCAT by using tag: TapMindAdapter

Testing instructions

Before deploying the TapMind SDK and adapter to your live application, you can perform testing with the test mode. This will guarantee a high fill rate (99.99%) during the integration testing process, ensuring that the implementation is functioning correctly. It is crucial to disable the test mode before going live, as failing to do so will result in financial loss.