https://github.com/namiml/nami-amazon
Easy Amazon Appstore subscriptions & in-app purchases, with powerful built-in paywalls and A/B testing.
https://github.com/namiml/nami-amazon
amazon amazon-iap android fire-tv in-app-purchase paywall subscriptions
Last synced: about 1 month ago
JSON representation
Easy Amazon Appstore subscriptions & in-app purchases, with powerful built-in paywalls and A/B testing.
- Host: GitHub
- URL: https://github.com/namiml/nami-amazon
- Owner: namiml
- License: other
- Created: 2023-02-06T20:18:16.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2023-02-06T23:36:42.000Z (over 2 years ago)
- Last Synced: 2025-04-02T22:36:54.703Z (about 2 months ago)
- Topics: amazon, amazon-iap, android, fire-tv, in-app-purchase, paywall, subscriptions
- Homepage:
- Size: 176 KB
- Stars: 5
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
## What is Nami?
Nami is on a mission to help you grow your Fire TV app revenue from IAPs and subscriptions.
Go beyond basic Amazon Appstore IAP infrastructure and focus on results with:
* Library of smart paywall templates to choose from, implemented natively using Jetpack Compose
* Paywall CMS so you can make change instantly, without submitting an app update
* Experimentation engine to run paywall A/B tests so you can improve your conversion rates
* Built-in IAP & subscription management and analytics, so you don't need another solution
Nami is simple adopt while giving you the tools you need to improve revenue. Our free tier is generous, and gives you everything you need to get started. [Sign up for a free account](https://app.namiml.com/join/)
Get started by heading over to our [quick start guide](https://docs.namiml.com/docs/nami-quickstart-guide)
## Getting the Nami Framework
### Requirements
- Android SDK minimum version 22
- SDK builds target Android 12 (API version 31)
- SDK has been built with Java v8 and Kotlin v1.6.10
### Add Maven repostiory
```java
allprojects {
repositories {
google()
mavenLocal()
maven { url "https://packages.namiml.com/NamiSDK/AmazonAppStore/"}
}
}
```
### Add Nami SDK dependency
dependencies {
implementation "com.namiml:sdk-amazon:3.0.5"
}
### Add Java 8 compatibility
```java
android {
...
// Configure only for each module that uses Java 8
// language features (either in its source code or
// through dependencies).
compileOptions {
sourceCompatibility JavaVersion.VERSION_1_8
targetCompatibility JavaVersion.VERSION_1_8
}
// For Kotlin projects
kotlinOptions {
jvmTarget = JavaVersion.VERSION_1_8.toString()
}
}
```
## Configure the SDK
We recommend that you configure the Nami SDK as early in your app's launch as possible. This will ensure the SDK is ready to receive and process purchases.
The best spot to do this is in the onCreate() method in your class that creates your Application and inherits from Application(). Here's a full code example.
You can find the Nami App Platform ID under the Nami Control Center's [Integrations > Google Play](https://app.namiml.com/integrations/) section.
```kotlin
import com.namiml.Nami
import com.namiml.NamiConfiguration
import com.namiml.NamiLogLevel
class DemoApplication : Application() {
override fun onCreate() {
super.onCreate()
Nami.configure(
NamiConfiguration.build(this, "YOUR_APP_PLATFORM_ID") {
LogLevel = NamiLogLevel.INFO.takeIf { BuildConfig.DEBUG } ?: NamiLogLevel.WARN
}
)
}
}
```
## Next Steps
Once the SDK is initialized, you're ready to show a paywall. See the [complete guide to setting up Nami for Amazon Appstore](https://docs.namiml.com/docs/amazon-appstore-android-setup) to find out how.
## Other Resources
The Nami Amazon Appstore SDK tracks our primary Nami Android SDK.
Please find additional resources such asrelease notes, docs, and references from that repository which is linked below:
### Release Notes
- [Stable](https://github.com/namiml/nami-android/wiki/Nami-SDK-Stable-Releases)
- [Early Access](https://github.com/namiml/nami-android/wiki/Nami-SDK-Early-Access-Releases)
### Documentation
- [SDK Reference](https://docs.namiml.com/reference/)
### References
- [Third-Party Software](https://github.com/namiml/nami-android/wiki/Third-Party-Software)