版本比较

标识

  • 该行被添加。
  • 该行被删除。
  • 格式已经改变。

...

  1. 日志字段:指每次调用SDK时都要传入的参数
  2. 日志字段中eventtype&eventargs的取值:根据当前触发的具体事件,传入相应的字段和取值传入

二、日志字段


字段

要求

描述


1

pfid

必须(1-50位,数字,大小写字母,下划线,短横线)

斐波那契分配的平台id,在作品初始化前端sdk时传入,个人版(或个人帐号业务)共用一个pfid,创建一个新企业分配一个新pfid,如果企业已存在则使用原有pfid


2

appid

必须(1-50位,数字,大小写字母,下划线,短横线)

场景载体id,根据具体产品去做定义,例如:在H5作品中指作品id,在营销插件中指活动id/uuid,在名片初始化前端sdk时传入


3

actid

不必须(0-50位,数字,大小写字母,下划线,短横线)

场景活动id,一般指智客的活动id,由前端sdk从作品url中获取


4

cnl

不必须(0-50位,数字,大小写字母,下划线,短横线)

渠道id


5

localtime

毫秒时间戳

服务器时间,由日志采集后端生成


6

ip

ip地址

客户端ip,由日志采集后端获取


7

eventtype

必须(1-50位,数字,大小写字母,下划线,短横线)

事件类型(见本文档第三部分


8

eventargs

必须(JSON字符串)

事件参数(见本文档第三部分


9

viewid

必须(1-36位,数字,大小写字母,下划线,短横线)

用户id,前端sdk调用后端接口获取。如果接口无响应,前端直接使用已存在的,不存在则随机生成


10

ext

不必须(0-36位,数字,大小写字母,下划线,短横线)

斐波那契公众号的openid,前端sdk调用后端接口获取。如果接口无响应,前端直接使用已存在的,不存在则不传


11

mpid

不必须(0-36位,数字,大小写字母,下划线,短横线)

第三方微信公众号/小程序appid,在作品初始化前端sdk时传入


12

openid

不必须(0-36位,数字,大小写字母,下划线,短横线)

第三方微信公众号获取的用户openid,在作品初始化前端sdk时传入


13

sourceid

不必须(0-36位,数字,大小写字母,下划线,短横线)

分享来源者的viewid,由前端sdk从作品url或小程序path中获取


14

stepid

不必须(0-50位,数字,大小写字母,下划线,短横线)

在智客中指活动环节,在兔展渠道分发中指分发任务id,由前端sdk从作品url中获取


15

cnltype

不必须(0-50位,数字,大小写字母,下划线,短横线)

渠道类型


16

intid

必须(1-36位,数字,大小写字母,下划线,短横线)

场景互动id,前端sdk调用后端接口获取。如果接口无响应,则随机生成


17

apptype

必须(1-50位,数字,大小写字母,下划线,短横线)

斐波那契分配的作品类型id,在作品初始化前端sdk时传入,翻页=multipage,长页=longpage,短视频=shortvideo,拼团=pintuan,抽奖=choujiang,名片=card,早报=zaobao,裂变红包=redpacket,邀请有奖=inviteaward,助力砍价=helpbargain,组队抽奖=zudui_choujiang2,外部作品=xapp,小游戏=yule,产品=productinfo,上传文件=uploadfiles,上传视频=uploadvideo,若无数据传NULL


18

unionid

不必须(0-36位,数字,大小写字母,下划线,短横线)

微信公众号获取的用户unionid,若明文授权则必须,若静默授权取不到则可不传


19

userid

不必须(1-36位,数字,大小写字母,下划线,短横线)

第三方应用用户id。若是第三方应用,则传第三方应用的userid;若是兔展自身应用则传兔展用户id。根据业务场景做具体定义。


20

audid

不必须(1-36位,数字,大小写字母,下划线,短横线)

客户档案用户id


21saudid不必须(1-36位,数字,大小写字母,下划线,短横线)分享来源者的audid
22custom不必须(JSON字符串)

额外的自定义信息,腾讯云可能存在{"projectId":"","subProjectId":"","channelId":""}

20200813 插件平台在json里新增字段 playRecordId 表示插件的参与记录


23steptype

不必须(1-50位,数字,大小写字母,下划线,短横线)

200317新增

用于区分stepid类型;

全员营销的任务定义为tasktype;

全员营销的公文包定义为briefcasetype;

微信银行的内容频道定义为wenbank;


24pluginid不必须(1-36位,数字,大小写字母,下划线,短横线)插件id
25pluginname不必须(1-36位,数字,大小写字母,下划线,短横线)插件类型



...

三、eventtype&eventargs

1、前端上报的事件字段

浏览view

字段

可能的取值

描述

userInfo

{"city":"长沙","nickname":"nico","sex":1,”openid”:”xx”,

"country":"中国","province":"湖南","headimgurl":"xx”}

Userinfo事件信息

isWeixin

true/false(boolean)

是否微信浏览器

useragent

pc /iphone/ipad/android/WP / Windows/Mac/Linux (string)

设备类型,来自User-Agent

uaVer

安卓手机为安卓系统版本,Windows环境为windows的系统版本

系统版本,来自User-Agent

lc

从0开始(int)

层级参数

shareType

微信网页打开时,取值timeline(朋友圈),groupmessage(微信群),singlemessage(好友分享),gzh(公众号)或者为空字符串 

打开来源,微信自动在url中添加的from参数

netType

例如:cmnet,3G,3gnet,WIFI,4G

网络类型,来自User-Agent

appSrc

Weixin(微信),Weibo(微博),Qzone(QQ空间),QQ,NewsArticle(今日头条),namecard(知客名片),wxeditor(编辑器小程序)

打开的APP,来自User-Agent。

appVer


APP版本,来自User-Agent

screen

例如:1080x1920

屏幕分辨率,宽x高

model

samsung, xiaomi, Huawei, vivo, Meitu, oppo, Coolpad, ASUS, ZTE, HTC, Sony, Lenovo, nubia, meizu, iphoneOther, iphone4x, iphone5x, iphone6x, iphone6xp或者安卓的其他机型信息,可能为空

机型信息,来自User-Agent

mdetail

可能与model相同

型号

build


手机的生产流水,只有手机设备访问才会具有,pc端不具备

url


当前页面url

rurl


当前页面referer


翻页switchpage

字段

可能的取值

描述

ctp

1

当前页

tgp

2

目标页

ttp

10

总页数

staytm

1000

停留时间(毫秒),若在小程序中,则取(leavepage-enterpage)的时长



点击linkclick

字段

可能的取值

描述

btname

started

按钮id/二维码id

remark

开始按钮

按钮名称/二维码名称

typelongclick/Null长按/单击




表单信息formInfo

字段

可能的取值

描述

data

{}

表单JSON对象


用户信息userinfo

字段

可能的取值

描述

city

威海

用户所在城市

nickname

阿寨

昵称

sex

1

用户的性别,值为1时是男性,值为2时是女性,值为0时是未知

openid

o7kepwcFRlJyCV4_tnGN0LRaxzLU

用户的标识,对当前公众号唯一

unionidoFGdtwOgYHCWT59SGEDlT8bIrmB4同一个微信开放平台帐号下的移动应用、网站应用和公众帐号(包括小程序),用户的 UnionID 是唯一的
country中国用户所在国家
province山东用户所在省份
headimgurl
用户头像,最后一个数值代表正方形头像大小(有0、46、64、96、132数值可选,0代表640*640正方形头像),用户没有头像时该项为空
languagezh_CN用户的语言,简体中文为zh_CN


微信网页授权拉取的用户信息对象


userinfo事件 对应的eventargs字段demo:

{"openid":"oiEBCwL93V-BRrRQKPvPCzONvFG0","headimgurl":"https://thirdwx.qlogo.cn/mmopen/vi_32/Q0j4TwGTfTKibqX2nPhYJDajHkADuLVxiaNGVEw7RDWbNILcG5Z9SMEWUXfwSNwibqltibjDvWcicXGT4ibiaelkJck6A/132","id":77949,"sex":2,"language":"zh_CN","city":"信阳","unionid":"o9wX6jlRbdgMRDPjcYCLvxyHXcmA","country":"中国","privilege":{},"nickname":"芳芳","province":"河南"}



关闭unload

字段

取值

描述

staytm

具体数值

整个作品的停留时间(毫秒),若在小程序中,取(launch-background)的时长



分享share

字段

取值

描述

staytm

1000

从上一次翻页事件到分享时的时间(毫秒)

useragent

同view

同view

shareType

timeline, friend, qq, txweibo, qzone

分享去向



2.后端上报的事件

目前支持对接的事件

公众号gzh

字段

类型

取值

描述

operation

string

subscribe/unsubscribe

关注公众号/取消关注公众号


已存在有的公众号事件,参考:

公众号事件

事件
请求内容
关注公众号


{
"operation": "subscribe",
"eventkey": "abcefe"
}

取消关注公众号
{
"operation": "unsubscribe"
}
公众号留言
{
"operation": "getMessage",
"content": "abcefe"
}
点击公众号菜单
{ "operation": "getClick", "eventkey": "abcefe", "menuid": "abcefe", "menuname":"菜单名字" }


扫描公众号二维码
{
"operation": "scan",
"eventkey": "abcefe"
}


参数
说明
operation
操作动作
eventkey
当operation值为“subscribe”时
值为参数二维码的key值,qrscene_为前缀,后面为二维码的参数值。
当operation值为“getClick”时,
值为{公众号菜单的evertkey,或小程序点击菜单的路径
当operation值为“scan”时,
值为参数二维码的key值
menuid
当operation值为“getClick”时,
值为菜单的ID
menuname
当operation值为“getClick”时,
值为菜单名
content
当operation值为“getMessage”时
值为公众号留言内容



企业微信workwechat

字段

类型

取值

描述

operation

string

addContacts

添加联系人

createTimebigint毫秒时间戳添加时间
externalUseridstring
外部联系人id


插件活动事件

抽奖Lottery

字段类型取值描述
operation文本抽奖=start,中奖=win,领奖=getAward活动状态
prizeId文本前端生成的uuid奖品id
prizeName文本在用户中奖和领奖的时候上报对应的奖品名称奖品名称
prizeLevel文本所填写的奖品等级奖品等级
prizeType文本目前有的几种类型:奖品、优惠券、可计数型奖品奖品类型


助力Help

字段类型取值描述
operation文本被邀请者完成助力事件=success活动状态
helpType文本

支持类型:share(分享)、view(浏览)、btnClick(给好友助力按钮)、

formSubmit(表单提交)、apiInvoke(外部任务事件)、addWorkWechat(添加企业微信好友)、

wechatSubscribe(微信服务号关注)

助力类型
saudid文本根据分享链接的中的saudid判断邀请者邀请者
audid文本根据分享链接的中的audid判断被邀请者被邀请者


领奖Award

字段类型取值描述
operation文本领奖=getAward活动状态
prizeId文本前端生成的uuid奖品id
prizeName文本在用户中奖和领奖的时候上报对应的奖品名称奖品名称
prizeType文本目前有的几种类型:奖品、优惠券、可计数型奖品奖品类型


签到Signin

字段类型取值描述
operation文本被邀请者完成助力事件=success活动状态
signInTime文本

签到成功日期


签到日期
audid文本
签到人


任务Task

字段类型取值描述
operation文本参与任务=start,完成任务=success活动状态
taskId
文本该任务插件ID任务ID
taskTitle文本文本用以概括该任务的内容任务标题
taskType整数型0:线上;1:线下任务场景
preFlag整数型完成上一任务才可参与标识 0:否;1:是是否前置任务
audid文本
任务参与人


组队Team

字段类型取值描述
operation文本创建队伍=start,加入队伍=join,组队完成=success活动状态
leaderId整数型

用户建队时自增ID


队伍ID
saudid文本
队长
audid文本
队员


投票Vote

字段类型取值描述
operation文本投票=vote活动状态
playerId整数型

选手ID自增

被投票选手
playerName文本
选手名称
audid文本
参与人


答题Answer

字段类型取值描述
operation文本参与答题=start,完成答题=success活动状态
playerId整数型

选手ID自增

被投票选手
data文本JSON,含答题分值,答对题目,正确错误分布题目总览
audid文本
参与人


预约Reserve

字段类型取值描述
operation文本报名预约=start,定时抽签/抽奖后=publishAward活动状态
audid文本
预约人
prizeId文本前端生成的uuid奖品id
prizeName文本在用户中奖和领奖的时候上报对应的奖品名称奖品名称
prizeType文本目前有的几种类型:奖品、优惠券、可计数型奖品奖品类型