Social Currency Banner

« Developer Documentation Index

Table Of Contents

Social Currency Banner

  1. 1. Compatibility
  2. 2. Prerequisites
  3. 3. Banner Setup
    1. (a) Unique Application Identifier
    2. (b) Implementing the IFrame
    3. (c) Parameter Details
  4. 5. Example Banners
  5. 5. Additional Help

Social Currency Banner Documentation

1. Compatibility:

The Social Currency Banner is implemented as an IFrame. The banner has been tested on the following browser versions:

  • Internet Explorer 7 & 8
  • Firefox 3.5 & 3.6
  • Opera 10.5
  • Chrome 5.0
  • Safari 5.0

2. Prerequisites:

To use the Social Currency Banner, you must complete the following steps if you have not already done so:

  1. 1. Create a SuperRewards Publisher account on www.srpoints.com
  2. 2. Log in to your Publisher account and create an application.

3. Banner Setup:

The following describes setup of your banner IFrame.

(a) Unique Application Identifier:

The unique application identifier (h) is the encrypted string that identifies the application that is making the Offer Overlay request. An identifier is created for each application your add to your SuperRewards Publisher account.

To find your application's unique identifier (h), log in to your SuperRewards Publisher account and edit the application that will display the Offer Overlay. There is an "edit" link located next each or your applications on the list. On the "Edit Application" page, you will see a box that appears like Figure 2a below. The unique application identifier is the h parameter located in the query string of the iframe (highlighted in bold red font).

<iframe src="http://www.superrewards-offers.com/super/offers?h=xxxxx.xxxxxxxxxxx&uid=[USER ID]" frameborder="0" width="728" height="2400" scrolling="no"></iframe>
Figure 1: Locating your application's unique identifier.

(b) Implementing the Banner Iframe:

The banner is set up in an IFrame using a URL that is very similar to the offerwall IFrame above. Here's an example of a 728x90 (Leaderboard) banner URL.

<iframe src="http://services.superrewardz.com/wall/banner?h=xxxxx.xxxxxxxxxxx&uid=[USER ID]&size=728x90" frameborder="0" width="728" height="90" scrolling="no"></iframe>
Figure 2: Example 728x90 Banner IFrame

(c) Parameter Details:

The list of parameters to use in your IFrame query string are listed below, with required parameters in red:

  1. h: This is the Unique Application Identifier described above.
  2. uid: This is the id of the user playing the game.
  3. size: Currently there are three different banner sizes with plans to add more soon. Some ad blocking software may filter out URLs that have banner dimensions in them so it is recommended to pass the size using our internal identifiers (Alt. Parameter). See example banners.
    DimensionsSize ParameterAlt. Size ParameterAvail. Flags
    760 x 76 pixels&size=760x76&size=toronto
    728 x 90 pixels&size=728x90&size=berlin
    504 x 90 pixels&size=504x90&size=sydney&flags=cpa
    460 x 250 pixels&size=460x250&size=newyork
    223 x 192 pixels&size=223x192&size=london
    160 x 600 pixels&size=160x600&size=tokyo
    144 x 455 pixels&size=144x455&size=casablanca&flags=cpa
    120 x 600 pixels&size=120x600&size=taipei
  4. bgcolor: (optional) (3 or 6 hex digits) This is the color code you would like for the background of the banner. The color code should be either 3 or 6 hexadecimal digits: For example:
     &bgcolor=FFF (white)
     &bgcolor=FF8C00 (DarkOrange)
  5. flags: (optional) a comma delimited list of special options.
    The 'cpa' flag is supported only on the 504x90, 728x90, and 144x455 banners.
    Adding &flags=cpa to your request will display a banner with only offers and no direct payment options.

4. Example Banners:

example size 760 x 76
(&size=toronto)

example size 728 x 90
(&size=berlin)

example size 504 x 90
(&size=sydney)

example size 504 x 90
(&size=sydney) Offers Only (&flags=cpa)

example size 460 x 250
(&size=newyork)

example size 223 x 192
(&size=london)

example size 160 x 600
(&size=tokyo)

example size 144 x 455
(&size=casablanca)

example size 144 x 455
(&size=casablanca)
Offers Only (&flags=cpa)

example size 120 x 600
(&size=taipei)


5. Additional Help:

For more help regarding the setup of the Offer Overlay, please contact your Account Manager.