Adsolutions Prebid Mobile Setup iOS

Adsolutions / Header Bidding  / Adsolutions Prebid Mobile Setup iOS

Adsolutions Prebid Mobile Setup iOS

The Adsolutions Prebid Mobile SDK

The Prebid Mobile SDK for iOS and sample app are available via this repository on Github.

Ad Unit Setup for iOS and DFP

Register Prebid Mobile ad units as early as possible in the application’s lifecycle.

When registering a Prebid Mobile ad unit, you must replace @"PREBID-MOBILE-SLOT-ID" with a unique user-defined identifier. Prebid Mobile will use this identifier to determine the unique ad unit to which bid key-values will be associated. This identifier must be unique across all registered Prebid Mobile ad units, and does not need to map to any ad unit ID defined in your ad server.

We recommend doing this in the didFinishLaunchingWithOptions method in AppDelegate.m using the following steps, as shown in the code sample below:

  1. Create the ad units and add sizes for banner ad units. Be sure to replace @"PREBID-MOBILE-SLOT-ID" with a unique user-defined identifier.NOTE: The fluid ad size (used in DFP) is not supported.
  2. Add a server-side configuration for each ad unit to Prebid Server Adapter.
  3. Set targeting parameters for the ad units. (Optional)
  4. Set the primary adserver for the bid to DFP
  5. Set the Prebid Server host to Adsolutions.
  6. Register the ad units with the adapter to start the bid fetching process.

User-Replaced Macros

In the code snippets below, any values that must be substituted by your developers are identified in capital letters. These values are defined below:

Value Description
PREBID-SERVER-ACCOUNT-ID Your unique account ID with Adsolutions.
PREBID-MOBILE-SLOT-ID User-defined identifier that must be unique across all registered Prebid Mobile ad units. Note: this value should not map to any ad unit ID defined in your ad server, unless that ID is unique.
PREBID-SERVER-CONFIGURATION-ID The ID of a Prebid Server demand partner configuration. Represents the set of demand that will be fetched for a given ad unit.
AD-SERVER-AD-VIEW-INSTANCE The ad server ad view object instance to which bids will be attached. Supported values are defined in a table below.
SET-APP-NAME User-defined App Name (eg. NewYorkTimes)
SET_APP_PAGE User-defined Page Name (eg. /home)

Ad Unit Registration

Embed the ad unit registration in a try-catch block to catch all the exceptions (if any) thrown by the SDK.

Set Ad Server Targeting

Set the bid keywords on your adObject shortly after registering ad units, you can wait for bids with a timeout using the API method below.

Add Events

Gather Statistics

IMPORTANT! Last but not least: On page leave and app close events please implement the following so the statistics are send to Adsolutions and will be available in the Adsolutions Analytics Dashboard.