Install SDK

1. Introduction

This guide provides a comprehensive walkthrough for integrating the MyChips SDK into your Android application, enabling the display of an engaging offerwall. Once installed, you can choose between two integration options:

• Offerwall — A full-screen WebView experience managed by the SDK. See Offerwall Integration →

• Native Campaigns — A customizable campaign list that you embed directly in your app's UI. See Native Integration →

Both options use the same SDK. Install it once, then pick the integration that fits your app.

2. Prerequisites

• Android Studio

• Minimum version requirement 27.

3. SDK Integration

3.1 Adding the SDK

Kotlin DSL

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

Groovy

For Kotlin DSL Projects: In your project-level setting.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(Module :app) file, add the following dependency

Kotlin DSL

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

Groovy

3.3 Configuring the Android Manifest

In your AndroidManifest.xml, add the following:

Permission for Internet Access:

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

If you plan to use the Offerwall integration, you must also register the offerwall activity. See Offerwall Integration.

4. Initializing the SDK

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

Kotlin

import io.mychips.offerwall.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'
        MCOfferwallSDK.Init(this, "YOUR_API_KEY") 
        
    }
}

Java

Obtain your API key and User ID from Universal Developer Portal

4.1 (Mandatory) Set Google AdvertisingId

Improve reward tracking and eCPM performance by passing the advertising id. Official documentation

MCOfferwallSDK.SetAdvertisingId("HERE YOUR Google Advertising ID");

4.2(Optional) Set UserId if you have your own unique id

  MCOfferwallSDK.SetUserId("HERE YOUR USER ID");

Replace "HERE YOUR USER ID" with your actual user ID variable or value.

If you do not provide a specific user ID, one will be automatically generated.

4.3(Optional) Set User Age

You can set the user’s age to help improve ad targeting and analytics.

  MCOfferwallSDK.SetAge(30);

Replace 30 with your actual user age variable or value (integer).

💡 Note:

• The value should be an integer (e.g., 18, 25, 30).

• Expected range is 0–100 (inclusive).

4.4(Optional) Set User Gender

You can set the user’s gender to help improve ad targeting and analytics.

  MCOfferwallSDK.SetGender(MCGenderEnum.FEMALE);

Available enum values:

  MCGenderEnum.MALE
  MCGenderEnum.FEMALE
  MCGenderEnum.OTHER

4.5 (Optional) Set Custom Parameters (aff_sub1–aff_sub5 )

We provide 5 aff_sub parameters (aff_sub1, aff_sub2, aff_sub3, aff_sub4, aff_sub5), which you can use to pass custom values.

MCOfferwallSDK.setAffSub1("HERE YOUR CUSTOM VALUE");
MCOfferwallSDK.setAffSub2("HERE YOUR CUSTOM VALUE");
MCOfferwallSDK.setAffSub3("HERE YOUR CUSTOM VALUE");
MCOfferwallSDK.setAffSub4("HERE YOUR CUSTOM VALUE");
MCOfferwallSDK.setAffSub5("HERE YOUR CUSTOM VALUE");

Replace "HERE YOUR CUSTOM VALUE" with your actual custom value.

5. Next Steps

Choose your integration:

Integration	Description	Guide
Offerwall	Full-screen WebView experience	Offerwall Integration →
Native Campaigns	Customizable campaign list in your UI	Native Quick Start →