功能说明和使用方法

功能说明

通过接口推送访客的事件行为数据,根据用户的行为按照日志时间升序,逐条发送

接口调用说明

URL

系统提供(需要在后台开通此权限)

格式

json

HTTP请求方式

GET

输入参数说明

参数名称 是否必须 类型 描述
website 必须 string 站点编号
siteport 必须 string SDK类型,支持js、app、waxpp、iot四个类型,分别是js端、app端、小程序端、物联网端,默认js
clienttype 必须 string 终端类型:
js端下填写web或wap;
app端下填写android或者ios;
小程序端下填写android或者ios;
物联网端下填写iot,目前支持iot类型; ,默认web
datetimes 必须 string 时间,格式如下2019-01-22 20:17:18
cookie 必须 string 易分析识别访客标记,字符,不限制类型,但必须唯一,一般是访客的设备号,如果没有就用访客的id等
userid 必须 string 注册用户id
username 必须 string 注册用户名
appversion 必须 string app应用版本
datajson 必须 string 事件属性,json编码的字符串;GET请求最大长度依赖于web服务器设置,一般不要超过4kb,可以多次发送
appstart 必填 string app日志类型,1是启动日志;2是行为日志;如果app不区分启动和行为日志,填写0;针对网页日志填写0;
phonenet 选填 string 手机上网类型,如WiFi,4G等
phoneoperator 选填 string 手机运营商,如中国电信等
screensize 选填 string 手机分辨率,如1080*2160
phonetype 选填 string 手机型号
phonebrand 选填 string 手机品牌
osversion 必填 string 手机系统版本
channel 选填 string 访客来源渠道
revisit 选填 string 访客回访次数,默认0
appmac 选填 string 客户端mac地址
vip 选填 string 访客真实ip
token 必须 string

token验证,md5(website+日期+pushdata);

其中pushdata是固定字符,日期如20190101,php如date("Ymd")

返回参数说明

["ok"] //写入成功

["error_token"] //token错误

["error_no_open_push"] //此站点未开启推送日志

["error_website_code"] //错误/不存在的站点编号

php代码示例

	$action_array = array();
	//添加事件(【eventdata】是类型,不可更改;【注册】是是事件分类;【点击按钮】是事件名称)
	$action_array['eventdata']['注册']['点击按钮'] = '点击按钮';

	//含事件的属性(【登录】是事件分类;【完成登陆】是事件名称;userid是用户属性;120001是属性值)
	$action_array['eventdata']['登录']['完成登陆']['userid']	= '120001';

	//添加页面(pagedata是类型,不可更改;【pageurl_1】是页面路径,如果没有的话,就直接用【页面名称1】代替)
	$action_array['pagedata']['pageurl_1'] = '页面名称1';

	//添加用户属性(【userdata】是类型,不可更改;userid是设置用户id;120001是用户属性值)
	$action_array['userdata']['userid'] = '120001';

完整示例

server_push_data.php?website=10000000&clienttype=android&appversion=1.0&vip=111.111.111.111&cookie=201905210000000000000212325&userid=userid_212325&username=username_212325&appmac=00:00:00:00:00&revisit=0&channel=推送渠道&osversion=9&phonebrand=HUAWEI&phonetype=BLA-AL00&screensize=1080*2160&phoneoperator=中国电信&phonenet=WIFI&appstart=1&token=aa9b591247b2a8129f0b82e91ca10dab&datajson={"eventdata":{"\u6ce8\u518c":{"\u70b9\u51fb\u6309\u94ae\u4e8b\u4ef6":"\u70b9\u51fb\u6309\u94ae"},"\u767b\u5f55":{"\u7528\u6237\u5c5e\u6027\u4e8b\u4ef6":{"userid":"120001"}}},"pagedata":{"pushdata_activity_1":"pushdata_page_url_1"},"userdata":{"userid":"set_userid_100001"}}

实际使用中汉字要进行编码。


最后更新:2018-09-13