wiki:apns

Version 41 (modified by chenyuanzhu, 8 years ago) (diff)

--

魔方拓展接口格式定义

接口地址:

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": [
        {  "cid": 112,                      //必须,事件id,在魔方系统里面定义,兼用原来的魔方计数
           "refer":111,                   //选填,记录来源页面事件id,如果cid=0,则表示进入refer后退出应用
           "date":20160226,         //必须,事件发生日期(年月日)
            "time":12412454325      //必须,时间戳         
            "refer_time":12412454324,    //选填,触发来源页面的时间戳(有则必填)
            "url":"http://...",          //可选,数据来源路径
            "ad":122,                   //可选,广告标志
            "uuid":["4874","2387"]         //可选,兴趣标签
            "from":"xxx".                   //可选,搜索引擎来源标记
            "xxx":"xxx"                  //其他的业务需要属性可以进行扩展
            "event_type":"page",        //事件类型,page:页面计数事件,event:按钮事件,other:其他事件
        },
       {  "cid": 113,                      //必须,事件id,在魔方系统里面定义,兼用原来的魔方计数
           "refer":111,                   //选填,记录来源页面事件id,如果cid=0,则表示进入refer后退出应用
           "date":20160226,         //必须,事件发生日期(年月日)
            "refer_time":12412454324,    //选填,触发来源页面的时间戳(有则必填)
            "time": 12412454345   //必须,时间戳         
            "url":"http://...",          //可选,数据来源路径
            "ad":122,                   //可选,广告标志
            "uuid":["4874","2387"]         //可选,兴趣标签
            "from":"xxx".                   //可选,搜索引擎来源标记
            "xxx":"xxx"                  //其他的业务需要属性可以进行扩展
            "event_type":"page",        //事件类型,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”,代表事件类型为页面类型。