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 
                                     }