iOS可视化埋点集成文档

集成说明

可视化埋点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删除