Building a Purple Experience

Purchases, Entitlement & Coupons

7min

Purple Experience



Summary

One of the core aspects of many Purple Experience Apps / Websites is that users purchase content, via single purchases or, more commonly, subscribing.

Ways how users can get access to content:

  • entitlement login
  • external purchases connected to entitlement
  • app store / playstore purchase of issue / content
  • app store / playstore purchase of "repeatable publication products" / "consumables"
  • app store / playstore purchase of subscription for a publication
  • coupon codes


Entitlement

Entitlement allows content to be shown to only authorised users of apps and web.

In a new view inside the views.json you can set up a login page following this guide on how to set up a login page in the Experience Builder.

A login button can be added to the issue component with purchaseOptions inside the views.json

issue component with purchaseOptions inside the views.json
issue component with purchaseOptions inside the views.json


Additionally a login option can be added in the app menu. This is done by adding the following lines into the app_menu.xml which is located inside the default folder.

XML


App store purchases

Payments

Please refer to this Docs:

Payments (note section "Repeatable issue purchases")

To test purchases in preview apps

For testing app purchases in the preview version of your app, please contact your Purple Project Manager or Purple Customer Success Agent so that we can provide you test accounts for the sandboxes for both platforms (iOS and Android).

Coupon Codes

To activate coupons for your app, refer to: Coupon code function

Coupons are used to unlock issues that would otherwise be paid for in publications published over specified time periods. They may have a limited period of use and validity.

In order to integrate coupons into your app, you need to create a view for the Coupons to be used.

You can also add a coupon button to the issue component with purchaseOptions, similarly to the login button.

To make the coupon page accessible via the app menu, add the following line to the app_menu.xml

XML