Content Management System Setup

Content Management System Setup

Storing Brand and commissioning details within a CMS will allow you to update offers and promotions without having to send a new release to the app store. In this guide, we’ll go over:

  1. Benefits of using a CMS
  2. Information to store
  3. Flow of data
  4. Commissioning

Benefits of using a CMS

One of the benefits of integrating with Button is that with one integration, you can drive attributable traffic to many Brands with little additional development effort after your initial integration is complete. To accomplish this, we advise that you store Brand-specific values that you will use when engaging with Button's technology.

Information to store

You will need to store the following values for a Brand in your content management system:

Value Description
Button Organization ID
  • You will reference this value when receiving transaction notifications (e.g. webhooks or Transactions API) from Button
Offer URL
  • This is the URL you’ll pass to our SDK so that we know where to route the user (e.g.
Your Commission Rate
  • The commission rate you'll receive from the Brand (e.g. 10% of transaction total)
User Payout %
  • The % of your Commission Rate that you will pass on to the user (e.g. 90% of your Commission Rate)
User’s Commission Rate
  • The commission that the user will earn (e.g. 9% cash back – the user sees an offer and would earn this %)
  • You will calculate this value by multiplying your Commission Rate by the User Payout %
  • Any assets you will use in your Brand offer (e.g. Brand logo)

You may want to have multiple offers associated to a Brand in the case that you want to drive to different parts of the Brand’s app or mobile website. For example, you may want different offers for different categories. Thus, you may want to also store category or non-homepage details for Brands in your CMS:

Example CMS Setup

You can see here that for Brand123, we could have different offers for Toys, Clothing, and Electronics, whereas Brand456 only has one offer. Thus, you may need to store different URLs in your CMS for one Brand.

You can pull a subset of the data above via our Merchants API. Please check out this guide on how to interact with our Merchants API.

If you are interested in pulling your commission rates from our Rates API, please contact your Partner Success Manager.

Flow of data

By storing all offer details server-side in your CMS rather than shipping offer details in an app release, you can more nimbly launch Brands and scale your partnership with Button. We advise the following order of operations:

  1. Your client sends a request to your content management system for offer details
  2. Your server responds to the client with offer details
  3. Your client displays offers to the user using the Brand details returned in the response
  4. Your client passes the offer URL to invoke a Purchase Path


Now that your content management system is setup, please check out our Commissioning guide for rewarding users.