开始使用 Adjust iOS SDK

选择 Adjust iOS SDK,您就能在自己的 iOS 应用中跟踪归因、事件及更多。请按照本指南中说明的步骤操作,进行应用 Adjust SDK 设置。您还可以在GitHub上查看我们的实例应用。

第 1 步:设置环境

要开始使用 Adjust SDK,您首先要将其作为 dependency 添加至项目中。

重要提示:
Adjust SDK 支持 iOS 9 或更新版本。

Cocoapods

Carthage

Swift package manager

添加为框架

第 2 步:集成 SDK

Cocoapods

Carthage 和框架导入

第 3 步:添加 iOS 框架

在应用中添加特定 iOS 框架后,Adjust SDK 就能获取额外信息。添加框架并将其标记为 optional​ (可选),即可在 Adjust SDK 中启用额外的功能。

框架描述注意事项
AdSupport.framework如果您希望 SDK 能访问 IDFA 值和 (iOS 14 以前的) LAT 信息,请添加该框架。如果您的应用属于 "儿童" (Kids) 类别,请不要安装该框架。
AdServices.framework该框架对于处理 Apple Search Ads 是必要的。
StoreKit.framework如果您希望访问 SKAdNetwork 框架,同时让 Adjust SDK 在 iOS 14 或未来版本的 iOS 中自动处理与该框架的通讯,请添加该框架。
AppTrackingTransparency.framework如果您希望 SDK 能在 iOS 14 或未来版本的 iOS 中包装用户的跟踪许可对话框,并访问用户的许可响应,请添加该框架。如果您的应用属于 "儿童" (Kids) 类别,请不要安装该框架。
WebKit.framework该框架允许您在应用程序中使用网络视图 (web view)。只有在应用使用 web view 的时候才有必要。

第 4 步:初始化 SDK

安装所有必需的框架后,您就可以初始化应用程序中的 Adjust SDK 了。要进行 SDK 初始化,请使用应用识别码及您希望应用程序运行的环境来初始化 ADJConfig 对象

重要提示:
在进行测试时,请确保将环境设置为 ADJEnvironmentSandbox 。请在向 App Store 提交应用程序前,将环境设置变为 ADJEnvironmentProduction

标准设置

iMessage 设置

网桥设置

第 5 步:设置日志

请注意:
如果要禁用所有日志,请在 ADJConfig实例中将 allowSuppressLogLevel 设为 true,然后用值 ADJLogLevelSuppress 调用 setLogLevel 方法。

要设置日志的输出级别,请在 ADJConfig 实例中使用 logLevel 属性。您需要在调用 appDidLaunch 之前这么做,才能设置级别。

Objective-C

Swift

Javascript

第 6 步:创建应用

太好了!您现在可以创建并运行应用了。请启用日志,检查可能存在的问题。您现在已经准备就绪,可以使用 Adjust SDK 进行用户归因了。