电商API接入|四步轻松搞定电商商品详情页数据埋点

本文主要是介绍电商API接入|四步轻松搞定电商商品详情页数据埋点，希望对大家解决编程问题提供一定的参考价值，需要的开发者们随着小编来一起学习吧！

本文我们以电商产品的商品详情页为例，介绍如何做用户浏览以及点击行为的数据埋点。

案例中包含一个页面（商品详情页接口）以及该页面上的关键按钮（加购、收藏按钮），具体页面如下图所示。

（1）第一步是采集通用信息，包括设备及浏览器信息、数据采集SDK信息、网络信息、经纬度、时间信息等。只要集成了数据采集SDK，数据采集SDK就会自动收集这些通用信息。具体字段参考表2-1。

表2-1 通用信息字段

字段类型	字段中文名称	字段英文名	字段类型	说明	举例
设备及浏览器信息	操作系统名称	$os	string	终端操作系统	Windows
	操作系统版本	$os_version	string	终端操作系统的具体版本号	10
	屏幕高度	$screen_height	numBEr	屏幕的物理高度	1024
	屏幕宽度	$screen_width	numBEr	屏幕的物理宽度	768
	浏览器名称	$browser	string	访问该系统当前浏览器的名字	IE
	浏览器版本	$browser_version	string	当前浏览器版本	10.0
当前SDK信息	SDK名称	$lib	string	当前埋点采用的SDK的名称	Jsdk
当前SDK信息	SDK版本	$lib_version	string	当前SDK的版本号	1.6.0
网络信息	IP地址	ip	string	当前用户的公网IP	10.190.22.91
	国家	country	string	当前用户所在国家	中国
	省份	province	string	所在省份/州	广东
	城市	city	string	所城市	广州
经纬度	纬度	latitude	string	当前用户所在纬度
经纬度	经度	longitude	string	当前用户所在经度
时间信息	服务器时间	server_time	float	事件发送到服务端处理后的时间
时间信息	客户端时间	clienttime	float	事件发生时客户端时间
来源渠道	流量来源ID	trafficsourceid	string	识别用户是从哪里来的编码，也就是访问渠道ID	如BaiduSEM等

（2）第二步是采集应用的公共信息，主要包含平台的信息和页面信息。具体字段参考表2-2。

表2-2 应用公共信息字段

字段类型	字段中文名	字段英文名	字段类型	说明	举例
页面信息	唯一标识	$distinct_id	string	用户的唯一标识，如果有登录，则在传入登录账号；否则传入相应的设备ID	13900000000
	会员ID（登录名或者手机号）	$user_id	string	用户注册的会员ID，如果未登录则为空
	手机号码	$phone	string	用户登录的手机号码
	页面名称	page_name	string	用户当前进入的是哪一个页面	比如Home主页
	页面浏览时长	view_dur	float	用户从进入页面到离开页面的时长	毫秒
	当前页面urL	$url_path	string	当前页面的路径	如A/B/C
	前向urL	$referrer	string	跳转至当前页面的前向页面url	如A/B/C
	事件名称	event	string	只有两种时间类型：浏览及点击浏览：$pageview 点击：$pageclick
	事件类型	Event_type	string	仅针对点击事件（$pageclick）的情况才传入。需要传入按钮的名称，例如是收藏按钮，则传入collect；加入购物车,则传入addshop
	$是否首次访问	$is_first_time	bool	是否首次访问
	$是否首日访问	$is_first_day	bool	是否首日访问
平台信息	平台名称	platform	string	当前平台ID

（3）第三步是要制作埋点的页面列表，这里只列举商品详情页涉及的相关业务参数。当用户进入商品详情页，系统要记录2个关键信息：第1个信息是当前商品的ID（commodityid），有了商品ID，就可以通过数据库查询商品的所有信息；

第2个信息是用户从哪个位置进入商品详情页，可以通过坑位ID（spmid）来记录流量的来源，有了流量的来源，我们就可以更加清楚用户访问的来龙去脉。具体字段参考表2-3。

表2-3 埋点页面列表

序号	页面名称	字段英文名称	字段中文名	字段类型	字段描述
1	ProductDetail	commodityid	商品ID	string	用户浏览商品详情页传回来的相应商品id
1	ProductDetail	spmid	流量位ID	string	用来记录从哪个流量位进入商品详情页

（4）第四步是制作当前页面需要埋点的按钮列表。在本案例中，商品详情页包含两个关键按钮：第1个是收藏按钮（collect）；第2个加购按钮（addshoppingcart）。

收藏按钮需要记录用户收藏商品的ID（commodityid）、商品当时的末级分类（lastcommodity）。

加购按钮需要记录当前加购商品的ID（commodityid）、skuID（Stock keeping Unit ID，即商品的库存单位ID，比如一件衣服有白色、黑色两种颜色，那么每种颜色都有一个库存单位ID）、商品的单价（pricepercommodity）、商品的加购数量（commoditynumber）。

有了这些埋点信息，我们就可以更加清楚地知道用户加购或者收藏了哪个商品、加购的是哪个颜色的商品、加购的金额等用户行为信息。具体字段参考表2-4。

表2-4 按钮埋点列表

事件名	字段英文名	字段中文名	字段类型	说明
收藏 collect	commodityid	商品ID	string	用户点击收藏按钮传回来的商品ID
加入进货车（列表商品清单） addshoppingcart	commodityid	商品ID	string	用户点击加入进货车按钮传回来的商品ID
	skuid	skuID	string	用户点击加入进货车按钮传回来的skuID
	pricepercommodity	商品单价	number	用户点击加入进货车按钮传回来的商品单价
	commoditynumber	商品加购数量	number	用户点击加入进货车按钮传回来的商品数量