Mobile App Header Bidding Onboarding

Enabling mobile app involves the following steps:

  1. Ad Unit Inventory with PubWise Account Manager
  2. Setup Ad Server Prebid Mobile SDK
  3. Integrate the Prebid Mobile Ad SDK
  4. Configure the Prebid Mobile Ad SDK
  5. Verify Integration with PubWise Team

Full prebid mobile documentation: https://docs.prebid.org/prebid-mobile/prebid-mobile.html

Step 1: Ad Unit Inventory with PubWise Account Manager

AdUnit from AdServer Prebid Server Code Size
/AdUnit/FromAdServer PREBID_SERVER_CONFIGURATION_ID 300x250

Step 2: Setup Ad Server Prebid Mobile SDK

PubWise will handle this step using Google Ad Manager.

  1. Configure Ad Server a. Google Ad Manager i. https://docs.prebid.org/prebid-mobile/adops-line-item-setup-dfp.html a. AdMob i. https://docs.prebid.org/prebid-mobile/modules/rendering/rendering-admob-line-item-setup.html

Step 3: Integrate the Prebid Mobile Ad SDK

  1. Code Integration is Slightly Different based on Platform a. SDK for iOS i. https://github.com/prebid/prebid-mobile-ios a. DSK for Android i. https://github.com/prebid/prebid-mobile-android

Step 4: Configure the Prebid Mobile Ad SDK

Global Config

This step uses the following information. At a minimum AccountID and Host must be set according to the API documentation below.

Parameter Value
accountId “Provided by PubWise”
host https://pbs.pubwise.io/openrtb2/auction
  1. Global Configuration Parameters a. https://docs.prebid.org/prebid-mobile/pbm-api/android/prebidmobile-object-android.html
  2. Additional iOS Configuration a. https://docs.prebid.org/prebid-mobile/pbm-api/ios/code-integration-ios.html
  3. Additional Android Configuration a. https://docs.prebid.org/prebid-mobile/pbm-api/android/code-integration-android.html

AdUnit Config

According to the documentation below, configure AdUnits in your app. Then share the configID used with the PubWise team. This information will be used to configure bids in the Prebid Server for Mobile. Documentation is here: https://docs.prebid.org/prebid-mobile/pbm-api/android/pbm-banneradunit-android.html

Code sample from https://docs.prebid.org/prebid-mobile/pbm-api/android/pbm-banneradunit-android.html

PublisherAdView dfpAdView = new PublisherAdView(context);
dfpAdView.setAdUnitId("/AdUnit/FromAdServer");
dfpAdView.setAdSizes(new AdSize(300, 250));
final PublisherAdRequest.Builder builder = new PublisherAdRequest.Builder();
final PublisherAdRequest request = builder.build();

BannerAdUnit bannerAdUnit = new BannerAdUnit("PREBID_SERVER_CONFIGURATION_ID", 300, 250);

bannerAdUnit.fetchDemand(request, new onCompleteListener() {
    @Override
    public void onComplete(ResultCode resultCode) {
        dfpAdView.loadAd(request);
    }
});

Use the AdUnit Inventory from Step 1 to Fill out the following:

/AdUnit/FromAdServer
PREBID_SERVER_CONFIGURATION_ID
Ad Size for: dfpAdView.setAdSizes(new AdSize(300, 250));

Step 5: Verify Integration with PubWise Team

Before completing development and before releasing verify operation with the PubWise team. We will ensure that requests are flowing into the system. Bear in mind that ads may display from the Ad Server even if Header Bidding is not properly configured. We will verify the integration from the Prebid side.