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.
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:
idfa,timestamp,network,campaign,adgroup,creative 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:
|Android||Google Play Store||GPS_ADID|
|Android||Amazon App Store||Android ID|
|iOS||iTunes App Store||IDFA|
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
We will notify you as soon as your data import has been completed.
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
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.
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.
- 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.
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.
- 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 firstname.lastname@example.org.