iOS全埋點解決方案-應用退出和啟動

任淏發表於2022-03-29

前言

​ 通過應用程式退出事件,可以分析應用程式的平均使用時長;通過應用程式的啟動事件,可以分析日活和新增。我們可以通過全埋點方式 SDK 實現應用程式的退出和啟動事件。

一、全埋點的簡介

​ 目前、全埋點採集可以採集一下4個事件。

1、$AppEnd 事件:應用程式退出事件

image-20220328114940691

2、$AppStart 事件:應用程式啟動事件

image-20220328115007985

3、$AppViewScreen 事件: 應用程式內介面預覽事件,對於 iOS 來說就是切換不同的 UIViewController。

4、$AppClick 事件: 控制元件的點選事件,比如點選 UIButton 、UITableView 等。

預置事件:在 SDK 中自動採集的事件稱為預置事件。

二、應用程式退出

2.1 應用程式狀態:

​ 一個標準的 iOS 程式在不同的時期會有不同的執行狀態,在 iOS 程式中常見的狀態有5中。如圖所示:

image-20220328115753785

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,然後就可以勾選所需要的功能了,如下圖所示:

image-20220329140937136

通過上圖可知,有如下幾種後臺執行模式,它們都會觸發被動啟動($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"
  }

相關文章