Step 1. Import SDK

Kotlin DSL

1. Insert following code into your settings.gradle.kts at the root of project

settings.gradle.kts

2. Insert following code into your app-level build.gradle.kts

build.gradle.kts

Groovy

1. Insert following code into your build.gradle at the root of project

build.gradle

2. Insert following code into your app-level build.gradle

build.gradle

Once that's done, save the file and perform the Gradle sync.

Step 2. Set Up The Project

1. Add the Network Security Configuration file to your AndroidManifest.xml :

<?xml version="1.0" encoding="utf-8"?>
<manifest>
    <application
        ...
        android:networkSecurityConfig="@xml/network_security_config">
    </application>
</manifest>

2. In your network_security_config.xml file, add base-config that sets cleartextTrafficPermitted to true :

<?xml version="1.0" encoding="utf-8"?>
<network-security-config>
    <base-config cleartextTrafficPermitted="true">
        <trust-anchors>
            <certificates src="system" />
        </trust-anchors>
    </base-config>
</network-security-config>

Configure Admob Meta-data

note

Only if you use AdMob adapter.

Add your AdMob app id to meta-data tag:

<manifest>
    <application>
        <!-- Add your AdMob App ID -->
        <meta-data
            android:name="com.google.android.gms.ads.APPLICATION_ID"
            android:value="ca-app-pub-xxxxxxxxxxxxxxxx~yyyyyyyyyy"/>
    </application>
</manifest>

You may find the AdMob App ID in your personal account on the AdMob page:

Step 3. Initialize SDK

We recommended to call initialization method in your MainActivity - onCreate method only once in your whole app:

Kotlin

override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)

    Appodeal.initialize(
        context = activity,
        appKey = "APP_KEY",
        adTypes = adTypes,
        callback = object : ApdInitializationCallback {
            override fun onInitializationFinished(errors: List<ApdInitializationError>?) {
                // Appodeal initialization finished
            }
        }
    )
}

Java

@Override
protected void onCreate(@Nullable Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    Appodeal.initialize(activity, "APP_KEY", adTypes, new ApdInitializationCallback() {
        @Override
        public void onInitializationFinished(@Nullable List<ApdInitializationError> errors) {
            // Appodeal initialization finished
        }
    });
}

• context - Activity of your application.

• Replace APP_KEY with the actual app key from your personal account.

• adTypes - Ad formats. Initialize only those ad types you want to use:

  • Appodeal.INTERSTITIAL for interstitial;
  • Appodeal.REWARDED_VIDEO for rewarded videos;
  • Appodeal.NATIVE for native ads;
  • Appodeal.BANNER for banners;
  • Appodeal.MREC for 300*250 banners.

Ad types can be combined using or operator.

For example, Appodeal.INTERSTITIAL or Appodeal.REWARDED_VIDEO.

---

You can find detailed documentation here