App Promo Bar

« Developer Documentation Index

Table Of Contents

App Promo Bar

  1. 1. Prerequisites
  2. 2. Setup
  3. 3. Additional Help

1. Prerequisites:

  • At a minimum, you will need a 103x47px ad image for your application.

2. Setup:

Setting up your application consists of the following steps:

*To learn about showing ads from another one of your apps within your promo bar, see house ads.

  1. Enrolling your App

    From the Promo Bar overview page, click on the subnav link to enroll one of your existing apps into the Promo Bar system. If you do not have an existing app created, you will need to create a new app within the 'apps' tab.
    • App Name: The externally facing name of your application.
    • Open Clicks in a New Window: By checking this option, links on your promo bar will be opened in a new window.
    • App Url: Seperate from the ad destination URL, this is the basic URL of your application (without tracking parameters -- you can set those when creating ads).
    • Filter Category: By checking this option, ads pertaining to apps with the same category as yours will not be shown on your Promo Bar.
    • App Icon: 16x16 pixel icon image used for navigation in the Promo Bar favorites section.
    • App Category: Select the most appropriate category(ies) for your game. Categories are used to fine-tune targeting on your Promo Bar.

  2. Create an Ad

    Ads are shown on other applications in the Prom Bar network. At least one ad needs to be created for each participating application. Multiple ads are encouraged to optimize performance and quality.

    • Ad Label: An internal identifier for this ad. It is not user facing
    • Ad Type: There are 2 types of ads that can be run on the Promo Bar -
      • Cross-Promo Ads: This ad will show up on other publishers' Promo Bars
      • Retargeted Ads: this ad will only show up for users that have previously been seen on your application per the retarget profile you specify. Specialized destination URLs can be used to further incentivize users to resume using your app or game.
      • House Ads: These ads will only show up on your own applications' Promo Bars. The purpose of house ads is to promote your own games. These ads will show up in the first two slots of your own Promo Bar, and do not earn credits. (limit 2)
    • Ad Destination URL: The landing page for your ad (with any desired tracking parameters).
    • Mouseover Text: Text shown on the bar when the user’s mouse cursor is over your ad.
    • Alt Tag: The text displayed in the event where the images for your ad do not load properly.
    • Banner Image: The main image for this ad (103px x 47px).
    • Banner Hover Image: The image shown when the user mouses over your ad (103px x 47px).
    • Country Targets: The countries you wish to target for your ad.

    Once the ad is created, enable it by clicking on the enable icon. The ad will be approved by your account manager, and should be live promptly.

    Note: Ads must be suitable to all audiences and must adhere to Facebook advertising guidelines. For example, ads may not contain adult content or graphic violence.

  3. Get the Promo Bar Code

    From the Apps page, click on the Get Code link to get the iframe tag for the Promo Bar.

  4. Include the Promo Bar Code in your HTML

    Place the Promo Bar iframe liberally throughout your app. Be sure to dynamically pass the user's user_id in the part of the url labeled [USER ID].

    As users click on your bar, you will accumulate credits which will go towards driving users clicks into your ads. Credits are earned and spent using the following country-specific credit ratios:

    • US - 5 credits
    • CA, UK, AU, NZ, IE - 4 credits
    • All other western europe - 3 credits
    • All other countries - 1 credit

    Your promo bar will also include revenue-generating app-install advertisements. While these ads do not earn you credits, they do earn revenue and behave like normal cross-promotion ads in the Promo Bar.

    *If you are placing your Promo Bar on a Facebook application, be sure to comply with Facebook's UID enccryption policy as described in this blog post.

3. Additional Help

Contact your Super Rewards Account Manager for help. We can walk you through the process or answer any questions you may have.