Subscription tracking

Warning:
Adjust no longer offers subscription recording for new customers. If you are already set up with subscription recording, reach out to your dedicated Technical Account Manager or support@adjust.com.

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.

Helpful information

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

SDK setup

To use this feature, you first need to download and set up the Adjust SDK for your platform. Follow the instructions linked below to get started.

⚙️ Platforms

Once you have the Adjust SDK installed and configured, follow the guides linked below to use this feature:

📖 Android / iOS / Cordova / Flutter / React Native / Titanium / Unity / Xamarin

  • 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 add your app to the Adjust dashboard and share credentials with Adjust. You need to finish both of these steps before you can start tracking.

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 > Choose a project to link.
  • You can then choose to Create a new project or Link existing project.

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 Cloud Platform.
  2. Select Create Service Account.
  3. Name your Service Account.
  4. Select Create and Continue.
  5. Select Manage keys.
  6. Select Create new key.
  7. Select Key type: JSON and then Create.
1/5

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

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. Grant the following permissions:
    • App access: View app information
    • Financial data: View financial data, Manage orders and subscriptions.
  4. Select Apply.
  5. Select Send Invite.
  6. Add an app to grant permissions and select Save changes.

After you have successfully followed these steps, you can now upload your JSON credentials to the Adjust dashboard under Subscription Tracking.

1/4

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 Production Server URL

  1. Log in to your iTunes Connect account and select the My Apps tab.
  2. Select the app you want to set up.
  3. Select App Information from the side navigation bar.
  4. Scroll down to App Store Server Notifications, and navigate to the Production Server URL field.
  5. Click Set Up URL.
  6. Enter: https://subscription.adjust.com/v2/appstore/.
  7. Select Version 1 Notifications.
  8. Click Save.

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

1/5
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