Skip to main content

2.1. SDK Integration

2.1.1 Apply for Account and Ad Units​

Apply to advertising Operations Personnel for an advertising platform account and corresponding ad units. When creating an application on the platform, please note the integration method chosen is Mediation SDK or Hisavana 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 advertising library in the Module's build.gradle

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

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.