Versions Compared

Version Old Version 8 New Version Current
Changes made by

Abraham Armas Cordero

Abraham Armas Cordero

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Table of Contents
stylenone

Prerequisites

Step Summary

  1. Add the Initialization code.

  2. Add the wrapper/trigger (transitions or button clicks) into your app.

  3. Follow our ad format guides for their implementation.

  4. Test everything is working

  5. Change everything to production code

  6. Your app is now prepared for monetization with us.

We only mention how to create wrappers and not triggers because the way a trigger is fetch for its use is highly dependant on your specific app code.

Wrappers and Triggers/Events are used for different formats, each ad format page tells you what you need to use (wrapper or trigger) to display it.

Initialize the SDK

Note

We require the SDK to be initialized only once as early as possible so for this purpose using Android’s application is recommended but if your app only has one activity, if using the activity make sure it is never destroyed unless killing the app or placing it in the background, matching then the lifecycle of Application, you can initialize it in onCreate method of that Activity.

...

Code Block
breakoutModewide
languagekotlin
class Application: Application()
{
    override fun onCreate()
    {
        super.onCreate()
        
		R89SDK.setDebug() //This is for testing purposes, remove it on prod
		R89SDK.setLogLevel(LogLevels.DEBUG) //This is for testing purposes, remove it on prod
		
		R89SDK.initialize(
			appContext = this,
			publisherId = "TestRefinery89ID", /* This is for testing purposes, change it on prod */
			appId = "TestDemoApp", /* This is for testing purposes, change it on prod */
			singleLine = false,
			initializationEvents = null
		)
    }
}
Info

You will receive your Your publisherId and appId will be provided to you during onboarding process by email, you can also retrieve them from the web interface after login.

...

Then add this application class to the manifest you already had from the Android Get Started.

The code for adding the application is the following

...

Code Block
<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"/>
    
    <application
        android:name=".Application">
    
    <!-- This is the Sample App ID-->
    <meta-data
        android:name="com.google.android.gms.ads.APPLICATION_ID"
        android:value="ca-app-pub-3940256099942544~3347511713"/>
        
    </application>
</manifest>

Add wrappers to your Views

Wrappers are the container inside which the ads will show. You need to add as many as ad slots or ad places you desire.

...

Code Block
//Remember to use this Code only once since findViewById is an expensive method
val myWrapper = findViewById<ViewGroup>(R.id.myWrapper)

Follow our Ad Formats guides

Child pages (Children Display)
depth1
allChildrentrue
style
pageAndroid - Ad Formats
sortAndReverse
first0

Go into production

  • Remove the methods R89SDK.setDebug()

  • Change the Google app id in the manifest for the production one

  • Change the appId and publisherId in the initialization method for the production ones

  • Change the r89ConfigId in the formats for the production ones

  • it’s also recommended to remove R89SDK.setLogLevel(LogLevels.DEBUG) but not needed

How does it works?

We fetch all ad units configurations from our Database and you simply need to place the ad units using the RefineryAdFactory and the r89ConfigurationIDs we provide you. Incorporate them into the desired views.

...