Google Play Console In-App Purchase Subscription
This section of the support document provides the steps for setting up subscriptions within Google Play Console for all Android devices.
Caution: Before in-app products can be setup, an APK must be uploaded. Data Needed to Complete Process:
- Product ID — Unique alphanumeric ID that is used to access the product and syncing with Kochava.
WARNING: The Product ID cannot be used again across any other app, even if the product is deleted. Best Practices: Because the Product ID cannot be used again, it is a valuable practice to be organized with the creation of your Product IDs. Kochava recommends using the following format app_price_duration_introduration_introprice - Name — The name of the item (up to 55 characters) that is displayed on the Google Play Store listing.
- Description — The description of the item (up to 80 characters) that will be displayed on the Google Play Store listing.
- Billing Period — For Subscriptions only, the billing period of the subscription.
- Default Price — The subscription price in local currency or select a template.
- Log into Google Play Console.
- Click on All Applications and select the desired app.
- Select Products > In-app products.
- Click Create product.
- Enter the Product ID.
- Enter the Product Name.
- Enter the Product Description.
- Select the Pricing Template or Enter a Set Price.
- Select Products > Subscriptions.
- Click Create subscription.
- Enter the Product ID.
- Enter the subscription Name.
- Enter the subscription Description.
- Click + Add benefit and select a benefit. (optional)
- Select the desired Billing Period.
- Enter the Default Price.
- Select if this subscription is a Free Trial. (optional)
- Select the Introductory Price. (optional)
- Select the Grace Period. (optional)
- Select to enable or disable Resubscribe.
Depending on the in-app product type, follow either the In-App Products or Subscriptions instructions below:
In-App Products:
Subscriptions:
NOTE: Before the Subscription Options can be set, a billing period must be selected first.
- Product ID — Unique alphanumeric ID that is used to access the product and syncing with Kochava.
Apple App Store In-App Purchase Subscription
This section of the support document provides the steps for setting up in-app purchase subscriptions within App Store Connect for iOS, iPadOS, macOS, tvOS and watchOS.
- Log into App Store Connect.
- Click My Apps.
- Select the desired app.
- Select Manage > In-App Purchases > +.
- Select the desired Subscription Model:
- Auto-Renewable Subscription — This selection will allow users to purchase dynamic content for a set amount to time. This subscription will renew automatically unless the user cancels.
- Non-Renewable Subscription — This selection will allow users to purchase a subscription for a limited time. The content of this in-app purchase can be static, and this subscription will not automatically renew.
- Click Create.
- Enter a Reference Name.
- Enter a Product ID.
- Enter the Subscription Group Reference Name.
- Click Create.
BEST PRACTICES: Ensure that the latest Paid Applications Agreement has been signed in the Agreements, Tax and Banking section of App Store Connect. In-app purchases will not be able to be tested until this agreement is signed with Apple. NOTE: This document illustrates the process for setting up Auto-Renewable Subscription, however the steps required for the Non-Renewable Subscription are similar.
Best Practices: If the Auto-Renewable Subscriptions option is not present, ensure that the account has accepted all applicable contracts and has provided tax and banking information in the Agreements, Tax, and Baking section of the App Store Connect. NOTE: The reference name will be used on App Store Connect and in Sales and Trends reports. It will not be displayed on the App Store. The name cannot be longer the 64 characters.
NOTE: The product ID is a unique alphanumeric ID used for reporting purposes.
WARNING: After the Product ID has been used for one product, it cannot be used again, even if the product is deleted. NOTE: The subscription group name will only appear on the App Store Connect and in Sales and Trends reports. It will not appear on the App Store.
Selecting a Subscription Duration:
The Auto-Renew Subscriptions allow the the user to purchase updates and dynamic content for a set amount of time (duration of the subscription).
- Select the desired Subscription Duration:
- 1 Week
- 1 Month
- 2 Months
- 3 Months
- 6 Months
- 1 Year
Family Sharing:
Turning on Family Sharing will allow family members to share the subscription without having to use each other’s accounts.
NOTE: Once Family Sharing has been turned on, it cannot be turned off.
- Click Turn On.
- Click Confirm.
Subscription Prices:
The Subscription Price settings provides the ability to set the starting subscription price as well as an introduction or promotional values for the subscriptions.
- Click Subscription Prices > +.
- Select the Currency.
- Select the Price.
- Click Next.
- Click Create.
- Click Save located in the top right corner.
NOTE: A display of the price for each county or region based on the selected price will be displayed. You can choose a different price for individual countries or regions.
Introductory Offers —
The Introductory Offer is the initial price that a customer pays for the subscription and when the introductory time period has completed, the customer will be charged the full subscription price.
- Click the Introductory Offers menu.
- Click Introductory Offers > +.
- Select the Countries of Regions for Introductory Offer.
- Click Next.
- Enter the Start Date.
- Enter the End Date.
- Select the Type of Introductory Offer:
- Pay as you go
- Pay up front
- Free
- Enter the Duration.
- Enter the Currency and Price.
- Click Next.
- Adjust the Introductory Offer Prices for any country.
- Click Done.
- Click Save located in the top right corner.
In-App Purchase Localization Settings:
This section provides the directions for setting the in-app purchase localization settings for the desired app.
- Select In-App Purchases > Manage.
- Select the desired in-app purchase.
- Click Localization > +.
- Select the desired language.
- Enter the Subscription Display Name.
- Enter the Description.
- Locate the Review Information section and Click Choose File.
- Add Review Notes. (optional)
- Click Add localizations.
- Click Localizations > +.
- Select the desired Language.
- Enter the Subscription Group Display Name.
- Select to Use App Name or to Use Custom Name.
- Click Save located in the top right corner.
NOTE: The Display Name and Description are visible to the user on the App Store.
tvOS Integration: It is highly recommended that a short display name that describes the level of access the subscription unlocks be used. Using the same Subscription Display Name for all of the subscriptions that unlock the same level of access will assist in a more useable listing for your customers. Adding Reviewer Information —
This section details the settings to add information for the app reviewer.
An image of up to 640 X 920 pixels should be uploaded of the in-app purchase paywall for the reviewer.
The Review Notes provides an area for comments, instructions or clarifications to be added for the reviewer.
Subscription Groups —
If a Subscription Group has not been set up before, a warning will be displayed stating that “Before you can submit your in-app purchase for review, you must add at least one localization to your subscription group.”
If the app name is different then the service or publication name, it may be wise to enter a custom name.
Stripe In-App Purchase Subscription
This section of the support document provides the steps for setting up in-app purchase subscriptions within Stripe.
- Log into the Stripe Dashboard.
- Click Products > + Add product.
- Enter the product Name.
- Enter the product Description. (optional)
- Upload an Image. (optional)
- Enter a Statement descriptor. (optional)
- Enter the Unit label. (optional)
- Add Metadata. (optional)
- Select the desired Pricing model:
- Standard pricing
- Package pricing
- Select the desired Currency.
- Enter the desired Price.
- Select One time.
- Select Recurring:
- Select the Billing period:
- Daily
- Weekly
- Monthly
- Every 3 Months
- Every 6 Months
- Yearly
- Custom:
- Check Usage is metered. (optional)
- Enter a Price description. (optional)
- Click Save product.
The product name is visible to the customer at checkout, in receipts, invoices and the customer portal.
The product description appears at checkout, on invoices and in the customer portal.
This image will be visible to the customer, the file size should be less then 2MB.
If the statement descriptor is entered, it will override the account descriptor. Ensure that if the Statement descriptor is entered, it is clear enough that the customer will recognize it on a bank statement.
The Unit label appears at checkout, in receipts, invoices and in the customer portal. The Unit label describes how the subscription is sold.
Meta data is used to store additional structured information.
NOTE: If the same price is charged for each unit, select standard pricing.
or
Select days, weeks or months and enter a value.
Checking metered milling allows the customers to be charged based on reported usage at the end of each billing period.
Adding a price description may assist in organizational if there are a large number of subscriptions.
Stripe Product ID Location:
Once the product has been created, the Product ID can be located on the main Products page in the following locations:
NOTE: The Stripe Product ID is automatically generated and has a prefix of prod_.
- Details Section
- Events Section
NOTE: If the Product ID has recently been created, there will be a log within the Events Section. If other events have occurred since the creation of the Product ID, the creation of the Product ID will not be listed.