Advertising Service

You can use the Advertising Service to display banner ads in your applications. The Advertising Service uses a central web portal where you can add or remove ad networks, and adjust the percentage of ad requests that are sent to each ad network without having to change your application. You can also track ad performance metrics such as the reach, CTR (Click-Through Rate), eCPM (effective cost per thousand impressions), and earnings. To get more information about the Advertising Service, visit the Advertising Service page.

Advertising Service event handling is done through BlackBerry Platform Services (BPS). For information about BPS, visit the BlackBerry Platform Services Library page.

The Advertising Service supports various ad types that conform to the MMA guidelines for mobile ads. Ad networks and ad agencies can also create ads that are designed to integrate with BlackBerry Device Software. For more information about the MMA guidelines, visit the MMA Mobile Advertising Guidelines.

As you develop your application, you can post questions and find answers on the BlackBerry Advertising Service forum.

Signing up

To use the Advertising Service, you need to sign up for the service, and provide information about your organization and the application that you want to incorporate banner ads into. To sign up for the Advertising Service, visit the registration page.

After you sign up and BlackBerry approves your request, you will receive an email message with login information and a unique zone ID for your application. The Advertising Service uses the zone ID to identify your application and to track ad performance metrics.


The following diagram shows you the components that make up the Advertising Service:

Architecture diagram showing the components of the Advertising Service.
Ad networks

An ad network receives ad requests from your application through the Advertising Service mediation layer, evaluates the requests, and returns ads through the mediation layer that are suitable for the target audiences of the applications and the BlackBerry devices.


The database contains information about your application, preferences that you specify in the web portal, and statistics about the past performance of ad networks. The mediation layer can use the information in the database to determine the ad networks to send ad requests.

Web portal

The web portal is a website where you can view statistics about the performance of the ads in your application, manage your participation with ad networks, and generate reports. The mediation layer can use the preferences that you specify in the web portal to determine the ad networks to send ad requests.

Server-side API

The server-side API enables the components of the mediation layer to communicate with ad networks, devices, developers using the web portal, and the database. The server-side API receives ad requests from the applications on BlackBerry devices, directs the ad requests to the appropriate ad networks based on the statistics stored in the database, and returns the ads to the devices.

What can the Advertising Service offer?

Simple implementation

You can use the Advertising Service to integrate ads into your application without having to write a lot of code. To display an ad, call the C functions in the API that define the ad banner, including the size, position, and refresh rate of the banner. When your application displays the banner, the remote ad server sends ad content to your application automatically.

Access to multiple ad networks from one location

You can use the Advertising Service to access multiple ad networks without having to negotiate agreements with each ad network.

Intuitive ad selection

Statistics about the performance of ads in your application are updated in near real-time so that your application always receives high-performing ads that are relevant to the target audience of your application. The Advertising Service mediation layer can use the statistics to automatically send ad requests from your application to the ad networks with the highest performing ads.

After the mediation layer sends an ad request to an ad network, the ad network determines what ads to return to your application based on the past performance of ads in the ad placement (for example, CTR and fill rate).

Trial zone ID to use for evaluation

A trial zone ID is a free account that you can use to test the performance of a banner ad in your application. You do not need to register with BlackBerry to obtain a trial zone ID. Using a trial zone ID can help you decide whether to register for a unique zone ID to earn money from the ads in your application.

The trial zone ID that you can use to test ad banners is 117145.

How does it work?

Here’s how your application interacts with the Advertising Service to request and display an ad:

  1. Your application sends an HTTP GET request that contains an ad request to the Advertising Service mediation layer. The ad request contains the unique zone ID for the ad placement (the zoneId parameter).
  2. The mediation layer receives the ad request, examines the past performance of the ad networks and the preferences that you specify in the web portal, and sends an HTTP GET request that contains the ad request to the appropriate ad network server.
  3. The ad network server receives the HTTP request, examines the past performance of ads in the application, identifies the target audience based on the information that's in the ad request, and returns the appropriate HTML ad to the mediation layer.
  4. The mediation layer returns the HTML ad to the application.
  5. The application displays the ad in a bbads_banner_t object.
  6. The user views and clicks the ad banner.
  7. The application sends a request through the mediation layer to the ad network server to obtain a destination URL. The contents of the destination URL vary depending on the type of action. For example, the destination URL can contain a website address.
  8. The ad network tracks the click and sends the destination URL back through the mediation layer to the application.
  9. The application opens a website.

Best practices

The way that you display ads in your application can have an effect on the performance of the ads. When incorporating ads into your app, consider the following guidelines:

  • Place ads on the screens that have the highest amount of traffic for your application. For example, place an ad on a screen that appears when an application opens rather than on a screen that requires multiple clicks to navigate to.
  • Place ads in prominent locations on your screens, such as the top or middle of the screen, depending on the design of your application.
  • Avoid crowding ads with the rest of the content in your application. Ads should be clearly visible so that they are easier to interact with. Consider creating a separate ad screen or dialog box for the ad.
  • Display an ad at a suitable moment. For example, don't display an ad when a game is playing. Display the ad before or after a game. For other types of apps, display an ad when the user moves from one screen to the next, or when the user completes a task in the app.
  • Provide enough time for users to view the ad. Refresh ads every two or three minutes.
  • Keep the ad visible when the user scrolls down the screen in your application.
  • Follow the MMA guidelines to display ads at the appropriate size. For more information, visit the MMA Mobile Advertising Guidelines.

Last modified: 2014-05-14

Got questions about leaving a comment? Get answers from our Disqus FAQ.

comments powered by Disqus