Android SDK Integration

Gradle

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

Add mavenCenteral repository to your app's build.gradle.

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:

dependencies {
    implementation 'ai.meson.sdk:meson-wrap:2.0.5'
}

Manual

Download WRAP 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 GAM plugins with Gradle, enter the following in your build.gradle:

implementation 'ai.meson.sdk:meson-wrap-gam:2.0.5'

Manual

Download GAM Plugin

Import the .AAR file as a library project

Copy the .AAR file 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'])

Kotlin

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

val mesonSdkConfiguration = MesonSdkConfiguration.Builder(context, "<MESON_APP_ID>").setConsent(gdprConsent).build()

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

Java

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

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

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

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

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

/*Initialize Wrap SDK*/
MesonWrap.Companion.init(mesonSdkConfiguration, new MesonSdkInitializationListener() {
  @Override
  public void onComplete(@Nullable Error error) {
    if(error == null) {
        //Integrate for GAM.
    } 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 ppidObject = JSONObject().run {
    put("PPID", "3f4364a6-cc98-4cbf-8b67-7aec972833ff")
}
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(listOf(ppidObject)))
}
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 get or reset 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());
  MesonSdk.Companion.setExtras(extras);
  MesonWrap.Companion.setPPID("adada134412y1876dad");
//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

MesonWrap.setLogLevel(LogLevel.DEBUG)

Java

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