Get started with the iOS SDK
The Adjust iOS SDK enables you to track attribution, events, and much more in your iOS app. Follow the steps in this guide to set up your app to work with the Adjust SDK. You can also check out our example apps on GitHub.
To start using the Adjust SDK, you will first need to add it to your project as a dependency.
Swift package manager
Add as framework
Carthage and framework import
The Adjust SDK is able to get extra information when you include certain iOS frameworks in your app. Adding frameworks and marking them as optional enables additional features in the Adjust SDK.
|This framework is needed so that the SDK can access the IDFA value and – prior to iOS 14 – LAT information.||If your app is targeting the "Kids" category, you should not implement this framework.|
|This framework is needed so that the SDK can automatically handle attribution for ASA campaigns you are running.||If your app is targeting the "Kids" category, you should not implement this framework.|
|For devices running iOS 14.3 or higher, this framework allows the SDK to automatically handle attribution for ASA campaigns. It is required when leveraging the Apple Ads Attribution API.|
|This framework is needed so that the SDK can determine current radio access technology.||
|This framework is needed to access the SKAdNetwork framework and for the Adjust SDK to handle communication with it automatically in iOS 14 or later.|
|This framework is needed in iOS 14 and later for the SDK to be able to wrap the user tracking consent dialog and access the user’s consent response.||If your app is targeting the "Kids" category, you should not implement this framework.|
|This framework allows you to make use of web views in your application.||This is only needed if your app makes use of web views.|
Once you've added all necessary frameworks, you can initialize the Adjust SDK within your application. To do this, initialize your ADJConfig object with your app token and the environment you want to run your application in.
ADJEnvironmentSandbox. Change this to
ADJEnvironmentProductionbefore you submit your application to the App Store.
Web bridge setup
allowSuppressLogLevelto true in your
ADJConfiginstance and call the
setLogLevelmethod with the value
To set the verbosity of logging, use the
logLevel property in your
ADJConfig instance. You need to do this before calling
appDidLaunch for it to take effect.
Well done! You should now be able to build and run your app. Enable logging to check for any issues. You are ready to start attributing your users with the Adjust SDK.