神策数据埋点

一时失言乱红尘 2021-07-24 22:42 578阅读 0赞

一.

1.引入 SDK

(1).下载神策官方的dome:[https://github.com/sensorsdata/sa-sdk-miniprogram/releases][https_github.com_sensorsdata_sa-sdk-miniprogram_releases]

(2).把神策官方dome中的sensorsdata.min.js复制到自己项目中，我这里放到里utils文件夹中

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQxMjQxNTA0_size_16_color_FFFFFF_t_70][]                     ![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQxMjQxNTA0_size_16_color_FFFFFF_t_70 1][]

(3).在 **app.js** 文件中通过 ***require()*** 引入 SDK

var sensors = require('./utils/sensorsdata.min.js');

2.配置初始化参数

(1).引入 SDK 后，可通过 ***setPara()*** 进行 SDK 初始化参数配置

sensors.setPara({
    	name: 'sensors',
    	server_url: '您的数据接收地址',
    	// 全埋点控制开关
    	autoTrack: {},
    	// 自定义渠道追踪参数，如source_channel: ["custom_param"]
    	source_channel: [],
    	// 是否允许控制台打印查看埋点数据(建议开启查看)
    	show_log: true,
    	// 是否允许修改 onShareAppMessage 里 return 的 path，用来增加(登录 ID，分享层级，当前的 path)，在 app onShow 中自动获取这些参数来查看具体分享来源、层级等
    	allow_amend_share_path: true
    });

*  server\_url获取方式

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQxMjQxNTA0_size_16_color_FFFFFF_t_70 2][]   ![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQxMjQxNTA0_size_16_color_FFFFFF_t_70 3][]

*  autoTrack

autoTrack:{ 
    		appLaunch: true, // 默认为 true，false 则关闭 $MPLaunch 事件采集
    		appShow: true, // 默认为 true，false 则关闭 $MPShow 事件采集
    		appHide: true, // 默认为 true，false 则关闭 $MPHide 事件采集
    		pageShow: true, // 默认为 true，false 则关闭 $MPViewScreen 事件采集
    		pageShare: true, // 默认为 true，false 则关闭 $MPShare 事件采集
    		mpClick: false, // 默认为 false，true 则开启 $MPClick 事件采集 
    		mpFavorite: true // 默认为 true，false 则关闭 $MPAddFavorites 事件采集
    	}

3. 初始化 SDK

注意：在调用 ***init()** *接口之前，采集的数据被缓存在内存中；调用 ***init()*** 接口后，会将缓存的数据通过网络发送出去。

*  这里的request是登录或者注册的请求，等后端成功返回数据后修改将nimingid distinct\_id修改为OpenID
 *  调用 ***init()** *方法来初始化 SDK, ***init()***最好不要到success里调用，到complete里调用

wx.request({
    	url: '后端获取 OpenID 的请求',
    	success: function(res){
    		if(res.OpenID){
    			sensors.setOpenid(res.OpenID);	
    		}
    		
    	},
    	complete: function(){
    		sensors.init();
    	}
    });

例：

sensors.setOpenid('11111111')   //修改distinct_id

![20210419110234265.png][]

4.设置事件公共属性

sensors.registerApp({
       platform:'小程序'
      });

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQxMjQxNTA0_size_16_color_FFFFFF_t_70 4][]

5.用户登录

sensors.login("登录 ID");

例：

sensors.login("1234");

![20210419110751858.png][]

6.点击事件

sensors.track('click',{
        name: '点击'
      });

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQxMjQxNTA0_size_16_color_FFFFFF_t_70 5][]

7.设置用户属性

(1) .***setProfile( properties ): ***可以设定用户属性，同一个 key 多次设置时，value 值会进行覆盖替换：

// 设置用户属性 email为 xxx@xx
    sensors.setProfile({
    	email:'xxx@xx',
    });
    
    // 再次设置用户属性 email为 aaa@xx会将值替换为 aaa@xx
    sensors.setProfile({
        email:'aaa@xx',
    });

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQxMjQxNTA0_size_16_color_FFFFFF_t_70 6][]     ![20210420141149650.png][]

(2).***setOnceProfile ():***保留初次属性

对于需要保证只有首次设置时有效的属性，如用户首次充值金额、首次设置的昵称等，可以使用 ***setOnceProfile ***接口进行记录。与 ***setProfile ***方法不同的是，如果被设置的用户属性已存在，则这条记录会被忽略而不会覆盖已有数据，如果属性不存在则会自动创建。

// 设置用户属性 email为 xxx@xx
    sensors.setOnceProfile({
    	email:'xxx@xx',
    });
    
    // 再次设置用户属性 email为 aaa@xx不生效，属性值仍然是 xxx@xx
    sensors.setOnceProfile({
        email:'aaa@xx',
    });

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQxMjQxNTA0_size_16_color_FFFFFF_t_70 7][]        ![20210420142020493.png][]

(3).***incrementProfile():***数值属性累加

针对一些数值型属性，如消费总额、用户积分等属性，我们可以使用 ***incrementProfile ***对原值进行累加，神策会自动计算并保存累加之后的值。

// 设置用户订阅次数属性
    sensors.incrementProfile({
    	subscribers: 5
    });
    // 对用户订阅次数进行累加，此时在神策系统中查询 subscribers 属性值为 10
    sensors.incrementProfile({
    	subscribers: 5
    });

![20210420142303808.png][]

(4).***appendProfile():***列表属性追加

对于列表类型用户属性，如用户喜爱的水果、用户爱看的电影等属性，可以调用 ***appendProfile ***接口进行追加一些新值。

// 设置用户喜爱的水果属性
    sensors.appendProfile({ 
    	favoriteFruits: ['葡萄', '香蕉'] 
    });
    // 对用户喜爱的水果属性追加新值
    sensors.appendProfile({ 
    	favoriteFruits: ['苹果', '桃子'] 
    });

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQxMjQxNTA0_size_16_color_FFFFFF_t_70 8][]

个人笔记具体请参考官方文档：[https://manual.sensorsdata.cn/sa/latest/page-22255678.html][https_manual.sensorsdata.cn_sa_latest_page-22255678.html]

[https_github.com_sensorsdata_sa-sdk-miniprogram_releases]: https://github.com/sensorsdata/sa-sdk-miniprogram/releases
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQxMjQxNTA0_size_16_color_FFFFFF_t_70]: https://img-blog.csdnimg.cn/20210416141735523.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQxMjQxNTA0,size_16,color_FFFFFF,t_70
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQxMjQxNTA0_size_16_color_FFFFFF_t_70 1]: /images/20210724/4160340f14ee4530bf43f8836b73c921.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQxMjQxNTA0_size_16_color_FFFFFF_t_70 2]: https://img-blog.csdnimg.cn/20210416153132492.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQxMjQxNTA0,size_16,color_FFFFFF,t_70
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQxMjQxNTA0_size_16_color_FFFFFF_t_70 3]: /images/20210724/24d3ff5b64f945cbacbe53aa8f2c52f6.png
[20210419110234265.png]: /images/20210724/2ec44e84d47244b4ab14c64f622c0d44.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQxMjQxNTA0_size_16_color_FFFFFF_t_70 4]: /images/20210724/7c0de168fcab4b1bb62e774dffe2459f.png
[20210419110751858.png]: /images/20210724/f79f23187ed34d70a1e297da32699c23.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQxMjQxNTA0_size_16_color_FFFFFF_t_70 5]: /images/20210724/be3f3208760c40cc95a5a30800fc2df3.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQxMjQxNTA0_size_16_color_FFFFFF_t_70 6]: https://img-blog.csdnimg.cn/20210420142108920.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQxMjQxNTA0,size_16,color_FFFFFF,t_70
[20210420141149650.png]: /images/20210724/e03fe46b5efa4d4089a95d63d40fc330.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQxMjQxNTA0_size_16_color_FFFFFF_t_70 7]: https://img-blog.csdnimg.cn/20210420142036261.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQxMjQxNTA0,size_16,color_FFFFFF,t_70
[20210420142020493.png]: /images/20210724/58a8be2d43ae446cb2717a0c6c385b82.png
[20210420142303808.png]: /images/20210724/539092a1ea1c49fdba72f5b479a89f32.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQxMjQxNTA0_size_16_color_FFFFFF_t_70 8]: /images/20210724/d5ebb2a2a1e0473fbda34a37ef706126.png
[https_manual.sensorsdata.cn_sa_latest_page-22255678.html]: https://manual.sensorsdata.cn/sa/latest/page-22255678.html