Languages ▼
More ▼

Subscription tracking

With Adjust, you can track users’ subscriptions and measure signup behavior. Use your data to calculate users’ lifetime value (LTV) and create effective retargeting campaigns.

In this guide, you’ll learn how to get started with subscription tracking by adding your app to Adjust and sharing certain credentials. After you are set up, you can read our guides to manage subscription data and troubleshooting and FAQs.

Before you begin

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

Availability

  • Subscription tracking package
    • For more information, speak with your dedicated Sales representative or Technical Account Manager

Helpful information

  • Adjust can track purchases from the Apple App Store and Google Play Store.

Requirements

  • Subscription tracking enabled with the minimum Adjust SDK version.
    • Native Adjust Android SDK v4.22.0+ / Adjust iOS SDK v4.22.1+
    • Non-native SDKs Unity v4.22.1, React Native v4.22.0, Flutter v4.22.0, Xamarin v.4.22.0, Cordova v.4.22.0, Titanium v.4.23.0
Important:
Check your developer has set the call [Adjust trackSubscription:subscription]; for iOS and Adjust.trackPlayStoreSubscription(subscription); for Android when a subscription purchase is made.
  • In compliance with GDPR, make sure to encrypt all of your parameter data. Additionally, do not include any personal data (including, but not limited to, email address, age, name etc.) within the parameter data.

Getting started

To set up your app for subscription tracking, you have to integrate the Adjust SDK, add your app to the Adjust dashboard, and share credentials with Adjust. You need to finish all three stages before you can start tracking.

Integrate the Adjust SDK

Adjust uses our open-source SDK to implement our subscription tracking solution.

If you do not yet have the Adjust SDK integrated into your app, use our Github developer documentation to do so. Be sure to add the latest version. You can watch this video for more information. After, use our Testing Console to verify the implementation.

Note:
If the SDK is already integrated into your app, please ensure you are using Adjust Android SDK v4.22.0 or higher / Adjust iOS SDK v4.22.1 or higher. If you are not, upgrade the SDK now.

Add your App to the Adjust dashboard

First, add your subscription app to the Adjust dashboard. Be sure to select the correct platform (iOS or Android) and provide its app_token to complete setup.

Use our Add a New App article to guide you through these initial steps.

Share credentials with Adjust

To finish the setup in Adjust, we need some app-specific information. The credentials you need to share with Adjust depend on your app platform. Use the instructions for iOS and Android below to help you find these. If you have a multiplatform app, follow the instructions for both.

To add your credentials in the Adjust Dashboard, follow these steps.

  1. Find your app and select the options caret.
  2. Select Subscription.
  3. Enter your platform-specific credential information.
    • For iOS: App-Specific Shared Secret
    • For Android: Private Key Credential File
  4. Select Save.

Steps for Android apps

Google provides receipt validation for your subscription product through the Google Play Developer API. The API is linked and managed from the Google Play Console. The following steps show how to link your API project to the Play Console, and authorize it using a service account.

Already added your product to the Play Console?

Important

1. Link to your Google Developer Project

Go to the Google Play Console, select API access > Link. This connects your Play account to a Google Developer Project.

1/3

2. Create a Service Account

To create a service account and generate your private key credentials, follow these steps.

  1. Open the Google API Console.
  2. Select Create Service Account.
  3. Add your Service Account key credentials.
  4. Name the account.
  5. Assign the role of Project Owner.
  6. Select Create.

Great job. A JSON file will start to download. This contains the credentials required for communication between Adjust and Google.

1/2

3. Grant Financial Access

To grant financial access for your service account, follow these steps.

  1. Open the Google Play Console.
  2. Select Grant Access on the new Adjust service account.
  3. Set the following:
    • Role - Finance
    • Add - Manage Orders Permissions
  4. Select Save.

If these options are not available, you might not have adequate account permissions. Contact your Account Owner or Admin.

Steps for iOS apps

1. Set up the Apple Subscription Trigger URL

Log in to your iTunes Connect account and select the My Apps tab.

1/2

Select App Information from the sidebar, and navigate to the field in the bottom right-hand corner called Subscription Status URL.

Enter: https://subscription.adjust.com/v2/appstore/

1/2
Important:
Apple only supports one server notification URL. You can still forward the payload to the Adjust URL: https://subscription.adjust.com/v2/appstore/ in your app settings.

2. Find your App-Specific Shared Secret

  1. Sign into your iTunes Connect account.
  2. Go to My Apps and select your subscription app.
  3. Select Features > In-App Purchases.
  4. Select App-Specific Shared Secret.
  5. Copy your secret from the pop-up.
1/2