Import and Initialize SDK

Gradle

Add the following to your app's build.gradle file inside repositories section:

allprojects {
  repositories {
    mavenCentral()
    . . .
  }
}

On successful sync, you’ll be able to add any Android dependency hosted on mavenCentral repository to build.gradle. Add the following to the dependencies section of build.gradle:

implementation 'ai.meson.sdk:meson:1.0.0-beta17'

Manual

Download Meson Prime SDK

Copy the .AAR files to your application module’s libs/directory.

Add the following to your build.gradle file under the dependencies section.

implementation fileTree(dir: 'libs', include: ['*.aar'])

Gradle

To add the mediated SDK adaptor and SDK with Gradle, select the networks and add the following dependencies to the build.gradle.

See the list of supported networks and integration guides here.

Add Additional Dependencies

Add additional dependencies like Play Services, to allow GAID information to be retrieved, to your build.gradle.

Add permissions to your Android manifest.

These permissions are not required for our SDK or 3rd-party SDKs to function, but including them in your AndroidManifest.xml may result in improved eCPM and user experience

Manual

Download the mediation adapters. Copy the .AAR files to the application module's libs/directory.

Download the mediated SDK. Copy the .JAR or .AAR files to the application module's libs/directory.

See the list of supported networks and integration guides here.

	Real-time CPM		Adaptor | SDK
	Real-time CPM		Adaptor | SDK
	Real-time CPM		Adaptor | SDK
	Real-time CPM		Adaptor | SDK
	Predicted CPM		Adaptor | SDK
	Predicted CPM		Adaptor | SDK
	Fixed CPM		Adaptor | SDK
	Fixed CPM		Adaptor | SDK
	Fixed CPM		Adaptor | SDK
	Real-time CPM		Adaptor | SDK

Add the following to your build.gradle file under the dependencies section.

implementation fileTree(dir: 'libs', include: ['*.aar, *.jar'])

Add Additional Dependencies

Add additional dependencies like Play Services, to allow GAID information to be retrieved, to your build.gradle.

implementation 'com.google.android.gms:play-services-ads-identifier:18.0.1'

// Additional constraints for Google SDKs
// For apps targeting Android 12, add WorkManager dependency.
constraints {
  implementation('androidx.work:work-runtime:2.7.0')
}

Add permissions to your Android manifest.

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

// Admob and Ad Manager will need this in the manifest or the app will crash
<meta-data android:name="com.google.android.gms.ads.APPLICATION_ID" android:value="ca-app-pub-xxxxxxxxxxxxxxxx~yyyyyyyyyy"/>

These permissions are not required for our SDK or 3rd-party SDKs to function, but including them in your AndroidManifest.xml may result in improved eCPM and user experience

<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />   
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />

Kotlin

/*Meson SDK Configuration Object*/
val gdprConsent = JSONObject().run {
    put(MesonSdk.MES_GDPR_CONSENT_AVAILABLE, true) //consent value that is obtained from User
    put(MesonSdk.MES_GDPR_CONSENT_GDPR_APPLIES, "0") //0 if GDPR is not applicable and 1 if applicable
    put(MesonSdk.MES_GDPR_CONSENT_IAB, "<IAB String v1 or v2>")//user consent in IAB format
}
val mesonSdkConfiguration = MesonSdkConfiguration.Builder(this, "<MESON_APP_ID>").setConsent(gdprConsent).build()

/*Initialize Meson SDK*/
MesonSdk.initialize(mesonSdkConfiguration, object: MesonSdkInitializationListener {
    override fun onComplete(error: Error?) {
        if(error == null) {
        } else {
            //continue with publisher integration
        }
    }
})

Java

/*Meson SDK Configuration Object*/
JSONObject pubConsent = new JSONObject();  

//consent value that is obtained from User  
pubConsent.put(MesonSdk.Companion.getMES_GDPR_CONSENT_AVAILABLE(), true);

//0 if GDPR is not applicable and 1 if applicable  
pubConsent.put(MesonSdk.Companion.getMES_GDPR_CONSENT_GDPR_APPLIES(), "0");

//user consent in IAB format    
pubConsent.put(MesonSdk.Companion.getMES_GDPR_CONSENT_IAB(), "<IAB String v2 or v1>");

MesonSdkConfiguration mesonSdkConfiguration = new MesonSdkConfiguration.Builder(context, "<MESON_APP_ID>").setConsent(pubConsent).build();  

/*Initialize Meson SDK*/  
MesonSdk.Companion.initialize(mesonSdkConfiguration, new MesonSdkInitializationListener() {
  @Override
  public void onComplete(@Nullable Error error) {
    if(error == null) {
    } else {
        //continue with publisher integration
    }
  }
});

Kotlin

// You can notify Meson that restricted data processing is enabled using either of the following parameters.
val extras = JSONObject.run {    
    put("rdp", false)
    put("iab_usprivacy_string", "1YNN")
}
MesonSdk.setExtras(extras)

Java

// You can notify Meson that restricted data processing is enabled using either of the following parameters.
  JSONObject extras = new JSONObject();
  extras.put("rdp", false);
  extras.put("iab_usprivacy_string", "1YNN");
  MesonSdk.Companion.setExtras(extras);

Kotlin

To set user data, follow:

//Set Extras
val extras = JSONObject()
extras.run {
    put("age", 18)
    put("gender", BaseMesonInit.GENDER.MALE.value)
    put("segments", JSONArray(listOf("s1", "s2", "s3")))
    put("experiments", JSONArray(listOf("e1", "e2", "e3")))
    put("customIds", JSONArray())
}
// Set PPID
MesonSdk.setPPID("adada134412y1876dad")
MesonSdk.setExtras(extras)


//Set Location
  val location = Location(LocationManager.GPS_PROVIDER);  
  location.latitude(12.935386622398175);  
  location.longitude(77.69424226118132);  
  location.accuracy(90);  
  location.time(System.currentTimeMillis());  
  MesonSdk.setLocation(location)

To get or reset user data, follow:

//Getters
  MesonSdk.getExtras() //gets the extra values set in SetExtras
  MesonSdk.getSDKVersion() //gets the SDK version

//Clears extras, location
  MesonSdk.cleanUserInfo()

Java

To set user data, follow:

//Set Extras
  JSONObject extras = new JSONObject();
  extras.put("age", 18);
  extras.put("gender", BaseMesonInit.GENDER.MALE.getValue());
  extras.put("interests", "interests");
  extras.put("segments", new JSONArray(Arrays.asList("s1", "s2", "s3")));
  extras.put("experiments", new JSONArray(Arrays.asList("e1", "e2", "e3")));
  extras.put("customIds", new JSONArray());
  // Set PPID
  MesonSdk.setPPID("adada134412y1876dad");
  MesonSdk.Companion.setExtras(extras);

//Set Location
  Location location = new Location(LocationManager.GPS_PROVIDER);  
  location.setLatitude(12.935386622398175);  
  location.setLongitude(77.69424226118132);  
  location.setAccuracy(90);  
  location.setTime(System.currentTimeMillis());  
  MesonSdk.Companion.setLocation(location)

To get or reset user data, follow:

//Getters
MesonSdk.Companion.getExtras() //gets the extra values set in SetExtras
MesonSdk.Companion.getSDKVersion() //gets the SDK version

//Clears extras, location
MesonSdk.Companion.cleanUserInfo()

Kotlin

MesonSdk.setLogLevel(LogLevel.DEBUG)

Java

MesonSdk.Companion.setLogLevel(BaseMesonInit.LogLevel.DEBUG);