Configuration for the Amazon Appstore

Introduction

This guide describes the process of setting up the Amazon Appstore for use with the Unity in-app purchasing (IAP) system. This includes establishing the digital records and relationships that are required to interact with the Unity IAPAbbreviation of Unity In App Purchase
See in Glossary API, setting up an Amazon developer account, and testing and publishing a Unity IAP application.

As with other platforms, the Amazon store allows for the purchase of virtual goods and managed products. These digital products are identified using a string identifier and an additional type to define durability, with choices including subscription (capable of being subscribed to), consumable (capable of being rebought), and non-consumable (capable of being bought once).

Cross-store implementation of in-app purchases

There are cross-store installation issues with publishing to multiple Android IAP stores (e.g. Amazon and Google) simultaneously and shared Android bundle identifiers. Please see the page on Cross-store installation issues with Android in-app purchase stores to learn more.

Amazon Appstore

Getting started

1. Set up an Amazon developer account at the Amazon developer portal.
2. Write a game implementing the Unity IAP API. For reference, see the guides on Unity IAP initialization and Integrating Unity IAP in your game. Use the Amazon Appstore for apps with no restrictions on IAP items.

Device setup

1. For Android devices, download and install the Amazon Appstore.

2. For FireOS devices, the Amazon Appstore should come pre-installed.
   
   Note: Though you may freely target FireOS devices, FireOS is not a Unity-supported platform.
   
   

3. Once you have installed the Amazon Appstore, install the Amazon App Tester.

   

4. Set up the Android SDK
   1. To install and watch the Android debug log, ensure you have the Android SDK installed. Download the relevant command line tools package from the Android SDK install page and extract them to your computer.
   2. Confirm that the SDK recognizes the attached Android device through the command-line adbAn Android Debug Bridge (ADB). You can use an ADB to deploy an Android package (APK) manually after building. More info
      See in Glossary
      tool. For example:

|[11:07:01] user@laptop:/Applications | $ adb devices
List of devices attached
00DA0807526300W5    device

Unity app setup

Setting up to use Unity’s IAP takes a few steps.

1. Import the Unity IAP plug-inA set of code created outside of Unity that creates functionality in Unity. There are two kinds of plug-ins you can use in Unity: Managed plug-ins (managed .NET assemblies created with tools like Visual Studio) and Native plug-ins (platform-specific native code libraries). More info
   See in Glossary
   . See Setting up Unity IAP for more information (Unity 5.3 or higher).

2. Set the IAP target store. You should already have an Android app set up. Set the target store using Unity IAP’s Window > Unity IAP > Android > Target Amazon menu item. This is used to toggle between Google, Amazon, and other Android stores.

   

Alternatively, call the API:

UnityPurchasingEditor.TargetAndroidStore(AndroidStore.AmazonAppStore)

Amazon Appstore setup

It’s not necessary to download Amazon’s native IAP plug-in when preparing to use the Amazon stores, as all of the functionality it provides is already included in Unity’s IAP service.

1. Add your app. From the Amazon Developer Portal select Add a New App.

   

2. Set up your catalog. Using the product descriptions you prepared earlier, add the items to the Amazon catalog using the Amazon Developer Portal. Navigate to your app’s page, and find the In-App Items section. Use the Add a Consumable, Add an Entitlement, or Add a Subscription buttons to set up your catalog.