Show Menu
主題×

計時動作

計時動作可讓您測量停留在應用程式內的時間,以及動作從開始到結束的總時間。SDK會計算每個作業的時間量,以及完成動作所需的跨作業總時間。 您可以利用計時動作來定義區段,並用來比較購買所需時間、通過層級、結帳流程等動作。
計時動作會報告下列度量:
  • 開始和結束之間應用程式的秒數總計——跨作業
  • 開始和結束之間的秒數總計(時鐘時間)
可選回呼可讓您在計時動作完成時採取其他動作:
  • 執行程式碼並新增任何邏輯——根據持續時間結果選擇性自訂邏輯。
  • 在傳入持續時間之前,先新增上下文資料。
  • 取消點擊和尚未傳送的持續時間。

追蹤計時動作

  1. 新增資料庫至您的專案與實施生命週期。
    如需詳細資訊,請參閱 核心實作與生命週期 中的​ 新增 SDK 和設定檔至您的專案
  2. 匯入資料庫:
    #import "ADBMobile.h"
    
    
  3. 呼叫 trackTimedActionStart ,並提供計時動作名稱與選擇性內容資料。
    [ADBMobile trackTimedActionStart:@"TimeUntilPurchase"  
                                data:@{@"ExperienceName" : experience}];
    
    
  4. (選擇性) 您隨時都可以利用計時動作名稱呼叫 trackTimedActionUpdate ,以新增其他內容資料。
    [ADBMobile trackTimedActionUpdate:@"TimeUntilPurchase"  
                                 data:@{@"myapp.ImageLiked" : imageName}];
    
    
  5. 事件完成後,呼叫 trackTimedActionEnd ,然後傳遞計時動作名稱與 TimedActionBlock (回撥),即可查詢所有資料並計算持續時間。
    計時事件量度會儲存在行動解決方案變數中,以便自動報告。
    [ADBMobile trackTimedActionEnd:@"TimeUntilPurchase"  
                             logic:nil];
    
    

傳送其他資料

除了計時動作名稱之外,您還可以隨著動作開始與動作更新呼叫傳送其他內容資料:
[ADBMobile trackTimedActionUpdate:@"TimeUntilPurchase"  
                             data:@{@"myapp.ImageLiked" : imageName}];

內容資料值必須對應至自訂變數:

範例

// Timed Action Start Example 
[ADBMobile trackTimedActionStart:@"TimeUntilPurchase"  
                            data:@{@"ExperienceName" : experience}];

// Timed Action Update Example 
[ADBMobile trackTimedActionUpdate:@"TimeUntilPurchase"  
                             data:@{@"ImageLiked" : imageName}];

// Timed Action End Example 
[ADBMobile trackTimedActionEnd:@"TimeUntilPurchase"  
                         logic:nil]; 
 
// Timed Action End Example with Callback 
[ADBMobile trackTimedActionEnd:@"TimeUntilPurchase"  
                         logic:^BOOL(NSTimeInterval inAppDuration,  
                                     NSTimeInterval totalDuration,  
                                     NSMutableDictionary *data) { 
                                        [data setObject:@"PurchaseItem" forKey:@"Item453"]; 
                                        return YES; //return YES to send the hit, NO to cancel 
                                     }];