We constantly publish updates to our documentation, which may not yet be available in your language. For the most current information, use the English version.

for Marketers

Set up subscriptions for your app

With Adjust, you can record users’ subscriptions from the Apple App Store and Google Play Store. In this article, learn how to set up subscriptions for your app in Adjust.

Before you begin

Here's what you need to know before getting started.

Growth solution:

Subscriptions is available as an Adjust Growth solution. Speak with your Adjust representative or sales@adjust.com to get this added to your package.

Requirements

Admin, Editor or Custom Editor permissions in Adjust.
An app on the Apple App Store or the Google Play Store.
An iOS or Google Play Store app in AppView with a connected platform.

Set up the Adjust SDK

To integrate subscriptions in your app, ensure you have the minimal required SDK version installed and complete the necessary implementation steps for recording subscription events.

Set up your app

You need to set up your app before you enable subscriptions in Adjust.

iOS apps

Follow these steps to set up your iOS app.

1. Set up server notifications in your App Store Connect account.

2. Generate an In-app Purchase key.

3. Retrieve Private key, Key ID, and Issuer ID from App Store Connect.

4. Connect your App Store Connect credentials in Adjust.

For more information, see our detailed documentation on the subscription setup for iOS apps.

Google Play Android apps

Follow these steps to set up your Google Play Android app.

1. Set up real-time developer notifications for Android in your Google Play Account.

2. Create your JSON public key for your Google Service Account.

3. Grant financial access to your service account in the Google Play console.

4. Connect your Google Service Account in Adjust.

For more information, see our detailed documentation on the subscription setup for Android apps.

Enable subscriptions for your app

Now, enable subscriptions for your app:

In AppView, select your app.
Go to the Events & subscriptions tab.
Under Subscriptions, select Edit ().
Turn ON the Record subscriptions toggle.
Now, choose the account that you want to connect for your platform. If you were on a previous version of subscriptions in Adjust, ensure that you update your credentials in this step.
- iOS apps - Under Apple App Store Connect (iOS only), select the App Store Connect account that you added in Adjust. You can select Manage connections to view the App Store Connect accounts that you added in DataWorks > Connections for the Subscription service.
  - You need to use the same App Store Connect account credentials in Adjust for all apps in the App Store Connect account.
- Android apps - Under Google Play Store credential, select the Google Service Account that you added in Adjust. You can select Manage connections to view the Google Service Account that you added in DataWorks > Connections for the Subscription service. If you're on a previous version of Subscriptions, you might have to select Upgrade to upgrade to the new version.
Select Save.

And that's it - you're all set up!

Important:

For Google Play Android apps, you may need to wait for about 24 hours after completing your setup in Google Cloud Console and Google Play Console before you can access your subscription data. This is because Google needs time to process your credentials and give you access to its products.

Verify your setup

Follow these steps to verify your subscription setup.

Ensure that you've set up store notifications from the Apple App Store or Google Play Store.
Verify that you've connected the correct account for the Apple App Store or Google Play Store. For multiplatform apps, you need to add both sets of credentials.
Check and confirm that you've implemented the Adjust SDK in your app correctly.
Set your SDK environment to sandbox, and test if your subscriptions are recorded correctly.
In Datascape, select the Sandbox environment filter, and set up a report with relevant subscription events and metrics.
- There might be a delay of around 20 minutes before you see your data in Datascape. If you've set up server callbacks for subscriptions, then you receive data in your BI system immediately.

Once you see subscription data in your reports, change the SDK environment to production. This ensures that your app works in production mode.

Next steps

You can use subscription data to understand the value of your marketing spend and optimize future campaigns. For more information, see Manage subscription data.