Manual Integration

1. Installation

Tapdaq requires Android API 14 or higher, the following networks require higher minimum:

Network	Minimum API Level
AdMob	16
AppLovin	16
Chartboost	21
InMobi	15
Maio	16
YouAppi	16
ZPlay	16

A. Add dependencies

Tapdaq SDK

Add the Tapdaq-BaseSDK_[VERSION].jar or Tapdaq-BaseSDK_[VERSION].aar to your project, usually your libs folder.

GSON

Add GSON library. Recommended version 2.8.2 or higher. Download

Play Services Identifier

If using play services 15.0.0 or higher, add the Play-Services-Identity library. Download

If using play services lower than 15.0.0, add the Play-Services-Basement library. Download

Android Support v4 Library

Add support v4 24.0.0 or higher. Download

Android Lifecycle Extension

Add the Android Lifecycle Extension 1.0.0 or higher and its dependencies. Download

B. Update permissions

Allow the following permissions and activities in your AndroidManifest.xml file, like so:

<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    package="com.company.name">

    <uses-permission android:name="android.permission.INTERNET" />
    <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />

    <application>
        <!-- Debug Views -->
        <activity android:name="com.tapdaq.sdk.TMTestActivity"  android:configChanges="orientation|screenSize" />
    </application>
</manifest>

C. Add libraries

Download Tapdaq Base SDK and the adapters required, from each zip, add the .jar or .aar Adapter file as well as the ad network libraries to your project.


<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    package="com.tapdaq.sample">

    
    <uses-permission android:name="android.permission.INTERNET" />
    <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />

    
    <uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
    
    
    <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
    <uses-permission android:name="android.permission.VIBRATE" />
    
    <uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
    <uses-permission android:name="android.permission.READ_PHONE_STATE" />
    <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
    
    <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
    <uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
    <uses-permission android:name="android.permission.CHANGE_WIFI_STATE" />
    <uses-permission android:name="android.permission.READ_CALENDAR" />
    <uses-permission android:name="android.permission.WRITE_CALENDAR" />
    <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
    
    <uses-permission android:name="android.permission.INTERNET" />
    <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"/>
    <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
    <uses-permission android:name="android.permission.REQUEST_INSTALL_PACKAGES"/>
    
    <uses-permission android:name="android.permission.ACCESS_WIFI_STATE"/>
    
    <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" android:maxSdkVersion="18" />

    
    <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
    <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
    
    <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"/>
    <uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE"/>
  }
    <application>
    
        
        <activity android:name="com.adcolony.sdk.AdColonyInterstitialActivity"
          android:configChanges="keyboardHidden|orientation|screenSize"
          android:hardwareAccelerated="true"/>
        
        <activity
          android:name="com.applovin.adview.AppLovinInterstitialActivity"
          android:configChanges="orientation|screenSize"
          android:hardwareAccelerated="true" />
        <activity
          android:name="com.applovin.impl.adview.AppLovinOrientationAwareInterstitialActivity"
          android:configChanges="orientation|screenSize"
          android:hardwareAccelerated="true"
          android:screenOrientation="behind" />
        <activity
          android:name="com.applovin.sdk.AppLovinWebViewActivity"
          android:configChanges="keyboardHidden|orientation|screenSize" />
        <activity
          android:name="com.applovin.mediation.MaxDebuggerActivity"
          android:configChanges="keyboardHidden|orientation|screenSize"
          android:theme="@style/com.applovin.mediation.MaxDebuggerActivity.Theme" />
         
        <activity
          android:name="com.chartboost.sdk.CBImpressionActivity"
          android:configChanges="keyboardHidden|orientation|screenSize"
          android:excludeFromRecents="true"
          android:hardwareAccelerated="true"
          android:theme="@android:style/Theme.Translucent.NoTitleBar.Fullscreen" />
        
        <activity
          android:name="com.facebook.ads.AudienceNetworkActivity"
          android:configChanges="keyboardHidden|orientation|screenSize"
          android:exported="false" />
        <activity
          android:name="com.facebook.ads.internal.ipc.RemoteANActivity"
          android:configChanges="keyboardHidden|orientation|screenSize"
          android:exported="false"
          android:process=":adnw" />

        <service
          android:name="com.facebook.ads.internal.ipc.AdsProcessPriorityService"
          android:exported="false" />
        <service
          android:name="com.facebook.ads.internal.ipc.AdsMessengerService"
          android:exported="false"
          android:process=":adnw" />
        
        <activity
          android:name="com.inmobi.rendering.InMobiAdActivity"
          android:configChanges="keyboardHidden|orientation|keyboard|smallestScreenSize|screenSize|screenLayout"
          android:hardwareAccelerated="true"
          android:resizeableActivity="false"
          android:theme="@android:style/Theme.NoTitleBar"
          tools:ignore="Unusedattr" />
        
        <activity
          android:name="com.ironsource.sdk.controller.ControllerActivity"
          android:configChanges="orientation|screenSize"
          android:hardwareAccelerated="true" />
        <activity
          android:name="com.ironsource.sdk.controller.InterstitialActivity"
          android:configChanges="orientation|screenSize"
          android:hardwareAccelerated="true"
          android:theme="@android:style/Theme.Translucent" />
        <activity
          android:name="com.ironsource.sdk.controller.OpenUrlActivity"
          android:configChanges="orientation|screenSize"
          android:hardwareAccelerated="true"
          android:theme="@android:style/Theme.Translucent" />
          
          <activity
            android:name="jp.maio.sdk.android.AdFullscreenActivity"
            android:configChanges="orientation|screenLayout|screenSize"
            android:hardwareAccelerated="true"
            android:theme="@android:style/Theme.NoTitleBar.Fullscreen" />
          <activity
            android:name="jp.maio.sdk.android.HtmlBasedAdActivity"
            android:configChanges="keyboardHidden|orientation|screenSize"
            android:theme="@android:style/Theme.NoTitleBar.Fullscreen" />
          
          <uses-library android:name="org.apache.http.legacy" android:required="false"/>

          <activity
              android:name="com.mintegral.msdk.activity.MTGCommonActivity"
              android:configChanges="keyboard|orientation"
              android:screenOrientation="portrait"
              android:exported="true"
              android:theme="@android:style/Theme.Translucent.NoTitleBar" />

          <activity
          android:name="com.mintegral.msdk.reward.player.MTGRewardVideoActivity"
          android:configChanges="orientation|keyboardHidden|screenSize"
          android:theme="@android:style/Theme.NoTitleBar.Fullscreen" />

          <receiver android:name="com.mintegral.msdk.click.AppReceiver" >
              <intent-filter>
                  <action android:name="android.intent.action.PACKAGE_ADDED" />
                  <data android:scheme="package" />
              </intent-filter>
          </receiver>
          <service android:name="com.mintegral.msdk.shell.MTGService" >
              <intent-filter>
                  <action android:name="com.mintegral.msdk.download.action" />
              </intent-filter>
          </service>

          <provider
              android:name="com.mintegral.msdk.base.utils.MTGFileProvider"
              android:authorities="${applicationId}.mtgFileProvider"
              android:exported="false"
              android:grantUriPermissions="true">
              <meta-data
              android:name="android.support.FILE_PROVIDER_PATHS"
              android:resource="@xml/mtg_provider_paths"/>
          </provider>
        
        <activity
          android:name="com.tapjoy.TJAdUnitActivity"
          android:configChanges="orientation|keyboardHidden|screenSize"
          android:theme="@android:style/Theme.Translucent.NoTitleBar.Fullscreen"
          android:hardwareAccelerated="true" />

        <activity
          android:name="com.tapjoy.TJContentActivity"
          android:configChanges="orientation|keyboardHidden|screenSize"
          android:theme="@android:style/Theme.Translucent.NoTitleBar" />
        
        <activity
          android:name="com.unity3d.services.ads.adunit.AdUnitActivity"
          android:configChanges="fontScale|keyboard|keyboardHidden|locale|mnc|mcc|navigation|orientation|screenLayout|screenSize|smallestScreenSize|uiMode|touchscreen"
          android:hardwareAccelerated="true"
          android:theme="@android:style/Theme.NoTitleBar.Fullscreen" />
        <activity
          android:name="com.unity3d.services.ads.adunit.AdUnitTransparentActivity" android:configChanges="fontScale|keyboard|keyboardHidden|locale|mnc|mcc|navigation|orientation|screenLayout|screenSize|smallestScreenSize|uiMode|touchscreen"
          android:hardwareAccelerated="true"
          android:theme="@android:style/Theme.Translucent.NoTitleBar.Fullscreen" />
        <activity
          android:name="com.unity3d.services.ads.adunit.AdUnitTransparentSoftwareActivity"
          android:configChanges="fontScale|keyboard|keyboardHidden|locale|mnc|mcc|navigation|orientation|screenLayout|screenSize|smallestScreenSize|uiMode|touchscreen"
          android:hardwareAccelerated="false"
          android:theme="@android:style/Theme.Translucent.NoTitleBar.Fullscreen" />
        <activity
          android:name="com.unity3d.services.ads.adunit.AdUnitSoftwareActivity"
          android:configChanges="fontScale|keyboard|keyboardHidden|locale|mnc|mcc|navigation|orientation|screenLayout|screenSize|smallestScreenSize|uiMode|touchscreen"
          android:hardwareAccelerated="false"
          android:theme="@android:style/Theme.NoTitleBar.Fullscreen" />
        
        <activity
          android:name="com.vungle.warren.ui.VungleActivity"
          android:configChanges="keyboardHidden|orientation|screenSize|screenLayout|smallestScreenSize"
          android:launchMode="singleTop"
          android:theme="@android:style/Theme.NoTitleBar.Fullscreen" />
        <activity
          android:name="com.vungle.warren.ui.VungleFlexViewActivity"
          android:configChanges="keyboardHidden|orientation|screenSize|screenLayout|smallestScreenSize"
          android:hardwareAccelerated="true"
          android:launchMode="singleTop"
          android:theme="@android:style/Theme.Translucent.NoTitleBar" />
        
        <activity android:name="com.youappi.sdk.AdActivity"
          android:configChanges="screenSize|orientation"/>
        
        <activity
          android:name="com.playableads.presenter.PlayableADActivity"
          android:configChanges="orientation|screenSize|keyboardHidden"
          android:hardwareAccelerated="true"
          android:screenOrientation="portrait"
          android:theme="@android:style/Theme.NoTitleBar.Fullscreen" />
        <activity
          android:name="com.playableads.presenter.NativeAdLandingPageActivity"
          android:configChanges="orientation|screenSize|keyboardHidden"
          android:hardwareAccelerated="true"
          android:screenOrientation="portrait"
          android:theme="@android:style/Theme.NoTitleBar.Fullscreen" />
        <activity
          android:name="com.playableads.presenter.WebActivity"
          android:configChanges="orientation|screenSize|keyboardHidden"
          android:hardwareAccelerated="true"
          android:theme="@android:style/Theme.NoTitleBar.Fullscreen" />
        <receiver android:name="com.playableads.PlayableReceiver">
          <intent-filter>
            <action android:name="android.intent.action.DOWNLOAD_COMPLETE" />
          </intent-filter>
        </receiver>

    </application>
</manifest>

2. Initialise Tapdaq

Continue to Quickstart to initialise Tapdaq SDK.

Need help?

If you are having any problems integrating, feel free to contact us on [email protected] and we will be more than happy to help.

Manual Integration
1. Installation
2. Initialise Tapdaq
Need help?