2.1. SDK Integration

2.1.1 Apply for Account and Ad Units

Go to the Hisavana Platform to apply for an advertising platform account and create a monetization app and corresponding ad units. When creating an application on the platform, please note the integration method chosen is Mediation SDK or Hisavana SSP SDK, as different integration methods correspond to different SDK documentation.

2.1.2 Import Ad SDK

Step 1: Add the maven remote repository URL to the project-level build.gradle file, as shown below

buildscript {
    repositories {
      mavenCentral()
      maven { url "https://mvn.shalltry.com/repository/maven-public/" }
      maven { url "https://mvn.shalltry.com/repository/ad-releases/" }
    }
}

allprojects {
    repositories {
      mavenCentral()
      maven { url "https://mvn.shalltry.com/repository/maven-public/" }
      maven { url "https://mvn.shalltry.com/repository/ad-releases/" }
    }
}

Step 2: Introduce the Hisavana SSP advertising library in the Module's build.gradle

implementation "com.cloud.hisavana.sdk.ssp:hisavana:3.6.8.2"

Solution for 16kb Page Size Compatibility

In SDK versions 3.4.8.2 and below, there is a mandatory dependency on the so files from the Gif Library. These native files are incompatible with the 16KB page size. To resolve this, you must manually integrate the compatible library version v1.2.29.

/**
 * Version (v1.2.29) is now compatible with 16kb page size.
 *
 * Environment Requirements:
 * - Gradle 8.0+
 * - Android Gradle Plugin 8.1.0+
 * - minSdkVersion 21
 * - Kotlin Plugin, Standard Library, and Coroutines Library 1.8.0+ (Required)
 */
implementation 'pl.droidsonroids.gif:android-gif-drawable:1.2.29'

Starting from SDK version 3.5.0.3, the mandatory dependency on the Gif Library has been removed. Media applications now have the discretion to include this library as needed.