Prerequisites

• Use Android Studio 3.2 or higher.

• Create a project.

• Make sure that your app’s build file uses the following values:

  • A minSdkVersion of 21 or higher.

  • A compileSdkVersion of 33 or higher.

Step Summary

1. Configure you gradle build scripts

2. Add the app permissions to the manifest

3. Add the google app id to the manifest

4. Continue with Implementation type

1. Gradle Configuration

Gradle Buildscript

Project Level settings.gradle file :

...

dependencies {
  implementation ("com.refinery89.androidsdk:sharedCore-android:X.Y.Z")
}

Gradle Version catalogs

in app/module level build gralde:

dependencies {
  implementation (libs.r89sdk)
}

and in libs.versions

[versions]
r89sdk = "X.Y.Z"
            
[libraries]
r89sdk = { module = "com.refinery89.androidsdk:sharedCore-android", version.ref = "r89sdk" }

2. Manifest Permissions

Add the following Permissions for SDK on the top of the manifest file:

<?xml version="1.0" encoding="utf-8"?>
<manifest>
    <uses-permission android:name="android.permission.INTERNET" />
    <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
    <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
    <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
    <uses-permission android:name="com.google.android.gms.permission.AD_ID"/>
</manifest>

3. Manifest Google ID

Add the App ID to your app's AndroidManifest.xml file. To do so, add a <meta-data> tag with android:name="com.google.android.gms.ads.APPLICATION_ID", and for android:value, insert the App ID, surrounded by quotation marks.

...

Manifest End Result

...

4. Choose Implementation type

Single Tag Implementation

This is what you are looking for? continue here → https://refinery89.atlassian.net/wiki/x/BIDQSQ

...

• You App is native and you are able to add tags to your views

• Wants to Disable and enable Inventory slots without updating the application.

• Wants tos Edit the ad units remotely over the web without updating the application.

• Wants to Change Formats, slot place, sizes, etc.

Manual Implementation

This is what you are looking for? continue here → https://refinery89.atlassian.net/wiki/x/BgDOSQ

Manual configuration means that you have remote control of General Ad Settings over the web or our tech support, but you need to add the ads manually, so instead of just placing the tags you need to create a wrapper and use it to do a request for the format that you want.

...

• Wants control over the logic of showing the Inventory.

• You are using a framework that we don’t support but you can use native android code.

• You have a web-application but you are not using our monetization in your web and want to place ads natively

Webview Implementation

This is what you are looking for? continue here → https://refinery89.atlassian.net/wiki/x/AgDlSQ

...

Comparison table

...