Standards for digital goods

A digital good, sometimes called in-app digital goods, is additional content that can be purchased for an app, and can be permanent, temporary, or consumable content. BlackBerry reviews and approves digital goods using the same process that is used for any apps that you submit.

When you add a digital good for an app, you specify a name, SKU, license type, and descriptions, but you do not upload binaries or file bundles for the digital good. Instead you must design your app to give users access to the digital goods.

Digital goods have their own license types:

  • Consumable licenses for temporary products like movie rentals.
  • Non-consumable licenses for permanent enhancements, like extra levels of a game.
  • Subscriptions for renewable content, like news publications.

When you offer non-consumable digital goods, you must verify that the digital goods are available to the user for the minimum time period that is defined in the BlackBerry SDK License Agreement.

You must verify that the digital goods remain available if the user removes the app from a BlackBerry device and installs the app again. You might need to develop a process that queries the Payment Service server for records of previous purchases of digital goods on each app launch. Learn more about Payment Service for details on retrieving records of existing purchases.

Subscriptions for digital goods have the same requirements as subscriptions for apps:
  • 7-day subscription: Users can purchase the digital good or use it for a trial period that you specify. You can specify a price for the initial trial period and a length for the initial trial period.

    If the price of the initial trial period is free ($0), the initial trial period can be 1, 2, 3, 4, 5, 7, or 14 days. If the price of the initial trial period is not free, then the initial trial period must be 7 days.

    After the trial period expires, users pay a fee to renew their subscription to the app for 7 days. Use the Renewal Price drop-down list to specify the renewal fee. If the price of the initial trial period is not free, then the renewal fee must match the price of the initial trial. Users pay the renewal fee every 7 days. If you select this license type, you must also select a license model.
  • 30-day subscription: Users can purchase the digital good or use it for a trial period that you specify. Use the Price drop-down list to specify the price of the initial trial period. Use the Initial Trial Period drop-down list to specify the trial period.

    If the price of the initial trial period is free ($0), the initial trial period can be 1, 2, 3, 4, 5, 7, 14, 16, 30, 45, 46, or 60 days. If the price of the initial trial period is not free, then the initial trial period must be 30 days.

    After the trial period expires, users pay a fee to renew their subscription to the app for 30 days. Use the Renewal Price drop-down list to specify the renewal fee. If the price of the initial trial period is not free, then the renewal fee must match the price of the initial trial. Users pay the renewal fee every 30 days. If you select this license type, you must also select a license model.

If your digital good is not free, you need to select a license model as well as a license type. License models for digital goods have the same requirements as license models for apps:

  • Static: Users do not need a license key to run the digital good.
  • Single: You must provide a single license key that all users can use to run the digital good. You specify the license key in the License Key field when you add your digital good to the vendor portal.
  • Dynamic: You must provide an address for a website that generates license keys. After a user purchases the digital good, the server for the BlackBerry World storefront connects to the website, retrieves the license key that the predetermined algorithm generated, and provides the user with the license key. If you select a Dynamic license model when adding a new digital good on the vendor portal, an HTTP URL field appears that lets you specify the web address for a license key. For more information about dynamic licensing, visit http://us.blackberry.com/developers/appworld/Dynamic_License_Flow.pdf.
  • Pool: You must upload a .txt file that contains unique license keys (one key on each line). BlackBerry World distributes a unique license key to each user that purchases the digital good. When you add a new digital good on the vendor portal and select the Pool license model, an Upload License File button appears so that you can upload your .txt file.

    Your .txt file must contain at least 100 unique license keys. If the number of license keys drops to 50 or fewer, BlackBerry World sends you an email message requesting that you add more license keys. If the number of license keys drops to ten or fewer, BlackBerry World cancels the distribution of your digital good and sends you an email message requesting that you add more license keys.

comments powered by Disqus