Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

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. 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 publisherId and appId will be provided to you during onboarding process by email, you can also retrieve them from the web interface after login.

Note

This appID is not the same as the Manifest App Id you used in previous steps

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

...

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.

We recommend you add the wrappers using XML Views, since it’s easier than creating them using code, so something like this:

Code Block
# activity_main.xml
...
<LinearLayout
    android:id="@+id/ad_container"
    android:layout_width="wrap_content"
    android:layout_height="wrap_content"
    android:orientation="horizontal"
    android:layout_centerHorizontal="true"
    android:layout_alignParentBottom="true">
</LinearLayout>
...

and then fetch it in the code for the factory like so:

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

Ad Formats

Child pages (Children Display)
depth1
allChildrentrue
style
pageSDKpDocs:SDKpDocs:Ad Formats
sortAndReverse
first0

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.

Check Android - Ad Formats to see how each format is implemented.