前言 通過應用程式退出事件,可以分析應用程式的平均使用時長;通過應用程式的啟動事件,可以分析日活和新增。我們可以通過全埋點方式 SDK 實現應用程式的退出和啟動事件。 一、全埋點的簡介 目前、全埋點採集可以採集一下4個事件。 1、$AppEnd 事件:應用程式退出事件 2、$AppStart ...
前言
通過應用程式退出事件,可以分析應用程式的平均使用時長;通過應用程式的啟動事件,可以分析日活和新增。我們可以通過全埋點方式 SDK 實現應用程式的退出和啟動事件。
一、全埋點的簡介
目前、全埋點採集可以採集一下4個事件。
1、$AppEnd 事件:應用程式退出事件
2、$AppStart 事件:應用程式啟動事件
3、$AppViewScreen 事件: 應用程式內界面預覽事件,對於 iOS 來說就是切換不同的 UIViewController。
4、$AppClick 事件: 控制項的點擊事件,比如點擊 UIButton 、UITableView 等。
預置事件:在 SDK 中自動採集的事件稱為預置事件。
二、應用程式退出
2.1 應用程式狀態:
一個標準的 iOS 程式在不同的時期會有不同的運行狀態,在 iOS 程式中常見的狀態有5中。如圖所示:
1、Not running:非運行狀態,指應用程式還沒有被啟動,或者已經被系統終止。
2、Inactive: 前臺非活躍狀態,指應用程式即將進入前臺狀態。
3、Active: 前臺活躍狀態,指應用程式正在前臺運行,可接受事件併進行處理。
4、Background: 進入後臺狀態,指應用程式進入後臺並可執行代碼。
5、Suspended: 掛起狀態,指應用程式進入後臺並沒有執行代碼,系統會自動將應用程式轉移到該狀態。掛起時,應用程式會保留在記憶體中,但不執行任何代碼,當系統出現記憶體不足情況時,系統會清除被掛起的應用程式。
在應用程式的狀態轉換過程中,系統會調用實現 UIApplicationDelegate 協議類的一些方法,併發送相應的本地通知(先調用方法,待回調方法執行後,再發相應的通知),回調方法和本地通知的對應關係如下表
回調方法 | 本地通知 |
---|---|
- application:didFinishI aunchingWithOptions: | UIApplicationDidFinishLaunchingNotification |
- applicationDidBecomeActive: | UIApplicationDidBecomeActiveNotification |
- applicationWillResignActive: | UIApplicationWillResignActiveNotification |
- applicationDidEnterBack ground:· | UIApplicationDidEnterBackgroundNotification |
- applicationWillEnterForeground: | UIApplicationWillEnterForegroundNotificatio |
- applicationWillTerminate: | UIApplicationWillTerminateNotification |
2.2 實現步驟
通過上面介紹的內容可知,當一個 iOS 應用程式退出時,就意味著該應用程式進入了“後臺”,即處於 Background 狀態。因此,對於實現 $AppEnd 事件的全埋點,我們只需要註冊監聽 UIApplicationDidEnterBackgroundNotification 通知,然後在收到通知時觸發 $AppEnd 事件,即可達到 $AppEnd 事件全埋點的效果。
第一步:註冊監聽 UIApplicationDidEnterBackgroundNotification 本地通知。
在 SensorsAnalyticsSDK.m 文件中實現 - setupListeners 方法,用來監聽 UIApplicationDidEnterBackgroundNotification 本地通知,然後再相應的回調方法中觸發 $AppEnd 事件。
- (void)setupListeners {
NSNotificationCenter *center = [NSNotificationCenter defaultCenter];
// 註冊監聽 UIApplicationDidEnterBackgroundNotification 本地通知
// 當應用程式進入後臺,調用通知方法
[center addObserver:self
selector:@selector(applicationDidEnterBackground:)
name:UIApplicationDidEnterBackgroundNotification
object:nil];
}
- (void)applicationDidEnterBackground:(NSNotification *)notification {
NSLog(@"Application did enter background.");
// 觸發 AppEnd 事件
[self track:@"$AppEnd" properties:nil];
}
第二步:在 SensorsAnalyticsSDK.m 文件中初始化 - init 方法中調用 - setupListeners,併在 - dealloc 方法中移除監聽。
- (instancetype)init {
self = [super init];
if (self) {
_automaticProperties = [self collectAutomaticProperties];
// 添加應用程式狀態監聽
[self setupListeners];
}
return self;
}
- (void)dealloc {
[[NSNotificationCenter defaultCenter] removeObserver:self];
}
第三步:測試驗證
我們可以在 Xcode 中列印控制臺中查看如下的列印信息。
{
"event" : "$AppEnd",
"time" : 1648520301691,
"propeerties" : {
"$model" : "x86_64",
"$manufacturer" : "Apple",
"$lib_version" : "1.0.0",
"$os" : "iOS",
"$app_version" : "1.0",
"$os_version" : "15.2",
"$lib" : "iOS"
}
}
三、應用程式啟動
應用程式的啟動,一般情況下,大致可以分為兩類場景:
• 冷啟動
• 熱啟動(從後臺恢復)
不管是冷啟動還是熱啟動,觸發 $AppStart 事件的時機,都可以理解成是當“應用程式開始進入前臺並處於活動狀態”,也即前文介紹的 Active 狀態。因此,為了實現 $AppStart 事件的全埋點,我們可以註冊監聽 UIApplicationDidBecomeActiveNotification 本地通知,然後在其相應的回調方法里觸發 $AppStart 事件。
3.1 實現步驟
第一步:在 SensorsAnalyticsSDK.m 文件 - setupListeners 方法中,添加 UIApplicationDidBecomeActiveNotification 本地通知,然後再相應的回調方法中觸發 $AppStart 事件。
- (void)setupListeners {
NSNotificationCenter *center = [NSNotificationCenter defaultCenter];
// 註冊監聽 UIApplicationDidBecomeActiveNotification 本地通知
// 當應用程式進入前臺台,調用通知方法
[center addObserver:self
selector:@selector(applicationDidBecomeActive:)
name:UIApplicationDidBecomeActiveNotification
object:nil];
}
- (void)applicationDidBecomeActive:(NSNotification *)notification {
NSLog(@"Application did enter active.");
// 觸發 AppEnd 事件
[self track:@"$AppStart" properties:nil];
}
第二步: 測試驗證
可以在 Xcode 列印控制臺中查看下麵的列印信息。
{
"event" : "$AppStart",
"time" : 1648520708355,
"propeerties" : {
"$model" : "x86_64",
"$manufacturer" : "Apple",
"$lib_version" : "1.0.0",
"$os" : "iOS",
"$app_version" : "1.0",
"$os_version" : "15.2",
"$lib" : "iOS"
}
}
3.2 優化
問題:
通過測試可以發現,仍有以下幾個特殊場景存在問題:
• 下拉通知欄並上滑,會觸發 $AppStart 事件
• 上滑控制中心並下拉,會觸發 $AppStart 事件
• 雙擊 Home 鍵進入切換應用程式頁面,最後又選擇當前應用程式,會觸發 $AppStart 事件
以上幾個場景均會觸發 $AppStart 事件,明顯與實際情況有所不符。
那這些現象是什麼原因導致的呢?
我們繼續分析可以發現以下幾個現象:
• 下拉通知欄時,系統會發送 UIApplicationWillResignActiveNotification 通知;上滑通知欄時,系統會發送 UIApplicationDidBecomeActiveNotification 通知
• 上滑控制中心時,系統會發送 UIApplicationWillResignActiveNotification 通知;下拉控制中心時,系統會發送 UIApplicationDidBecomeActiveNotification 通知
• 雙擊 Home 鍵進入切換應用程式頁面時,系統會發送 UIApplicationWillResignActiveNotification 通知,然後選擇當前應用程式,系統會再發送 UIApplicationDidBecomeActiveNotification 通知
很容易總結出規律:在以上幾個場景下,系統均是先發送UIApplicationWillResignActiveNotification 通知,然後再發送 UIApplicationDidBecomeActiveNotification 通知。而我們又是通過註冊監聽 UIApplicationDidBecomeActiveNotification 通知來實現 $AppStart 事件全埋點,因此均會觸發 $AppStart 事件。
那如何解決這個問題呢?
在解決這個問題之前,我們先看另一個現象:不管是冷啟動還是熱啟動,系統均沒有發送 UIApplicationWillResignActiveNotification 通知。
因此,只要在收到 UIApplicationDidBecomeActiveNotification 通知時,判斷之前是否收到過 UIApplicationWillResignActiveNotification 通知,若沒有收到,則觸發 $AppStart 事件;若已收到,則不觸發 $AppStart 事件。這樣即可解決上面的問題。
優化方案:
第一步:在 SensorsAnalyticsSDK.m 文件中添加 applicationWillResignActive 標記位。
/// 標記應用程式是否收到 UIApplicationWillResignActiveNotification 本地通知
@property (nonatomic, assign) BOOL applicationWillResignActive;
第二步:在 - setupListeners 方法中新增註冊監聽 UIApplicationWillResignActiveNotification 的本地通知。
- (void)setupListeners {
NSNotificationCenter *center = [NSNotificationCenter defaultCenter];
// 註冊監聽 UIApplicationDidEnterBackgroundNotification 本地通知
// 當應用程式進入後臺,調用通知方法
[center addObserver:self
selector:@selector(applicationDidEnterBackground:)
name:UIApplicationDidEnterBackgroundNotification
object:nil];
// 註冊監聽 UIApplicationDidBecomeActiveNotification 本地通知
// 當應用程式進入前臺台,調用通知方法
[center addObserver:self
selector:@selector(applicationDidBecomeActive:)
name:UIApplicationDidBecomeActiveNotification
object:nil];
// 註冊監聽 UIApplicationWillResignActiveNotification 本地通知
// 當應用程式進入前臺台,調用通知方法
[center addObserver:self
selector:@selector(applicationWillResignActive:)
name:UIApplicationWillResignActiveNotification
object:nil];
}
- (void)applicationWillResignActive:(NSNotification *)notification {
// 設置標記位
self.applicationWillResignActive = YES;
}
第三步:在UIApplicationDidBecomeActiveNotification 的回調方法中還原 applicationWillResignActive 的標記位
- (void)applicationDidBecomeActive:(NSNotification *)notification {
NSLog(@"Application did enter active.");
// 還原標記位
if (self.applicationWillResignActive) {
self.applicationWillResignActive = NO;
return;
}
// 觸發 AppStart 事件
[self track:@"$AppStart" properties:nil];
}
第四步:在 UIApplicationDidEnterBackgroundNotification 回調方法中還原 applicationWillResignActive 的標記位
- (void)applicationDidEnterBackground:(NSNotification *)notification {
NSLog(@"Application did enter background.");
// 還原標記位
self.applicationWillResignActive = NO;
// 觸發 AppEnd 事件
[self track:@"$AppEnd" properties:nil];
}
第五步:測試驗證
{
"event" : "$AppStart",
"time" : 1648533646735,
"propeerties" : {
"$model" : "x86_64",
"$manufacturer" : "Apple",
"$lib_version" : "1.0.0",
"$os" : "iOS",
"$app_version" : "1.0",
"$os_version" : "15.2",
"$lib" : "iOS"
}
}
四、應用程式被動啟動
被動啟動:我們把由 iOS 系統觸發的應用程式自動進入後臺運行的啟動稱之為(應用程式的)被動啟動,使用 $AppStartPassively 事件來表示。
4.1、Background modes
使用 Xcode 創建新的應用程式,預設情況下後臺刷新功能是關閉的,我們可以在 Capabilities 標簽中開啟 Background Modes,然後就可以勾選所需要的功能了,如下圖所示:
通過上圖可知,有如下幾種後臺運行模式,它們都會觸發被動啟動($AppStartPassively 事件)。
1、Audio,AirPlay,and Picture in Picture : 音頻的播放,錄音,AirPlay及畫中畫的視頻播放
2、Location updates:此模式下,會由於地理位置變化而觸發應用程式啟動
3、Voice over IP : IP網路電話,通過對語音信號進行編碼數字化,然後轉換成IP數據包在TCP/IP網路上進行傳輸,從而達到在網路上進行語音通信的目的
4、External Accessory communication:此模式下,一些 MFi 外設通過藍牙或者 Lightning 接頭等方式與 iOS 設備連接,從而可在外設給應用程式發送消息時,觸發對應的應用程式啟動
5、Uses Bluetooth LE accessories:此模式與 External Accessory communication 類似,只是無需限制 MFi 外設,而需要的是 Bluetooth LE 設備
6、Acts as a Bluetooth LE accessory:此模式下,iPhone 作為一個藍牙外設連接,可以觸發應用程式啟動
7、Background fetch:此模式下,iOS 系統會在一定的時間間隔內觸發應用程式啟動,去獲取應用程式數據
8、Remote notifications:此模式是支持靜默推送,當應用程式收到這種推送後,不會有任何界面提示,但會觸發應用程式啟動
9、Background processing: 後端處理
4.2 實現步驟
後臺用程式刷新拉起應用程式後,首先會回調 AppDelegate 中的 -application:didFinishLaunchingWithOptions: 方法。因此,我們可以通過註冊監聽 UIApplicationgDidFinishLaunchingNotification 本地通知來採集被動啟動事件信息。
第一步:在 - setupListeners 方法中添加 UIApplicationgDidFinishLaunchingNotification 本地通知,在回調方法中上報數據。
- (void)setupListeners {
NSNotificationCenter *center = [NSNotificationCenter defaultCenter];
// 註冊監聽 UIApplicationDidFinishLaunchingNotification 本地通知
// 當應用程式被動,調用通知方法
[center addObserver:self
selector:@selector(applicationDidFinishLaunching:)
name:UIApplicationDidFinishLaunchingNotification
object:nil];
}
- (void)applicationDidFinishLaunching:(NSNotification *)notification {
// 觸發 AppStartPassively 事件
[self track:@"$AppStartPassively" properties:nil];
}
第二步:新增一個私有屬性 launchedPassively,標記應用程式是否處於被動啟動
/// 標記應用程式是否是被動啟動
@property (nonatomic, assign, getter=isLaunchedPassively) BOOL launchedPassively;
第三步:在 - init 初始化方法中,通過 backgroundTimeRemaining 屬性是否等於 UIApplicationBackgroundFetchIntervalNever 來設置
- (instancetype)init {
self = [super init];
if (self) {
_automaticProperties = [self collectAutomaticProperties];
// 設置是否需是被動啟動標記
_launchedPassively = UIApplication.sharedApplication.backgroundTimeRemaining != UIApplicationBackgroundFetchIntervalNever;
// 添加應用程式狀態監聽
[self setupListeners];
}
return self;
}
第四步:在 - applicationDidFinishLaunching 回調方法中,如果 isLaunchedPassively 為 YES,再觸發 $AppStartPassively 事件
- (void)applicationDidFinishLaunching:(NSNotification *)notification {
NSLog(@"Application did finish launching.");
// 當應用程式後臺運行時,觸發被動啟動事件
if (self.isLaunchedPassively) {
// 觸發 AppStartPassively 事件
[self track:@"$AppStartPassively" properties:nil];
}
}
第五步:測試驗證
1、開啟 Background modes 中的 Background fetch 覆選框
2、選擇 Demo Scheme , 一次單擊 Xcode 菜單欄中的 Product -> Scheme -> Edit -> Scheme -> Run -> Options
3、勾選 Background Fetch 選項,然後點擊 Close 按鈕。運行 Demo
{
"event" : "$AppStartPassively",
"time" : 1648537321216,
"propeerties" : {
"$model" : "x86_64",
"$manufacturer" : "Apple",
"$lib_version" : "1.0.0",
"$os" : "iOS",
"$app_version" : "1.0",
"$os_version" : "15.2",
"$lib" : "iOS"
}