LoyaltyBoost (Rewarded Offers)

AdsPostX is now MomentScience! 🎉

We have rebranded AdsPostX to MomentScience. All the latest documentation and updates can now be found at MomentScience Documentation.

Overview

LoyaltyBoost Offers are special offers procured by AdsPostX that reward users for engaging with them. LoyaltyBoost Offers will be provisioned to your account so that Offers that are LoyaltyBoost enabled will be returned for your users to engage with and you’ll be able to to reward your users with an amount of Loyalty currency based on the Offer’s payout upon a revenue conversion event. To enable this, please contact your account manager.

Integrating LoyaltyBoost with your Website/App

To integrate LoyaltyBoost with your website/app, the following path is typical:

  1. Determine what identifier will be used for your users - this is typically a user_id, customer_id, player_id (or equivalent) that is in your database.
  2. Obtain LoyaltyBoost offers from the Publisher Dashboard or using the Offer Catalog API
  3. Ensure that the tracking links for offers have the user identifier passed in as a payload in the URL querystring
  4. Configure your Postbacks: Update your Postback URL in the Publisher Dashboard to receive conversion events and then set up routines at the Postback URL endpoint to award the user based on the returned user identifier.
  5. Publish and/or promote the offer!

Setup Your Currency Name and Conversion Multiplier (optional)

If you have a points or virtual currency tied to your program and are using the AdsPostX SDK, you will need to configure additional settings for LoyaltyBoost Offers to appropriately render. If you are using AdsPostX APIs you do not need to perform this step.

Go to your AdsPostX Dashboard, head to the Configuration Page, and set your Loyalty Program’s Currency Name - Singular, Currency Name - Pluraland Currency Multiplier as seen in the screenshot below:

Document image


The Currency Multiplier is used to calculate how much currency of your loyalty program the LoyaltyBoost Offer shown will payout to the user. The resulting loyalty point payout is calculated by the revenue conversion payout in dollars * currency multiplier. For the above shown AdsPostX LoyaltyBoost Offer, The revenue conversion is worth 30$. The resulting loyalty points payout shown is 30*10 ⇒ 300 Loyalty Points. Currency Multiplier is only used to show how much a LoyaltyBoost Offer will payout to the user.

Rewarding Your Users When Revenue Events Occur

To reward your users based on revenue events, you will need to set up your postback URL. The postback URL will receive information based on the user via payload values that were passed in when callling AdsPostX to deliver Offers along with a payout amount. With this information, the postback URL has your user identified for your systems to issue the reward. To learn more about postbacks, click here.