Getting Started with Prebid Mobile

This page gives an overview of steps you need to take, either as an ad ops user or as a developer, to start using Prebid Mobile.

If this is your first time working with header bidding, we recommend that you read What is Prebid? before diving into Prebid Mobile.

Set Up Prebid Server

Before you begin using Prebid Mobile in your apps, you need to prepare your end-to-end system. The first step is to set up your Prebid Server host. Prebid Mobile works in conjunction with Prebid Server to request and receive bids. At this time you have three options when selecting your Prebid Server host:

  • Register with AppNexus
  • Register with Rubicon Project
  • Set up your own Prebid Server host

Register with AppNexus

  • Go to the Prebid Server application page and click Apply.
  • You’ll receive an email notifying you as to whether you’ve been granted access to the AppNexus-hosted Prebid Server implementation. If you receive access you’ll be provided with an account ID and will be able to set up server-side bidder configurations.

Register with Rubicon Project

Send an email to prebidserver@rubiconproject.com. While you wait for a verification email, you can continue with the steps below.

Implement Your Own Prebid Server Host

Prebid Server is an open source project. This allows you to host your own implementation of Prebid Server. The source code is available under the Prebid organization on Github.

See the Prebid Server docs on Github for more information on setting up your own server host.

Configure Prebid Server

After you’ve registered with your chosen Prebid Server host, you need to create at least one Prebid Server bidder configuration. Each configuration contains a list of bidders and their parameters. The configuration will be in the form of a JSON structure, similar to this:

[
    {
    	"bidder": "appnexus",
    	"params": {
    	    "placementId": 13144370
        }
    }
]

The preceding is an example structure using AppNexus as the bidder. The parameters you need to set differ for each bidder. See Bidder Parameters for a full list of parameters for available bidders.

Developers - Using the SDK

To begin using Prebid Mobile, download the Prebid Mobile SDK:

After you have the SDK installed, register ad units with the Prebid Mobile framework.

Ad Ops - Setting Up the Ad Server

Ad ops users configure the primary ad server with Prebid Mobile line items targeted to key/values.

Additional Information

The following resources are available for further information on working with Prebid Mobile:

Ad Ops

  • Price Granularity
    Additional details to help you ensure your line items are set up to target bid prices at an appropriate level of granularity.

Mobile Developers

iOS

Android

GDPR

Prebid Mobile provides APIs for app publishers in support of the IAB Europe Transparency & Consent Framework.

For general information on these APIs see Prebid Mobile Guide to European Ad Inventory and Providing Notice, Transparency and Choice.

For specific implementation details, see the “GDPR Consent” section here: