Last modified 5 years ago
魔方拓展接口格式定义
接口地址:
http://event.imofan.com/{app_key}
备注:(旧域名imofan_mgz.pconline.com.cn将弃用)
接口参数以POST方式提交,其参数定义如下:
{
"os_ver": "7.0.4",
"app_ver": "1.3.0",
"open_udid": "98aab4d28f8394015e139c565057cb02ec9ce849", //ios设备标识
"model": "iPod4,1",
"dev_id": "88c66328573a",
"mac_addr": "88c66328573a",
//IOS中的广告位标识符
"idfa": "C084C314-88B0-41BA-BEC9-117091E3163F",
"apns": "D0EA95AB09AFD98E7B28BB5FB8497DC3FEF685CB656F0D02EE977F3B842F63AC",
"action": [
[
"活动参与", //事件操作名称
"201402马上成家产品", //事件标签
20140211, //事件发生时间(年月日)
95247, //事件发生时间(时分秒)
24 //持续时间,即某个action执行用了多长时间,单位:秒,选填
]
],
"event": [
{ "date":20160226, //必须,事件发生日期(年月日)
"time":12412454325, //必须,事件发生时间戳
"cid": 112, //必须,事件id,在魔方系统里面定义,兼用原来的魔方计数
"refer":111, //必须,记录来源页面事件id(上一个event_type=page页面事件),event_type=event事件不返回,如果cid=0则表示进入refer后退出应用,情景例子见底部注意第2点
"refer_time":12412454324, //必须,触发来源页面事件的时间戳,event_type=event事件不返回,情景例子见底部注意第2点
"url":"http://...", //必须,数据来源路径,有则必返回,例如http://m.pcauto.com.cn/hj/article/603602.html
"uuid":["4874","2387"], //必须,可多个,兴趣标签(汽车返回车系id,消费板块返回产品id),事件发生对应页面有uuid必返回
"ad":122, //可选,广告标志
"from":"xxx", //可选,搜索引擎来源标记
"xxx":"xxx", //其他的业务需要属性可以进行扩展
"event_type":"page" //必须,事件类型,page:页面计数事件,event:按钮事件,other:其他事件
},
{ "date":20160226, //必须,事件发生日期(年月日)
"time":12412454325, //必须,事件发生时间戳
"cid": 113, //必须,事件id,在魔方系统里面定义,兼用原来的魔方计数
"refer":111, //必须,记录来源页面事件id(上一个event_type=page页面事件),event_type=event事件不返回,如果cid=0则表示进入refer后退出应用,情景例子见底部注意第2点
"refer_time":12412454324, //必须,触发来源页面事件的时间戳,event_type=event事件不返回,情景例子见底部注意第2点
"url":"http://...", //必须,数据来源路径,有则必返回,例如http://m.pcauto.com.cn/hj/article/603602.html
"uuid":["4874","2387"], //必须,可多个,兴趣标签(汽车返回车系id,消费板块返回产品id),事件发生对应页面有uuid必返回
"ad":122, //可选,广告标志
"from":"xxx", //可选,搜索引擎来源标记
"xxx":"xxx", //其他的业务需要属性可以进行扩展
"event_type":"event" //必须,事件类型,page:页面计数事件,event:按钮事件,other:其他事件
},
......
]
}
响应文字:
HTTPSQS_PUT_OK HTTPSQS_PUT_ERROR
数据发送策略
1、IOS:
Android:检测时间距离上次发送时间超过半个小时时发送数据
2、app启动或关闭时发送数据
3、使用压缩方式传输,再header增加这个值"Content-Encoding", "gzip"
注:1、发送数据时,当event数组中数量过多,需要分多次发回(每次发回event中数据量不超过200),以避免一次性发送数据过大。
2、如用户进入页面A页面的时间为time1,从A页面访问了B页面,进入B页面的时间为time2,在触发进入B页面的事件时,则cid为B页面的cid,refer为A页面的cid,refer_time取time1的值,event_type取值为“page”,代表事件类型为页面类型。
![(please configure the [header_logo] section in trac.ini)](http://www1.pconline.com.cn/hr/2009/global/images/logo.gif)