与服务器无关的移动端分析

做者：Joe，原文连接，原文日期：2016/04/12
译者：Cwift；校对：walkingway；定稿：CMB

移动应用分析是指捕获并分析用户在使用应用时产生的用户行为。固然，完整的应用分析包括了操做系统、桌面应用、web应用等等，移动应用分析只是其中的一个分支。直到今年早些时候，Parse 仍是一个流行的云平台，用于捕获和显示移动应用程序的使用数据。

从 Prase 的忽然离开给咱们上了一课。首先，对于从事软件开发超过一年的人来讲，不该该感到奇怪，没有什么是永恒的。因此，事情发生了改变。第二个教训多是，你曾经经历过由于平台不断改动引起的愤怒（或者疼痛），那么为何不抽象出一些底层的操做，而且让这些操做在未来更容易被更改呢？咱们已经从前人的经验中学习，准备应用到移动分析上，让应用更加的“面向将来”。

协议

关于何为协议，苹果的官方文档给出了一个简洁定义：为适配某些特定任务或功能，规划出的由方法、属性和其余要求组成的蓝图。下面是一些全部记录器都应该提供的基础方法：

• 记录后台的打印信息

• 记录事件

• 用数据字典记录事件

固然，在不一样的分析平台上你能够发现各式各样的特性，不过咱们但愿至少有以上三类关键数据。一个完美的协议定义以下：

import Foundation
 
protocol AnalyticsEventLogger {
  
  func initialize()
  func logEvent(name:String)
  func logEvent(name:String, data:AnyObject)
  
}

就协议 AnalyticsEventLogger 自己而言不作任何事情，它只是一个蓝图。咱们须要一个具体的分析框架来完成工做。

Amplitude

当咱们思考如何从 Parse 上迁移 Bondi 时，Amplitude是咱们遇到的第一个移动分析服务。它经过『一个记录事件的简单 API』实现了直截了当（而且免费）的注册流程。AnalyticsEventLogger 协议的实现起来也很是简单：

class AmplitudeEventLogger : AnalyticsEventLogger {
  
  func initialize() {
    Amplitude.instance().initializeApiKey(AmplitudeApplicationKey)
  }
  
  func logEvent(name:String) {
    Amplitude.instance().logEvent(name)
  }
  
  func logEvent(name:String, data:AnyObject) {
    Amplitude.instance().logEvent(name, withEventProperties: data as! [NSObject : AnyObject])
  }
 
}

CleverTap

CleverTap 是另外一个移动分析平台，提供快捷的注册和记录服务。不过说实话在应用中集成 CleverTap SDK 的步骤有些繁琐。咱们很快就意识到了问题所在，但为了完整起见，依旧列出这个基于 CleverTap 实现的事件日志工具样式：

import Foundation

class CleverTapEventLogger : AnalyticsEventLogger {
  
  func initialize() {
    CleverTap.changeCredentials(withAccountID: accountID, andToken: accountToken)
  }
  
  func logEvent(name:String) {
    CleverTap.sharedInstance().recordEvent(name)
  }
  
  func logEvent(name:String, data:AnyObject) {
    CleverTap.sharedInstance().recordEvent(name, withProps: data as! [NSObject:AnyObject])
  }

}

须要注意的关键点是，协议 掌控着方法：

• initialize()

• logEvent(name:String)

• logEvent(name:String, data:AnyObject)

基于 Amplitude 的事件日志工具在底层实现中使用了 Amplitude SDK 中的方法。基于 CleverTap 的协议实现将使用 CleverTap SDK 提供的方法。

注意：许多移动分析平台提供了更丰富的方法。好比，其中一些平台提供了用户在屏幕上触摸的热图分析。咱们的目标不是构建一个能涵盖全部移动分析功能的协议，而是着力于筛选出那些最有用的功能。

示例应用

咱们已经快速搭建了一个示例应用，容许你使用 Amplitude 或者 CleverTap 来实现事件日志工具的功能。下面的部分将经过演示引导你在程序的适当地方插入 API 密钥。不过，为了让程序跑起来，你须要在网上注册这些服务。

事件记录器自己是 AppDelegate 中的 eventLogger 实例。

class AppDelegate: UIResponder, UIApplicationDelegate {
  var window: UIWindow?
  var eventLogger:AnalyticsEventLogger = AmplitudeEventLogger()

  func application(application: UIApplication, didFinishLaunchingWithOptions launchOptions: [NSObject: AnyObject]?) -> Bool {

    eventLogger.initialize()
    eventLogger.logEvent(AnalyticsStartEvent)
    
    return true
  }

  // Additional routines
}

上面的代码中声明了一个名为 eventLogger 的类实例，该实例的上下文是协议 AnalyticsEventLogger。实际的实例将会是一个 AmplitudeEventLogger，这个类被声明在 AmplitudeEventLogger.swift 文件中。若是你想要使用 CleverTap，只须要简单地替换声明部分便可。

var eventLogger:AnalyticsEventLogger = CleverTapEventLogger()

实际上，你甚至不须要声明变量的类型（AnalyticsEventLogger）。Swift 的编译器可以推断出来。

获取代码

在终端上输入 git clone git@bitbucket.org:iachievedit/mobileanalytics.git 能够从 BitBucket 上获得示例应用的源代码。在 Xcode 中打开 appname.xcodeproj。

appname Project

项目的基础

示例项目中须要回顾的关键性文件以下：

• AnalyticsEventLogger.swift – 这个文件中包含了咱们的 AnalyticsEventLogger 协议，全部的事件日志工具都须要遵照这个协议。

• AmplitudeEventLogger.swift – 使用 Amplitude 服务实现的 AnalyticsEventLogger 协议

• CleverTapEventLogger.swift – 使用 CleverTap 服务实现的 AnalyticsEventLogger 协议

• ViewController.swift – 在示例应用中，当咱们按下屏幕上的那些按钮时，会打印对应的事件的分析。这些点击事件对应的 IBAction 被定义在控制器当中

• ApiKeys.swift - 这个文件中包含了一个实例，用来从一个 .plist 文件中提取 API 密钥。具体的实现细节将在将会在接下来的章节 API 密钥 中详细讲解。

API 密钥

大多数状况下，不表明所有，分析平台会让你使用一个单独的应用密钥或者使用用户帐号标识符和应用密钥的组合。这方面 Amplitude 和 CleverTap 没有什么不一样。示例应用使用了属性列表来管理 API 密钥。若是你尚未注册任何一个服务，请跳到专门讲解 Amplitude 或者 CleverTap 注册流程的章节为你的应用进行注册。

注意上面的 ApiKeys.plist 文件是红色的。这意味着这个文件不存在，因此你须要建立一个这样的文件，而后向其中添加你所选择的移动分析服务商密钥。为了能在 Amplitude 和 CleverTap 之间切换，你还须要同时保存两者的帐户和 API 密钥。能够经过下面的说明来了解，或者使用最初的模板工程尝试一下其余的服务，好比 Flurry 或者 AppAnalytics。

使用 Xcode 的 File – New – File 来建立一个 ApiKeys.plist 文件，而后选中 iOS Resource，选择 Property List 模板。点击 Next 而且把文件命名为 ApiKeys.plist，肯定对话框中勾选了将其添加到应用的 Target 中的选项。

为你想要在工程中引用的每个 API 建立密钥，好比 AmplitudeDevelopmentApplicationKey。若是你一直在使用这个示例工程而且使用了 Amplitude 和 CleverTap，你的 ApiKeys.plist 看上去应该是下面这样：

ApiKeys.plist

一旦 API 密钥就位，更新 AppDelegate 文件，选择你须要的日志工具，而后在真机或者模拟器上运行程序。

Logging Events

点击 Like，DisLike 等，按钮会调用移动分析的日志方法（见 ViewController.swift 文件）。在 Donate（捐赠） 按钮的情境中，日志方法将包含捐赠的数量。

Amplitude 入门

注意：这是一个有关如何注册 Amplitude 的简单介绍，并不涵盖全部的功能。
首先，你须要在 Amplitude 的注册页上注册。填写全部须要的信息（姓名、电子邮件等），而后你会看到 欢迎来到 Amplitude 的对话框。

点击 Let's Go 按钮，建立你的第一个应用。咱们在组织一栏填写 iAchieved.it LLC ，应用名一栏填写 Appname Development*。开发版本和应用版本的应用会有不一样的密钥。

点击 Continue而且选择 iOS SDK，而后点击 I’m Ready to Install。Amplitude 将会展现一个 Amplitude SDK 的安装页面，该页面提供了诸如如何下载 iOS SDK 、向工程中导入 SQLite 时应如何更新 build settings 的一系列说明，而后还展现了一个调用服务的 Objective C 示例。咱们热衷于在应用中使用 Swift 语言，因此在这一步时点击 Download the source code 连接下载 Amplitude 源码。解压下载获得的文件夹。

示例应用已经包含了 Amplitude SDK，可是若是你在使用一个新建的项目，把 Amplitude 子文件夹拖拽到工程目录中。肯定你勾选了 Copy items if needed 和 Create groups，固然还要肯定 application target 也是选中的。

AddingAmplitude

回到 Amplitude 的门户页，你能够点击 Install Amplitude SDK 页面的 Continue 按钮，而后点击 Done，当提示邀请成员加入你的团队时，选择 Skip。

添加附加框架

向你的 Xcode 工程中添加如下框架：

• libsqlite.tbd

能够经过下面的步骤轻松地增长框架：进入工程的 target 目录下，选择 Build Phases，来到 Link Binary With Libraries 功能区，而后点击 + 按钮选择框架。

添加桥接头文件

在 iAchieved.it，自 Swift 诞生之日起咱们就在使用这门语言，而且从未放弃。若是你也正在使用 Swift 构建你的工程，为了访问 Amplitude 的 API 你须要在工程中添加一个桥接头文件。桥接头文件很容易添加。首先，使用 File – New – File，选择 iOS Source，而后找到 Header file 图标。把文件命名为 bridgingHeader.h。

接下来，在应用的 target 中点击 Build Settings，在搜索框中输入 bridging，你将看到下面的页面：

双击 Objective-C Bridging Header 一栏，在对话框中输入 $(SRCROOT)/bridgingHeader.h。$(SRCROOT) 会被映射到你程序的根目录。

如今，在 bridgingHeader.h 文件中输入一行代码：#import "Amplitude.h"。

API 证书

应用须要的 API 证书能够从 Amplitude 轻松得到。在网站门户页，点击右上角的 account e-mail，而后在下拉菜单中选择 Account Settings。

Amplitude API Keys

在咱们的示例应用中，咱们使用 .plist 方法保存 API 的密钥，因此拿到对应的密钥并加入到 ApiKeys.plist 文件中。或者你能够打开 AmplitudeEventLogger.swift 文件，把 API 密钥直接增长到 Amplitude.instance.initializeApiKey 方法中。

CleverTap 入门

注意：这是一个有关如何注册 CleverTap 的简单介绍，并不涵盖全部的功能。
咱们发现 CleverTap 使用起来不像 Amplitude 那样直观。然而，它不须要信用卡就能够上手，这样你能够在考虑购买以前先试用一段时间。

按照标题找到 CleverTap 的注册页面，填写所需的信息。你将收到一封激活的邮件，其中会包含一个完成注册的连接。产看电子邮件并点击 Complete your signup 按钮。

点击 Add my first app 按钮你会看到下面的页面：

Add Your App

请注意， CleverTap 自动为你的应用建立了一个 TEST 环境。坦白说，我不太喜欢这个特性，由于它在猜想你的环境命名。使用 Amplitude 的时候，能够本身管理应用的开发、升级以及发布版本，而 CleverTap 则简单地假设你有一个 TEST 的应用版本。

点击 Add My App。你须要在屏幕上选择你所要进行开发的平台（Android版，iOS版，Windows等），而且提交你的应用在应用商店中的 URL。选择 iOS，而后点击 Skip URL。

这里遇到的 CleverTap 的整合命令并不像想象中的那么简单。建议跳过整合的步骤，而后按照下面的操做步骤整合：

获取 CleverTap 的 iOS SDK

CleverTap iOS SDK 的下载连接能够从 iOS SDK 的集成页面中找到。选择下载 Xcode 7 或者 Xcode 6 的版本，在你下载获得的文件夹中你将看到一个 CleverTapSDK-v2.0.10-20160405.framework.zip 文件。解压该文件，将获得一个单独的 framework 文件 CleverTapSDK.framework。拖拽 CleverTapSDK.framework 到你的工程中，确保选中了Copy items if necessary 和 Create groups 选项。固然你也会把它添加到你应用的 target 中。

添加附加的框架

添加以下所示的框架到你的 Xcode 工程中：

• SystemConfiguration

• CoreTelephony

• Security

• UIKit

• CoreLocation

添加一个桥接头文件（若是你在使用Swift的话）

和 Amplitude同样，若是你在使用 Swift 语言，你须要添加一个桥接头文件。详情请参考添加头文件的快速指南。在 bridgingHeader.h 文件中增长一行：#import <CleverTapSDK/CleverTap.h>。

API 证书

CleverTap 尽力让本身的 API 密钥足够简单。能够调用一个名为 autoIntegrate 的方法，该方法会经过 CleverTap 的后台“注册一切”。autoIntegrate 方法没有参数，它与下面的步骤紧密关联：

CleverTap Autointegrate

它明确提示要向“你的 .plist 文件”中增长两个密钥 CleverTapAccountID 和 CleverTapToken。一个针对 Info.plist 文件的假设是，若是你在管理一个测试版的应用和一个常规版本的应用，根据条件切换 .plist 文件是使人烦恼的。因此，相比于使用 autoIntegrate 方法，你应该使用 changeCredentials(withAccountID:andToken) 方法。这个方法会跳过本来的自动集成以及使用 .plist 文件管理 API 密钥的方式。所以你可使用下面的方法：

let accountID    = valueForAPIKey(named:"CleverTapDevelopmentAccountID")
let accountToken = valueForAPIKey(named:"CleverTapDevelopmentAccountToken")
CleverTap.changeCredentials(withAccountID: accountID, andToken: accountToken)

注意： valueForAPIKey 示例来自于咱们使用属性列表管理 API 密钥的方式，不过使用 valueForAPIKey 的方式你能够决定密钥的名字。

结束前的思考

软件开发者是一群有趣的生物。当可使用一门新的语言或者框架时，咱们常常重写一些东西，可是当这种改变是强制性的时候却不必定会关心这些变化。对于所开发的“系统”，指望它可扩展而且可以适应将来的需求。咱们开发的与服务端无关的事件日志系统遵循了这种方法的精神，可是即便如此仍须明白，将来的移动分析平台会提供新的特性与功能，若是要使用这些功能，你必须适配这些功能。换言之，这里使用的方法毫不是故事的结尾，每当有新的服务须要评估的时候，咱们必须时刻准备着对再也不适应需求的代码区域进行返工。即便如此，当你由于这样或那样的缘由（特别喜欢的 API 被弃用了，代码对你来讲不够 Swifty，要么就像 Parse 那样走到了生命尽头）而体会到了修改 API 的痛苦时，你可能会考虑使用一个基于协议的方法，在当前所使用的服务和其余服务之间充当一个填充的中间层。

本文由 SwiftGG 翻译组翻译，已经得到做者翻译受权，最新文章请访问 http://swift.gg。