This is the help page for the integration with our ad serving engine, the OfferEngine, and your application. Remember that you will need to have an affiliate ID in order to track your links, but you can testdrive the library without it.

SIGN UP

For any doubts, questions, or asistance, contact us.

API endpoint (v001, legacy)

This API version has been deprecated, but it is still mantained as a working endpoint. For the latest API information and features, check the updated documents.

  • Request

    We provide you libraries to download and display the ads in different platforms (iOS, Android and mobile websites), but we also provide you the JSON endpoint for custom implementations.

    http://offerwall.12trackway.com/ow.php?output=json&limit=5&os=android&version=6.0&model=SGS6&token=1234&placement_key=tokenkey

    The parameters list are the following:

    • limit: the number of ads to be served on response to this request
    • os: operative system. Valid options: ios / android
    • version: operative system version, in the readable format (such as 4.2, 7.3, 6.0...)
    • token: the unique identifier for the user. It must comply with Apple and Google guidelines for advertising. Explained later how to retrieve it per platform.
    • placement_key: token identifier for the ad placement. It can be retrieved in the user panel (http://third-party.pmgbrain.com/, Apps/Websites > App > Placements)
  • Response

    The response for the ads request will be a JSON file containing a list with the offers and their assets, such as:

    [
       {
          "id": "168656",
          "campaign_name": "Fiverr",
          "campaign_description": "Find Gigs you love, anytime, anywhere. \r\n",
          "app_store_url": "https://play.google.com/store/apps/details?id=com.fiverr.fiverr&hl=en",
          "click_url": "http://offerwall.12trackway.com/save-click.php?campaign=168656&impression=36309129&token=1234",
          "images": [
             {
                "url": "https://media.go2speed.org/brand/files/pocketmedia/28598/icon_Android.PNG",
                "width": "205",
                "height": "212"
             }
          ],
          "campaign_image": "https://media.go2speed.org/brand/files/pocketmedia/28598/icon_Android.PNG"
       },
       {
          "id": "116815",
          "campaign_name": "SEQR - The mobile wallet",
          "campaign_description": "Verzend geld met je smartphone! Het is volledig gratis!",
          "app_store_url": "https://play.google.com/store/apps/details?id=com.seamless.seqr",
          "click_url": "http://offerwall.12trackway.com/save-click.php?campaign=116815&impression=36309129&token=1234",
          "images": [
             {
                "url": "https://admin.appnext.com/pImg.aspx?b=84474&z=106283&c=64293&u=https%3a%2f%2fappnext-a.akamaihd.net%2fbanner%2fVirHMl8dYKgPIDc_square.png",
                "width": "300",
                "height": "300"
             }
          ],
          "campaign_image": "https://admin.appnext.com/pImg.aspx?b=84474&z=106283&c=64293&u=https%3a%2f%2fappnext-a.akamaihd.net%2fbanner%2fVirHMl8dYKgPIDc_square.png"
       }
    ]

Obtaining a user token

  • When using the native libraries for iOS and Android this process is done automatically. In case you want to implement the API communication manually, you must also handle the token retrieval for the platform.

    iOS

    For Apple devices it is mandatory using the Apple Advertising Identifier. This token is retrieved trough the ASIdentifierManager class.

    Apple Documentation

    Android (Google Play)

    For Android devices using Google Play Services it is mandatory to use the Advertising Identifier Provided by Google Play:

    Google Documentation

    Android (without Google Play)

    In devices without Google Play Services, such as apps in alternative marketplaces (Amazon, Baidu, etc.) it is possible to use an alternative identifier:

    • ANDROID_ID: consists in a 64-bit number randomly generated on the 1st boot of a device. Usually it is not modified during the lifetime of the device.
    • DEVICE_ID: returns an identifier such as the GSM IMEI, or the MEID or ESN for CDMA phones. Can be null.
    • Mac Address: uniquely identifies the wireless network adapter of the device. Can be retrieved through the WifiManager class.