Adjust migration guide

Make the switch—our migration plan helps you get set up smoothly and keep tracking without missing a thing. The Adjust migration plan is based on a one-month transition and setup timeline. Each step takes approximately one week to complete. If you’d like to customize or expedite your integration timeline, please speak with your Adjust sales engineer.

Dashboard setup and data import

To start, we provide an informative demo of Adjust’s capabilities and get you started with setting up your Adjust dashboard.

You will learn:

  • How to set up your apps and in-app events
  • How to set up raw data callbacks or raw data uploads

Once your dashboard setup is complete, you can invite account users to access it. Next, we import your existing user base. 

To import your data, we require you to share the following information in a CSV file. Please note: your CSV file should be separated by platform (iOS, Android etc.).


Your CSV file must contain the following fields, in this order:

  • Required: Device ID
  • Required: Unix install timestamp
  • Network name
  • Campaign name
  • Adgroup name
  • Creative name

Your CSV file must conform to the following:

  • UTF-8 format
  • Comma-separated with quote qualifier
  • Unix install timestamp as an integer and specified in seconds

When organizing your data, we recommend that you follow the structure and group all your imported devices under one top-level (network) tracker named Imported Devices. Below this top-level tracker, you will be able to drill down through your existing campaign structure to a depth of three sublevels.

The data in your file would look something like this:

8C6CBCOD-5F43-4765-A6E6-84DFF3D24707,1403568000,Imported Devices,Network,Campaign,Publisher ID (or similar)

If you do not provide campaign structure details, we will automatically group all your imported data under a top-level (network) tracker named Imported Devices. Furthermore, if the data is provided without a timestamp, we will use the import date as the install timestamp.

Note: Imported users do not automatically appear within your dashboard reporting; each imported user must trigger an app session (in the app version with the Adjust SDK integrated) to be included in your Adjust dataset.

We can import iOS and Android devices. The mandatory device IDs for the different platforms are:

PlatformStoreDevice ID
AndroidGoogle Play StoreGPS_ADID
AndroidAmazon App StoreAndroid ID
iOSiTunes App StoreIDFA

Please include your app token in your CSV filename, along with the platform. For example, if your app is for iTunes and your app token is sgnadsdg354gfan, you should send us a file with the naming convention sgnadsdg354gfan_iOS.csv.

We will notify you as soon as your data import has been completed.

Step one: SDK integration and testing

While we import your existing user base, you can begin integrating and testing the Adjust SDK.

All Adjust SDKs can found on our Adjust GitHub pages.

During developer implementation and testing, you will be able to see and review test data within your Adjust dashboard. All SDK integration testing should be conducted with the SDK environment set to sandbox mode.

If your developers have any questions about SDK integration or want a thorough one-on-one walk-through of the integration process, we can arrange a workshop upon request.

For SDK-testing purposes, we suggest making use of the Adjust device API.

Once your sales engineer has confirmed a successful SDK integration and completed your user import, we will give you the green light to submit a new version of your app with the Adjust SDK integrated to the necessary app stores.

Note: Do not submit your app(s) to an app store before the data import is complete, or your existing user base will be counted as new users in Adjust.

Step two: campaign setup

With the Adjust Campaign Wizard, setting up campaigns is easy. For customized setup support, simply provide us with a list of partners, and we can arrange a campaign workshop to walk you through the process.

We'll discuss:

  • The types of campaigns you can track
  • The levels of information you can receive
  • How to create a tracker URL
  • How to enable partner modules
  • Our attribution methodology

After this workshop, you will be ready to reach out to your network partners for campaign configuration.

Note: Networks should not begin testing until after the version of your app with the Adjust SDK integrated is live in the app store.

Once your campaign is up and running, your Adjust sales engineer will confirm that your tracking setup is correct and that reporting is in order.

Step three: analysis and optimization

Once your app (with a properly integrated SDK) is live in the app store and your campaign data is tracking in Adjust, we will set up our final migration workshop.

We'll cover:

  • How to analyze your data
  • How to pull reports
  • How to receive raw data
  • Recommendations on how to approach your user-acquisition growth strategy

With this, you have all the tools and knowledge you need to begin making the most of Adjust's features and tracking data. We are always available whenever you need further advice or clarification. Just contact your AM or reach out to