build.gradle

In your build.gradle (Module :app) file’s dependencies include these lines to include Prebid Mobile SDK and Google Ad Manager SDK to the project:

dependencies {
    //...
    // Google Ad Manager
    implementation 'com.google.android.gms:play-services-ads:23.0.0'
    // Prebid SDK
    implementation 'org.prebid:prebid-mobile-sdk:2.2.0'
}

AndroidManifest.xml

In the AndroidManifest.xml file add the provided <uses-permission> permission tags before the <application> tag.

<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="android.permission.WRITE_EXTERNAL_STORAGE" />

For better ad targeting and ad revenue, it is recommended to pass user’s geolocation to the Prebid Server. The first step in doing so is to add location permissions to your AndroidManifest.xml file. The ACCESS_COARSE_LOCATION is non-optional, whereas ACCESS_FINE_LOCATION is. If you add the latter, the user will be able to choose which type of location he gives permission to collect (the option to not share the user’s location is also present in the request popup).

Include the <meta-data> tag inside the <application> tag with your app ID, provided by Google Ad Manager.

<application>
    <meta-data
        android:name="com.google.android.gms.ads.APPLICATION_ID"
        android:value="ca-app-pub-################~##########"/>
    <!--...-->
</application>

Lastly, add a custom activity, which is necessary only for banner and interstitial ads

<activity
    android:name="org.prebid.mobile.rendering.views.browser.AdBrowserActivity"
    android:configChanges="orientation|screenSize|keyboardHidden"
    android:theme="@android:style/Theme.Translucent.NoTitleBar"
    android:windowSoftInputMode="adjustPan|stateHidden"
    android:launchMode="singleTop"/>

SDK initialization

Prebid Mobile SDK initialization is only needed to be done once. The context passed to the method is the class inside which this method is called. Initialization can be done inside the onCreate method by either calling the method that contains the initialization code or without using a separate method. In addition, Prebid can be initialized inside class that extends to Application class.

private fun prebidInit(context: Context){
    PrebidMobile.setPrebidServerAccountId(ACCOUNT_ID)
    PrebidMobile.setPbsDebug(false)
    PrebidMobile.setPrebidServerHost(
        Host.createCustomHost(
            "https://prebid.setupad.io/openrtb2/auction"
        )
    )

    PrebidMobile.initializeSdk(context) { status ->
        if (status == InitializationStatus.SUCCEEDED) {
            Log.d(Tag, "SDK initialized successfully!")
        } else if (status == InitializationStatus.SERVER_STATUS_WARNING) {
            Log.e(Tag, "Prebid Server status checking failed: $status\n${status.description}")
        }
        else {
            Log.e(Tag, "SDK initialization error: $status\n${status.description}")
        }
    }
    PrebidMobile.setTimeoutMillis(3000)
    PrebidMobile.setShareGeoLocation(true)
}

ACCOUNT_ID is a placeholder for Prebid account ID. The setTimeoutMillis sets how much time bidders have to submit their bids. It is important to choose a sufficient timeout - if it is too short, there is a chance to get less bids, and if it is too long, it can slow down ad loading and user might wait too long for the ads to appear.

The second step of sharing the user’s location is setting the setShareGeoLocation flag to true and the final step is asking the user’s permission to collect his location data. After doing these 3 steps (permissions in the manifest file, setting location flag to true and asking user for permission) Prebid Mobile SDK will send the user’s device location to the Prebid Server.

Setting setPbsDebug() to true adds a debug flag (“test”: 1) into Prebid auction request, which allows to display only test ads and see full Prebid auction response. If none of this required, you can set pbsDebug() to false.