编辑: 向日葵8AS | 2019-07-06 |
SDK接口方法和参数说明及注意事项(必读)
1 2.统计用户首次打开应用方法:/receive/tkio/install
2 3.统计用户打开应用方法:/receive/tkio/startup
2 4.统计用户注册方法:/receive/tkio/register
3 5.统计用户登陆方法:/receive/tkio/loggedin
4 6.统计用户充值方法:/receive/tkio/payment
5 7.统计用户自定义事件方法:/receive/tkio/event
6 8.统计用户属性方法:
7 9.服务器错误返回值
8 1.SDK接口方法和参数说明及注意事项(必读) 数据报送地址:http:// log.reyun.com 申请appkey,打开http://www.trackingio.com, 使用您的热云账号登陆后点击右上角的"设置管理",点击的"产品中心",然后点击左上方的"新建产品",在弹出的面板中创建新应用,完成后您将获得一个32位的16进制APPKEY,用来唯一标识您刚刚创建的应用. (注:为了保证您的数据安全,请勿泄露您的APPKEY给其他人.) 所有请求格式统一用UTF-8编码,请求方式用post,文档中所有参数列表中的参数都是需要报送的,只是必填的参数是必须要填写并有数值的,否则数据是无法报送成 deviceid是很重要的参数,是用来记录用户设备的身份信息(ios获取的是MAC或idfa,android获取IMEI或者mac地址,但要保证一致),如果有个别用户出现获取不到deviceid的情况,deviceid要传unknown. 文档中的"是否必填"项是决定数据是否报送成功的选项,必填参数没有填写会导致数据报送不出来,不是必填参数就不是重要参数,(如果必填参数获取不到,请用unknown代替)例如以下参数: Channelid写死为_default_ 报送的头信息中一定要有Content-Type=application/json参数 2.统计用户首次打开应用方法:/receive/tkio/install 方法说明: 在用户第一次打开应用时调用,记录用户设备激活数据,只报送一次. 参数列表: 参数名 是否必填 参数类型 参数长度 说明 appid 是 字符串 最长64 应用appkey context 是HashMap 最长32 上下文信息 上下文信息: 参数名 是否必填 参数类型 参数长度 说明 _deviceid 是 字符串
128 ios存idfa android存imei _channelid 是 字符串 最长16 默认:_default_ 渠道ID _idfa ios必填,android 不填 字符串 广告标示符 _idfv ios必填,android 不填 字符串 Vindor标示符 _imei android必填,ios 不填 字符串 手机的唯一识别号码 _androidid android必填,ios 不填 字符串 _ip 是 字符串 客户端IP HTTP POST 提交json数据: {"appid":"appkey","context":{"_deviceid":"xxx","_ip":"192.168.1.1"}} 服务返回json数据: {"status":0} 3.统计用户打开应用方法:/receive/tkio/startup 方法说明: 在用户每次打开应用时报送,记录用户启动应用数据. 参数列表: 参数名 是否必填 参数类型 参数长度 说明 appid 是 字符串 最长64 应用appkey context 是HashMap 最长32 上下文信息 上下文信息: 参数名 是否必填 参数类型 参数长度 说明 _deviceid 是 字符串
128 ios存idfa android存imei _channelid 否 字符串 最长16 默认:_default_ 渠道ID _idfa ios必填 字符串 广告标识 _idfv ios必填 字符串 Vindor标示符 _imei Android必填 字符串 手机的唯一识别号码 _tz 否 字符串 最长16默认:+8 时区 _devicetype 否 字符串
64 设备类型 _op 否 字符串
32 运营商 _network 否 字符串
16 网络制式2G,3G,WIFI. _os 否 字符串
32 操作系统 _resolution 否 字符串
16 分辨率 HTTP POST 提交json数据: {"appid":"appkey","context":{"_deviceid":"xxx"}} 服务返回json数据: {"status":0} 注:devicetype是传的用户的机型信息,例如:iphone4s,iphone5s,sansung-GT9300 os是获取用户设备的系统信息,例如:android4.0 ios7.0 op是获取用户所使用的网络运营商,例如:中国移动,中国联通,中国电信 4.统计用户注册方法:/receive/tkio/register 方法说明: 用户首次进入服务器时调用. 参数列表: 参数名 是否必填 参数类型 参数长度 说明 appid 是 字符串 最长64 应用appkey who 是 字符串 最长64 账户ID context 是HashMap 最长32 上下文信息 上下文信息: 参数名 是否必填 参数类型 参数长度 说明 _deviceid 是 字符串