Submitting Apps to the Amazon Appstore

In this topic, you will learn how to submit your Fire TV app to the Amazon Appstore.

Overview

This document will assist you in submitting your Brightcove Beacon app to the Amazon Appstore.

A high-level view of the process is:

  1. Add a new Android app in the Amazon Developer Console.
  2. Set the availability and pricing for your new Fire TV app.
  3. Add text descriptions for your Fire TV app in the Amazon Appstore.
  4. Add the icons and images for your Fire TV app.
  5. Select a content rating for your Fire TV app.
  6. Upload the APK file supplied by Brightcove.

The rest of this document will provide details for each of the steps above.

Amazon Resources

Required information for Amazon

  • Fire TV App icon (1280 x 720px PNG (no transparency)).
  • Between three and ten screenshots ( 1920 x 1080px JPG or PNG (landscape, no transparency).
    • These images must not appear distorted, stretched, or pixelated when viewed in the UI.
    • Please provide Fire TV screen shots when you submit your app, or use screenshots that can represent your app generically for all devices.
    • Note that if you do not provide Amazon Fire TV-specific screen shots for your app in the submission process, any phone or tablet screen shots you have provided are used to represent your app in the Fire TV App Store.
  • Background image 1920 x 1080px JPG or PNG (landscape, no transparency).
  • APK package provided from Brightcove.
  • Display title.
  • Short description.
  • Long description.
  • Product feature bullet points (Up to 10 key features of your Fire TV app).
  • Keywords (Search terms used to increase the discoverability of your app).

Submitting your FireTV App to the Amazon Appstore

Follow these steps to submit your FireTV App to the Amazon Appstore.

  1. Enter the Amazon Developer console. You will need to create an Amazon Developer account in order to use the console.
  2. In the Amazon Appstore section, click on the Add a New App button.
  3. From the drop-down menu, select Android. (At the moment Brightcove only supports the Android version for a Fire TV App submission.)
  4. The New App Submission form will display.
  5. Enter your App title.
  6. Choose an App SKU. This is a unique-to-your-app string that you define yourself. The SKU (Stock Keeping Unit) becomes the ID for your app for your own tracking purposes, for example: com.amazon.example.myapp.v1.
  7. Select an App category. By properly categorizing your app, users will be able to find your app more easily, which increases downloads for your app. For more information please review the Amazon category documentation.
  8. You can mark the Use my default support information checkbox or introduce different information details ( email, phone, website) for the customer support contact of the Fire TV app.
  9. Click on the Save button.
  10. After saving, you will reach the Fire TV app settings and the General Information tab.
  11. In this tab, you will be able to see your App Submission API Keys generated automatically by Amazon and all the information provided at the moment of creating your Fire TV app.

Complete the Availability & Pricing information

In this section you will be able to set the pricing and availability of your Fire TV app. Remember that the prices you select must match those set in the Brightcove Beacon platform.

  1. Click in the Availability & Pricing tab.
  2. In the first section, you will be able to choose where you would like your Fire TV app to be available:
    • In all countries and regions where Amazon sells apps.
    • Only in selected countries and regions.
  3. If you select Only in selected countries and regions, this option will allow you to select what countries or specific regions will be able to find your Fire TV app on the Amazon store. In the example shown below, all of North America and three countries in Europe are selected for the Fire TV app.
  4. To select a specific country from the region, click on the + Select countries/regions button.
  5. Select the countries you want your Fire TV app to be published from the region you choose.
  6. Click the Add button.
  7. The next option will allow you to select if your Fire TV app is Free or Paid. Normally the default Brightcove Beacon app is set as Free.
  8. If you select Paid, you will have to Set a baseline price and a type of currency. (Please contact your Brightcove Beacon account representative in the case you want to assign a price for your Fire TV app).
  9. (Optional) Leave this field blank to start the publishing process as soon as your Fire TV app has been approved. To defer the start of the publishing process to a future time and date, assign a publishing date for your Fire TV App.
  10. Click the Save button.

Creating an In-App Purchases (IAP) Subscription

In this section you will learn how to create an In-App Purchases subscription for your Fire TV app.

  1. After saving your Availability & Pricing settings, an additional field for Add IAP (In-App Purchases) will appear.
  2. Click in the Add IAP button to add In-App Purchases as subscriptions.
  3. You see the In-App Items tab.
  4. At the moment you will not have any in-app items there. To create one click in the Add Single IAP button.
  5. Note that you have three different types of in-app purchases to select.
    • Add a Consumable: A consumable includes any type of content that you sell within your app that is consumed within the app itself. This type of content is available only on the device from which it is purchased.
    • Add an Entitlement: An entitlement includes any type of content that you sell within your app that requires access rights. This type of content is available anywhere the customer is logged into the Amazon Apps client. The entitlement to the content does not expire.
    • Add a Subscription: A subscription includes any type of content that:
      • Carries an entitlement
      • Is bound by a period of time
      • Auto-renews at the end of the period
      • Is available on all eligible devices registered to the customer's Amazon account
    • Your app can have multiple subscriptions defined for it, with each subscription having multiple periods.
  6. Please select the IAP of your preference or contact your Brightcove Beacon account representative to know more about which options are best for your content.
  7. In this example, Subscription is selected.
  8. Give a Title to your new subscription.
  9. Choose an SKU. The SKU (Stock Keeping Unit) becomes the ID for your subscription for your own tracking purposes, for example subscription.gold.
  10. Click the Save button.
  11. After saving your IAP you will be prompted to the Subscription Period tab.
  12. Select a Subscription period. You will be able to select the time in which the subscription will be charged to your users. For example: monthly, weekly, annually, etc.
  13. Choose an SKU. The SKU (Stock Keeping Unit) becomes the ID for your subscription period for your own tracking purposes, for example monthly.subscription.
  14. (Optional) Select if you want to give a Free trial of your subscription. For example: 7 days, 1 month, etc.
  15. Select if you will be charging for this subscription. For charging, select the Yes, my base list price is... option.
  16. Enter your subscription price and the type of currency.
  17. The Calculated prices setting will appear which will allow you to decide if you want Amazon to calculate the list prices for you, or you set the prices manually.
  18. Click the Save button.
  19. Go to the Description tab and add a description to your new subscription.
  20. Click the Save button.
  21. When all your IAP settings are completed the Submit In-App Item button will be enabled. Click the button to send your IAP for approval to Amazon.
  22. Click the Submit In-App Item button and you will be able to see your IAP item in the In-App items tab list.

Complete the Description information

In this section, you will be able to add all the Fire TV app text descriptions that will be visible to the users in the Amazon store.

  1. Click in the Current Version tab and select the Description tab from the Fire TV app menu.
  2. Complete the following in the form:
    • Short description: A brief description of your app, shown on mobile devices.
    • Long description: A lengthier description of your app, for the App Store website.
    • Product feature bullets: Up to 10 key features of your app, one feature per line. These features will appear on the App Store website, formatted as a bulleted list.
    • (Optional) Keywords: Search terms used to increase the discoverability of your app, Use a comma or white space to separate your terms.
  3. By default, the description will be displayed in English but you can add translations by clicking on the Add Localized Descriptions button.
  4. A form will appear allowing you to select the translation languages you want to add.
  5. Click the Add button.
  6. At the top of the form, you will be able to select between the language forms and add each of the language descriptions.
  7. Click the Save button.

Complete Images & Multimedia information

In this section you will learn how to upload the images for your Fire TV app.

  1. Click in the Images & Multimedia tab.
  2. Click in the Table and Phone Assets section. Although your app is aimed for Fire TV and not tablets and phones, Amazon requires these images be supplied. You can use the same image sizes that you will use for your Fire TV app.
    Image Requirements Mandatory/Optional
    Icons PNG (no transparency)
    Width:1280px Height:720px
    Mandatory
    Screenshots Between 3 and 10 JPG or PNG (no transparency, landscape)
    Width:1920px Height:1080px
    Mandatory
    Background Image JPG or PNG (no transparency, landscape)
    Width:1920px Height:1080px
    Mandatory
    Featured Content Logo PNG (transparency optional)
    Width:640px Height:260px
    Optional
    Featured Content Background JPG or PNG (no transparency)
    Width:1920px Height:720px
    Optional
  3. Upload an image for the Icons by clicking in the box on the right.
  4. Upload an image for the Screenshots by clicking in the box on the right.
  5. Click in the Fire TV Assets section.
  6. Upload an image for the App Icon by clicking in the box on the right.
  7. Upload an image for the Screenshots by clicking in the box on the right.
  8. Upload an image for the Background Image by clicking in the box on the right.
  9. (Optional) Upload an image for the Featured Content Logo by clicking in the box on the right.
  10. (Optional) Upload an image for the Featured Content Background by clicking in the box on the right.
  11. Once all your images are uploaded you will be able to click on the Preview Images on TV button to have a visualization of how your Fire TV app will look like in the Appstore.
  12. Click the Save button.

Complete Content Rating information

The content rating section requests that you categorize the types of content that you will be presenting in your Fire TV app. The Amazon categorization divides content into these three types:

  • Moderate: Occurs once or rarely and is not fundamental to the overall purpose and/or intent of the app.
  • Strong: Occurs regularly and is fundamental to the overall purpose and/or intent of the app.
  • None: Does not occur in the app.

Types of the subjects are violence, academic, cartoon violence.

  1. Click in the Content Rating tab.
  2. Select a category type for each of the subjects. All this information corresponds to the content types of your Fire TV app. If you are not sure what to answer, please contact your Brightcove Beacon account representative.
  3. In the Additional Information section, respond Yes or No depending on the features that your Fire TV app contains. All this information corresponds to the additional information and features that your Fire TV app may or may not hold. If you are not sure what to answer, please contact your Brightcove Beacon account representative.
  4. If your Fire TV app collects personal information, you should add a Privacy policy URL to review your privacy policy statements for users.
  5. Click on the Save button.

Complete Android Package Kit (APK) Files information

The APK Files section is where the Android app file should be uploaded. The APK is supplied to you from Brightcove.

  1. Click in the APK Files tab.
  2. In the Apply Amazon DRM? option, select No.
  3. In the APK File section, click on the box of the right and upload the APK file supplied to you from Brightcove.
  4. Once the file is uploaded, you will be able to see your file on the screen. Click in the View button.
  5. The Device Support window will open, on which you can select the devices on which your Fire TV app will be supported.
  6. Click in the Amazon Fire TV tab and select all the devices. Brightcove Beacon is only available for Amazon Fire TV, so keep unselected the Amazon Fire Tablets and Phones and Non-Amazon Devices tabs.
  7. Close the Device Support window.
  8. In the Add Other Details section, select at least one language support from the list. This is the language in which users will communicate for support.
  9. For the Testing Instructions field, provide special instructions to the Amazon testing team, such as required login credentials to test video streams, or notes that explain how to use different subscription levels.
  10. Mark the Export Compliance and Use Amazon Maps Redirection checkboxes.
  11. Click the Save button.
  12. After saving, the Review Status tab will appear in the menu.
  13. You will be able to check information about your Fire TV app as your last activity and submission history. If there are not any errors, click the Submit App button at the top left corner of the screen to submit your Fire TV app.

Now you just have to wait for Amazon to approve your Fire TV app and publish it in the Amazon Appstore.