中文

开始使用 Adjust iOS SDK

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

第 1 步:设置环境

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

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) 类别,请不要安装该框架。
iAd.framework如果您希望 SDK 自动处理您的 ASA 推广活动归因数据,请添加该框架。如果您的应用属于 "儿童" (Kids) 类别,请不要安装该框架。
AdServices.framework对于 iOS 14.3 及以上的设备,该框架允许 SDK 自动处理 ASA 推广活动归因数据。使用 Apple Ads 归因 API 时必须采用该框架。
CoreTelephony.framework如果您希望 SDK 能辨识当前的无线接入技术,请添加该框架。
  • Adjust iOS SDK v4.28.0 及更新版本无需该框架。
  • 如果您的应用属于 "儿童" (Kids) 类别,请不要安装该框架。
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 进行用户归因了。