集成說明
可視化埋點SDK僅支持版本IOS 9.0以上
config版本建議使用 IOS 10.0以上
SDK依賴
可視化埋點SDK必須與私有化統計SDK UMCommon.framework 1.2.0.P版本以上、私有化SPM插件 UMSPM 1.2.0版本以上 SDK配合使用。
請先參考私有化統計SDK 和私有化SPM插件將對應SDK集成到您的應用中。
Release 與 Config 版本差異
Release 版本只包括采集可視化埋點能力,不包括埋點設置與展現能力;
Config 版本包括可視化的展示與設置能力。
Release 版本集成
將UMVisual.framework集成到工程中XcodeFile —> Add Files to "Your Project",在彈出Panel選中所下載組件包->Add。(注:選中“Copy items if needed”)
需引入頭文件
#import <UMVisual/UMVisual.h>
是否使用可視化功能
/** 設置是否不使用可視化功能,默認使用,如不使用可在初始化前設置為NO,請在初始化之前使用
@param bFlag 默認YES(不輸出log); 設置為NO, 則不使用可視化功能
*/
+ (void)setVisualEnabled:(BOOL)bFlag;
獲取可視化SDK版本號
#pragma mark - sdk版本
+ (NSString *)libVersion;
設置最小掃描時間
//設置最小掃描時間,單位:毫秒,范圍是200-1000之間,超出或不滿默認是200ms
+ (void)setScanInterval:(int)interval;
config 版本集成
需先集成release 版本,然后將UMVisualConfig.framework和資源文件UMVisual.bundle集成到工程中XcodeFile —> Add Files to "Your Project",在彈出Panel選中所下載組件包->Add。(注:選中“Copy items if needed”)
Targets->BuildSettings 中 , Other Linker Flags增加-ObjC,一定要添加此項,注意是大寫C,不是小寫c。
注意事項
在上線后需要去掉config 版本的SDK
支持控件
控件名稱 | 說明 |
UIButton | -- |
Tableviewcell | -- |
CollectionViewCell | -- |
UISegmentedControl | -- |
UITextField | -- |
UISwitch | -- |
UIStepper | -- |
AVPlayer | -- |
UITextView | -- |
UIAlertController | -- |
UIImageView | 可點擊時可以識別 |
常見問題
1.如何埋點才能讓當前頁面支持可視化埋點功能?
只有在預先完成了手動PV埋點和SPM編碼埋點,才能支持本頁面的可視化埋點功能。
手動PV埋點和SPM編碼埋點示例代碼:
- (void)viewWillAppear:(BOOL)animated
{
[super viewDidAppear:animated];
[MobClick beginLogPageView:@"PageHome"];// 頁面手動PV埋點
[UMSpm updateCurSPM:@"PageHome"];// SPM編碼設置
}
- (void)viewDidDisappear:(BOOL)animated
{
[super viewDidDisappear:animated];
[MobClick endLogPageView:@"PageHome"];// 頁面手動PV埋點
}
沒有完成頁面手動PV埋點的頁面,如果試圖做可視化埋點,前端埋點頁面會提示頁面不匹配。
2.如何在正式發版前去除配置版SDK?
將工程中的UMVisualConfig.framework和UMVisual.bundle刪除