Google’s new billing system introduces several noteworthy enhancements to the in-app billing and subscription system.
With the new subscription architecture, single subscriptions can now have multiple base plans, and each base plan can offer various discounts or offers. This new structure consists of three main components:
- Subscriptions: Referring to sets of benefits that users can enjoy for a specific period (the items being sold). For instance, a "Gold tier" providing premium features for subscribers.
- Base plans: Representing specific configurations of billing periods, renewal types, and prices (how the items are sold). Examples include "annual with auto-renewal" or "prepaid monthly."
- Offers: Entailing discounts available to eligible users, modifying the base plan's price. For instance "free 14-day trial for new users."
Previously, developers had to create separate subscriptions for each unique combination of benefits, billing period, and discounts. However, with the new architecture, developers can flexibly define subscription plans with varying benefits and pricing options.
Adapty SDK 2.6.0 already supports Google Billing Library v5 and v6 as well as the modern Google Play subscriptions structure such as multiple base plans per subscription, multiple offers per base plan, and multiple phases per offer.
Please refer to our documentation for more details about how to migrate to Adapty SDK 2.6.0.
Another significant addition is the support for prepaid plans. These subscriptions do not automatically renew, meaning users must actively extend their subscription before it expires. This feature enables more flexibility in subscription offerings and allows users to have greater control over their subscription duration.
To begin the process of setting up products for Android devices, the first step is to log into Google Play Console.
To create an in-app product or subscription, navigate to the Subscriptions or In-app products page and click on the Create button. Here, you will need to provide the product ID and name.
Please provide the following required metadata to Google after clicking Create:
Product ID: The product ID is an exclusive alphanumeric identifier utilized to access your product during development and synchronize it with Adapty. Once a Product ID is assigned to a product in the Google Play Console, it cannot be reused for any other apps, even if the product is deleted.
When naming your product ID, it is advisable to follow a standardized format. We recommend using a more concise approach and naming the product
<subscription name>.<access level>. Then, you can control the duration and billing frequency through the use of base plans, such as weekly, monthly, and so on.
Name: Choose a concise name for the item, limited to 55 characters. This name will be visible on your Google Play Store listing.
Google Play subscription products in Adapty
Adapty products correspond to Base Plans for Google Play subscriptions since those are the products available for customers to purchase. Adapty seamlessly handles the migration of existing Google Play subscriptions along with their corresponding base plans in products, requiring no additional action from you. However, when you add a new product in Adapty, you will be responsible for providing both the base plan ID and the product ID.
For subscription products, you'll need to add a base plan. Base plans determine the billing period, price, and renewal type for customers to purchase your subscription. Please note that customers do not directly purchase a subscription product. Instead, they always buy a base plan within a subscription.
To create a base plan, click on the Add base plan button and complete the required fields. Make sure to specify the price and click Activate to finalize the setup.
Keep in mind that subscription products can only have a single base plan with consistent duration and renewal type in Adapty.
Support for non backwards-compatible base plans
Older versions of Adapty SDKs do not support Google Billing Library v5+ features, specifically multiple base plans per subscription product and offers. Only base plans marked as backwards compatible in the Google Play Console are accessible with these SDK versions. Note that only one base plan per subscription can be marked as backwards compatible.
To fully leverage the enhanced Google subscription configurations and features in Adapty, we offer the capability to set up a backward compatible fallback product. This fallback product is exclusively utilized for apps using older versions of the Adapty SDK. When creating Google Play products, you now have the option to indicate whether the product should be marked as backward compatible in the Play Console. Adapty utilizes this information to determine whether the product can be purchased by older versions of the SDK (versions 2.5 and below).
Suppose you have a subscription named
subscription.premium that offers two base plans: weekly (backward compatible) and monthly. If you add
subscription.premium:weekly product to Adapty, you don't need to indicate a backward compatible product. However, in the case of
subscription.premium:monthly product, you will need to specify a backward compatible product. Failing to do so could result in an unintended purchase of
subscription.premium:weekly product in Google 4th billing library. To address this scenario, you should create a separate product where the base plan is also monthly and marked as backward compatible. This ensures that users who select the
subscription.premium:monthly option will be billed correctly at the intended frequency.
Once you have completed adding your in-app products and subscriptions with base plans and offers in Google Play Console, the next step is to add these products to the Adapty dashboard.
Updated 8 days ago