邀请有礼注册事件及转化事件上报指南 · 方舟智能运营

邀请有礼依赖的是用户系统产生的注册数据或者后续的购买转化数据，如果需要在EA中分析，用户需要根据EA定义的规则的进行系统对接和数据上报。 ## 1、页面配置注册事件：对应接口中的xwhat，uba上报的xwhat 跟踪参数：邀请码在上报数据中定义的key 转化事件：对应uba上报的xwhat ## 2、访问小程序访问小程序，当小程序跳转到第三方系统的落地页时，会在落地页面地址上带上活动ID、邀请码、当前用户openid三个属性。 eg：填写的落地页地址为：https://[ea服务器地址]:48088/eatestup/index.html 从小程序跳转过去的地址为：https://[ea服务器地址]48088/eatestup/index.html?activityId=1&code=123\_ABCD ### 3、数据上报【用户系统需要做的】 ## 方式一：调用EA接口通知注册完成 * 注册事件：当用户在落地页完成注册后，用户系统调用EA提供的接口，通知注册完成. 接口地址：【POST】https://[ea服务器地址]:48088/push/api/ug/register 输入参数： ~~~ { //用户ID，如果有后续转化，会根据用户ID和转化事件进行匹配 "xwho":"yuan", //对应页面配置的注册事件ID "xwhat":"register_success", //事件发生时间，如果事件发生时间不在活动范围内，则无效，需要在事件发生的2h内调用接口 "xwhen":1633758815000, "xcontext":{ //活动ID key固定为$ug_activity_id，value为落地页地址上的activityId对应的值 "$ug_activity_id":1, //邀请码 key动态，对应页面配置的跟踪参数，value为落地页地址上的code的值 "$share_info":"123_ABCD", //其他页面上配置的过滤条件 ... } } ~~~ * 转化事件：如果用户定义的购买完成，则算用户转化。那就在用户完成购买后，用户系统调用EA提供的接口，通知用后购买转化完成。接口地址：【POST】https://[ea服务器地址]:48088/push/api/ug/convert 输入参数： ~~~ { //用户ID，转化的xwho需要和注册的xwho匹配才能完成转化 "xwho":"yuan", //对应页面配置的转化事件ID "xwhat":"buy_success", //事件发生时间，如果事件发生时间不在活动范围内，则无效，需要在事件发生的2h内调用接口 "xwhen":1633758816000, "xcontext":{ //页面配置的过滤条件 ... } } ~~~ ## 方式二：统计UBA埋点用户行为数据往UBA中上报，UBA的数据结构不变。 * 注册事件：需要在xcontext中包含活动、邀请人、参与人信息 ~~~ { "appid":"fissiontest", "xwho":"yuan", //和页面配置选择的注册事件一致 "xwhat":"register_success", "xwhen":1633758815000, "xcontext":{ "$lib": "WeChat", "$lib_version": "4.3.11.1", "$platform": "WeChat", "$debug": 2, "$is_login": true, "$brand": "iPhone", "$model": "iPhone 12<iPhone13,2>", "$os": "iOS", "$os_version": "14.7.1", "$browser_version": "8.0.14", "$network": "其它", "$screen_width": 390, "$screen_height": 844, "$is_first_day": false, "$time_zone": "GMT+08:00", "$language": "zh_CN", "$session_id": "696984a04c195809", "$is_time_calibrated": false, "$ip": "218.76.1.148" //以下两个属性为EA分析需要使用的属性，上报到uba时必须携带 //活动ID key固定为$ug_activity_id，value为落地页地址上的activityId对应的值 "$ug_activity_id":1, //邀请码 key动态，对应页面配置的跟踪参数，value为落地页地址上的code的值 "$share_info":"123_ABCD" } } ~~~ * 购买转化事件只要保证xwho和注册事件的xwho一致即可 ~~~ { "appid":"fissiontest", "xwho":"yuan", //和页面配置选择的转化事件一致 "xwhat":"buy_success", "xwhen":1633758815000, "xcontext": { "$lib": "WeChat", "$lib_version": "4.3.11.1", "$platform": "WeChat", "$debug": 2, "$is_login": true, "$brand": "iPhone", "$model": "iPhone 12<iPhone13,2>", "$os": "iOS", "$os_version": "14.7.1", "$browser_version": "8.0.14", "$network": "其它", "$screen_width": 390, "$screen_height": 844, "$is_first_day": false, "$time_zone": "GMT+08:00", "$language": "zh_CN", "$session_id": "696984a04c195809", "$is_time_calibrated": false, "$ip": "218.76.1.148" } } ~~~