adjust-icon

iOS SDK 集成指南

通过 Adjust iOS SDK,您可以在 iOS 应用中记录归因、事件以及更多信息。该指南展示了如何将 Adjust SDK 集成至应用。

1. 添加 SDK 至您的项目

要在您的 iOS 应用中使用 Adjust SDK,请先将 SDK 加入 Xcode 项目。

要使用 Swift package manager 添加 SDK:

  1. 选择 File —> Swift Packages —> Add Package Dependency
  2. 在出现的文本框中输入 SDK 的 GitHub 地址: https://github.com/adjust/ios_sdk
  3. Version 下拉菜单中选择要使用的 Adjust SDK 版本。请查看发布页面,找到最新版本。

其他安装方法

2. 集成 Adjust SDK

将 Adjust SDK 添加到 Xcode 项目后,您需要将其集成至应用。

3. 添加 iOS 框架

Adjust SDK 依赖各种框架读取具体设备信息。要启用设备信息读取,请添加对应框架,并将其标记为 可选

框架描述注意事项
AdSupport.framework允许读取设备 IDFA。对于操作系统为 iOS 14 及更早版本的设备,添加该框架也会允许读取 LAT 信息。如果您的应用属于 “儿童” 类别,那么请勿添加该框架。
AdServices.framework处理 ASA 归因。
StoreKit.framework允许访问 SKAdNetwork 框架。若要允许 Adjust 处理 iOS 14 或更新操作版本设备上与 SKAdNetwork 的通讯,那么必须添加该框架。
AppTrackingTransparency.framework若要允许 Adjust SDK 包装用户 ATT 许可对话,并读取 iOS 14 或更新操作版本设备的许可响应,那么必须添加该框架。如果您的应用属于 “儿童” 类别,那么请勿添加该框架
WebKit.framework允许在您的应用中使用 web 视图。只有在应用使用 web 视图时才有必要

3. 初始化 Adjust SDK

要初始化 Adjust SDK,您需要创建一个 config 对象。该对象包含控制 Adjust SDK 行为的配置选项。发送以下参数能够保证最少的设置:

  • appToken: 您的应用识别码。
  • environment: SDK 运行的环境。将其设为ADJEnvironmentSandbox

要使用此 config 对象初始化 Adjust SDK:

  1. 在您应用委托的 didFinishLaunchingdidFinishLaunchingWithOptions 方法中声明 config 对象。
  2. 将 config 对象的 logLevel 属性设置为 ADJLogLevelVerbose (详细)。您必须启用 verbose 日志记录,才能调取设备信息。
  3. 将 config 对象作为参数发送至appDidLaunch方法。

设置您的 iMessage 应用

如果您的应用面向 iMessage,那么您还需要进行下列额外的配置:

  • 如果您是从源代码添加 Adjust SDK,请确保您已在 iMessage 项目中添加了预处理宏 ADJUST_IM=1
  • 如果您将 SDK 作为框架添加,请务必在 Build Phases 项目设置中添加 New Copy Files Phase 。将 AdjustSdkIm.framework 复制到 Frameworks 文件夹。

记录会话

Adjust SDK 并未订阅 iMessage 应用中的 iOS 系统通知。要在应用进入或离开前台时通知 Adjust SDK,请调用 trackSubsessionStarttrackSubsessionEnd 方法。

didBecomeActiveWithConversation: 方法中添加对 trackSubsessionStart 的调用:

willResignActiveWithConversation: 方法中添加对 trackSubsessionEnd 的调用:

设置 Adjust Web Bridge

如果您的应用使用的是 web 视图,请务必设置 Adjust Web Bridge,以记录 web 视图中的信息。

AdjustBridge 集成到您的应用中

在项目导航中:

  1. 打开您的视图控制器 (View Controller) 源文件。
  2. 在文件顶端添加 import 导入语句。
  3. 在 Web View Delegate 的 viewDidLoadviewWillAppear 方法中,添加下列 AdjustBridge 调用:

您也可以使用其中包含的 WebViewJavascriptBridge。为此,请为 AdjustBridge 实例设置 bridgeRegister 属性。请查看关于库的文档,了解使用方法。

AdjustBridge 集成进您的 web 视图

要在 web 视图上使用 Javascript bridge,您就需要配置 bridge。请添加下列 Javascript 代码,初始化 Adjust iOS web bridge:

5. 配置 Adjust SDK

添加 config 对象和初始化逻辑后,您可以配置 Adjust SDK 来记录应用不同部分的信息。查看 SDK 配置和记录功能指南,设置您想要记录的信息。

6. 测试 Adjust SDK

完成配置,能通过 Adjust SDK 记录应用相关信息后,您就可以进行测试了。Adjust 为您提供测试控制台设备 ID,方便您测试应用。

请按照测试指南中的说明操作,确保您的应用能将预期值发送给 Adjust。

7. 针对生产环境构建应用

完成测试后,您就可以针对生产环境构建应用了。为此,请更新您的 config 对象。

更新以下值:

  • environment: 将其设为ADJEnvironmentProduction
  • logLevel: 选择日志级别,或在 config 对象中传送 allowSuppressLogLevel 参数,以完全禁用日志记录。

您可以使用 Xcode 版本标记 (flag),根据您创建的版本 (调试或生产版本) 情况动态更新 config。