Android – SDK Integration


1. Introduction

This guide provides a comprehensive walkthrough for integrating the MyChips SDK into your Android application, enabling the display of an engaging offerwall.

2. Prerequisites

  • Android Studio
  • Minimum version requirement 27.

3. SDK Integration

3.1 Adding the SDK

dependencyResolutionManagement {
    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
    repositories {
        google()
        mavenCentral()
        maven("https://europe-west1-maven.pkg.dev/mychips-b31fe/mychips-android-sdk")
    }
}
dependencyResolutionManagement {
    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
    repositories {
        maven {
            url = uri("https://europe-west1-maven.pkg.dev/mychips-b31fe/mychips-android-sdk")
        }
    }
}

For Kotlin DSL Projects: In your project-level build.gradle.kts

For Groovy-Based Projects: In your project-level build.gradle

3.2 Adding the SDK Dependency to App-Level Build File

In your app-level build.gradle file, add the following dependency

dependencies { implementation 'io.mychips:offerwall:1.0.0' // Other dependencies... }
dependencies { implementation("io.mychips:offerwall:1.0.0") // Other dependencies... }

3.3 Configuring the Android Manifest

In your AndroidManifest.xml, add the following:

Permission for Internet Access:

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

Activity Declaration:

<activity android:name="io.mychips.offerwall.controller.MCOfferwallActivity"/>

3.4 Initializing the SDK in the Main Activity

In your main activity’s onCreate method, import and initialize the SDK:

import io.mychips.offerwall.sdk.MCOfferwallSDK;
// ...public class MainActivity extends AppCompatActivity {
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);

        // Replace 'YOUR_API_KEY' and 'USER_ID' with your actual values.
        MCOfferwallSDK.Init("YOUR_API_KEY", "USER_ID");
    }
}

import io.mychips.offerwall.sdk.MCOfferwallSDK
import android.os.Bundle
import androidx.appcompat.app.AppCompatActivity

class MainActivity : AppCompatActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)

        // Replace 'YOUR_API_KEY' and 'USER_ID' with your actual values.
        MCOfferwallSDK.Init("YOUR_API_KEY", "USER_ID")
    }
}

Obtain your API key and User ID from Universal Developer Portal.

3.5 Displaying the Offerwall

Replace ‘AD_UNIT_ID’ with your actual Ad unit ID.

MCOfferwallController mc = new MCOfferwallController(this);
mc.Show("AD_UNIT_ID");
val mc = MCOfferwallController(this)
mc.Show("AD_UNIT_ID")

Your Ad unit ID can be found at link