Monetize your Amazon Fire TV App with In-App Subscription/Purchasing Monetize your Amazon Fire TV App with In-App Subscription/Purchasing

Monetize your Amazon Fire TV App with In-App Subscription/Purchasing

***As of September 2017 Amazon had discontinued Web In-App subscription SDK

 Please read through and follow the below instructions to enable In-App Subscription and/or Purchasing for your Amazon Fire TV app.

1. Create an Amazon Developer Account.

2. Setup your subscription service through the Zype platform.

3. Enter an Amazon SKU for your subscription plans.

  • Navigate to Make Money from the side navigation menu, and select Subscription Plans.
  • For each of your subscription plans, you will need to enter a unique Amazon SKU (i.e. monthly-subscription, yearly-subscription)
  • Make a note of what you've entered as your Amazon SKU because you will need to reference this exact SKU in a later step.

native-subscription.png

4. Enter your Amazon In-App Purchasing Shared Key in the Zype platform.

  • From the Zype platform, navigate to Settings (gear icon in the top navigation bar) and click the Monetization tab. At the bottom, you will see a blank text box for your Amazon shared key. 

Screen_Shot_2017-08-29_at_5.12.07_PM.png

  • Click on the shared key link provided to you in the platform to find your key. Note - You will need to be logged into your Amazon Developer Account to be automatically directed to your shared key when clicking on the link.

5. Enable monetization (Subscription or Purchase) for individual videos or your entire library.

6. Create In-App Subscriptions or Purchasing items in your Amazon Developer Account. 

Good To Know 

IAP (In-App Purchasing) includes three different categories of purchasable items:

  • Consumables: Purchase that is made, then consumed within the app, such as extra lives, extra moves, or in-game currency. May be purchased multiple times.
  • Entitlements: One-time purchase to unlock access to features or content within an app or game. Choose this option if you are trying to set up in-app purchasing.  
  • Subscriptions: Offers access to a premium set of content or features for a limited period of time. Choose this option if you are trying to set up in-app subscriptions.

For step-by-step documentation on creating in-app subscriptions or purchasing items, we recommend following along with Amazon's documentation here. There are specific steps that we've outlined below that are a required as part of setting up your in-app subscriptions and purchases to make calls back to the Zype platform. So please read the following in tandem with Amazon's documentation.    

In-App Subscription Setup - General Information

Select Add a Subscription from the In-Apps Item tab in your Amazon Developer Account. 

  • Title: This title will be displayed within your app, so make sure to choose an appropriate title (i.e. Monthly Subscription or Yearly Subscription) for your subscription.
  • SKU: Enter the Amazon SKU that you created and entered in the Zype platform (review Step 3 above). Note - The Amazon SKU that you entered in the Zype platform (reference Step 3) must match EXACTLY with the SKU you enter in this field in order for your subscriptions to work properly. 
  • Content delivery: No additional file required

In-App Subscription Setup - Subscription Periods

  • Subscription Period: Choose a subscription period from the drop down menu (i.e. Monthly, Annually). 
  • SKU: Enter your Amazon SKU again under the Subscription Periods section, but repeat the SKU and add a dot as the separator.
    • Example: monthly-subscription.monthly-subscription
  • Note - The dot and repetition is due to the unique way Amazon handles purchase receipts and must be entered this way in order to process subscriptions/purchases properly. 

If you have multiple subscription periods (i.e. monthly, annually, quarterly), you must repeat this process and create individual plans in the Zype platform and in your Amazon Developer Account. 

DO NOT add multiple Subscription Periods (i.e. Monthly, Annually, Quarterly) under the same parent SKU. You must repeat Steps 3 and 6 for each subscription plan that you want available.  

In-App Purchasing (Entitlements) Setup - General Information

Select Add an Entitlement from the In-Apps Item tab in your Amazon Developer Account.

  • Title: This title will be displayed within your app, so make sure to choose an appropriate title (i.e. Purchase, Buy Now) for your subscription.
  • SKU: Enter a video ID from the Zype platform (i.e. 5629232e4d656c4e94b10000).
    • To find your video ID, navigate to your Library in the Zype platform. Select a video that you want to require purchase, and at the bottom of the details tab for that video you will find the video ID.  

native-purchase.png

  • Content Delivery: No additional file required

If you have multiple videos that you want set up to require purchase/entitlements, you must repeat this process and add individual entitlements for each in your Amazon Developer Account. 

Screen_Shot_2017-04-05_at_1.18.53_PM.jpg

7. Make sure to toggle In-App Subscription/Purchase ON in the Zype platform while going through the Amazon Fire TV App Builder flow (Step 4 - Monetization).

Once you've set up your monetization, you're ready to preview and test your Amazon Fire TV app. Click to continue reading documentation on Previewing, Testing and Submitting your app.