Wiki

Clone wiki

Banner Sample Android / integration_maven (AATKit 2)

Introduction

From version 2.20.0, AATKit is available also on a Maven repository. To use it, follow the steps described below:

Add the AATKit repository

First of all, you will need to add the AATKit's repository to your repositiories list. Edit your main build.gradle file:

allprojects {
    repositories {
        google()
        jcenter()
        //... other repositories you use
        maven {
            url 'http://android-sdk.aatkit.com/maven/'
        }
        maven { url "https://s3.amazonaws.com/smaato-sdk-releases/" } //Smaato repository
        maven { url 'https://verve.jfrog.io/artifactory/verve-gradle-release' } //PubNative repository
        maven { //Bluestack repository
            credentials {
                username "madvertise-maven"
                password "GpdGZ9GE9SK7ByWdM987"
            }
            url "https://api.bitbucket.org/2.0/repositories/mngcorp/deploy-maven-bluestack/src/master"
            authentication {
                basic(BasicAuthentication)
            }
        }
    }
}

Integrate AATKit with all standard ad networks

To add AATKit with standard set of ad networks, it is enough to add the following dependency in your app's build.gradle file:

dependencies {
    //... other project dependencies
    implementation ('com.intentsoftware.addapptr:AATKit:2.31.2') {
        transitive = true
    }
}

(Optional) Add AmazonHB network

  • If you are using AmazonHB, you will now need to place a file with your price points (named AmazonHBPricePoints.csv) in your app's assets folder.
  • Please contact your Account Manager if you are using Amazon SDK.

AmazonHB is not a part of standard integration. To use it, it must be added manually. Again, it is enough to just add the following depencency in your app's build.gradle file:

dependencies {
    //... other project dependencies
    implementation ('com.intentsoftware.addapptr:AATKit:2.31.2') {
        transitive = true
    }

    implementation 'com.amazon.android:aps-sdk:8.4.3'
}

(Optional) Adding Yandex network

Yandex is not a part of standard integration. To use it, it must be added manually by adding the following depencency in your app's build.gradle file (both Yandex libraries are necessary):

dependencies {
    //... other project dependencies
    implementation ('com.intentsoftware.addapptr:AATKit:2.31.2') {
        transitive = true
    }

    implementation 'com.yandex.android:mobileads:4.1.1'
    implementation 'com.yandex.android:mobmetricalib:3.20.1'
}
Please keep in mind that AppMetrica library used by Yandex will start another process of your app, thus calling your application's onCreate() method again. Please make sure to only initialize AATKit from the main process. See also here.

(Optional) Remove unused ad networks

If there is some ad network you do not want to use, it can be simply excluded. For example, assuming you want to exclude AdColony, just change the dependency declaration like:

implementation ('com.intentsoftware.addapptr:AATKit:2.31.2') {
        transitive = true
        exclude group: 'com.intentsoftware.addapptr.subsdk', module:'AdColony'
    }

List of "exclude" declarations

The following table lists the "exclude" declarations needed to remove specific ad networks.

Ad network declaration
AdColony exclude group: 'com.intentsoftware.addapptr.subsdk', module:'AdColony'
AppLovin exclude group: 'com.applovin', module:'applovin-sdk'
AppNexus exclude group: 'com.appnexus.opensdk', module:'appnexus-sdk'
Bluestack exclude group: 'com.madvertise', module:'bluestack-core-sdk'
CriteoSDK exclude group: 'com.criteo.publisher', module:'criteo-publisher-sdk'
Facebook Audience Network exclude group: 'com.facebook.android', module:'audience-network-sdk'
InMobi exclude group: 'com.intentsoftware.addapptr.subsdk', module:'InMobi'
MoPub exclude group: 'com.mopub'
Ogury exclude group: 'com.intentsoftware.addapptr.subsdk', module:'Ogury'
PubNative exclude group: 'net.pubnative', module:'hybid.sdk'
Smaato exclude group: 'com.smaato.android.sdk'
SmartAdServer exclude group: 'com.intentsoftware.addapptr.subsdk', module:'SmartAdServer'
UnityAds exclude group: 'com.intentsoftware.addapptr.subsdk', module:'UnityAds'

Continue with the standard integration steps

Updated