理解友盟统计中的事件统计和友盟推送

2019-09-28 本文已影响0人马六甲的笔记

友盟统计中大部分数据都为自动上报的，比如用户、日活、设备信息等，都是集成 sdk 后就无需做任何处理了；想要更精准的验证产品体验，就要自己埋点进行了统计了，对应的就是友盟统计中的事件统计功能。

友盟的事件统计说明提到了，统计自定义事件的三个 api：onEvent、onEventValue、onEventObject；在最新的文档版本中提到：

统计SDK 8.0.0及以上使用onEventObject接口进行事件的统计，参数值可以是如下几种类型之一：String、Long、Integer、Float、Double、Short。

多参数类型事件能满足原来计算事件/计数事件的分析场景，若您仍然想使用之前的类型，该版本同样支持

看来新版是弱化了 onEvent 和 onEventValue 接口，先来看看前端的相关操作

一、基本统计

统计自定义事件触发次数等基础数据

【应用设置 - 事件】 - 添加预置事件，只有添加了，才能使用 api 触发；且添加后不可删除，只能停用
【基础看板 - 自定义事件】 - 查看触发次数/触发用户数/触发时长

二、转化率统计

统计一系列事件链条触发次数

【应用设置 - 事件转化率】 - 设置事件链条（如：打开注册 - 验证手机 - 完成注册）
【基础看板 - 事件转化率】 - 查看符合已配置条件的数据统计

三、高级筛选

在【用户洞察】面板下的事件分析、漏斗分析、自定义留存、用户分群这几个功能下，都提供了事件筛选配置。

由于这个演示中的事件自定义参数并没有配置太多，用预置参数来看一下

自定义参数为数字类型

自定义参数为字符串类型

综合以上的使用操作，反推一下 api 应该怎么使用，综合新旧文档，先列一下支持的 api

// 最基础用法，打点 eventId
MobclickAgent.onEvent(mContext, "eventId");

// 打点 eventId 的同时, 设置一个 lib
MobclickAgent.onEvent(mContext, "eventId", "lib");

// 打点 eventId ，并上传本次打点的数据包
HashMap<String,String> map = new HashMap<String,String>();
map.put("type","book");
map.put("quantity","3"); 
MobclickAgent.onEvent(mContext, "purchase", map);

// 打点并上传数据包, 与 onEvent 类似, 但 Map kv 中的 value 可以为数字类型
Map<String, Object> music = new HashMap<String, Object>();
music.put("music_type", "popular");//自定义属性：音乐类型，值：流行
music.put("singer", "JJ"); //歌手：(林俊杰)JJ
music.put("song_name","A_Thousand_Years_Later"); //歌名：一千年以后
MobclickAgent.onEventObject(this, "play_music", music);

// 打点, 上传数据包, 并传递一个事件持续时长的参数
int duration = 12000; //开发者需要自己计算音乐播放时长
Map<String, String> map_value = new HashMap<String, String>();
map_value.put("type" , "popular" );
map_value.put("artist" , "JJLin" );   
MobclickAgent.onEventValue(this, "music" , map_value, duration);

参数最多的是 MobclickAgent.onEventValue，实测了一下，最终得到结论

onEvent(mContext, "id") ≈ onEventValue(this, "id" , null, 0)

onEvent(mContext, "id", "lib") ≈ onEventValue(this, "id" , {id:"lib"}, 0)

onEventObject(this, "id", map) ≈ onEventValue(this, "id" , map, 0)

理解为 Http 请求，其第一个参数为 id，第二个参数为一个 object，这个 object 可以为 null，当仅使用 lib 时，这个 object 默认填充一个 key=id， value=lib 的键值对；最后那个 duration 通过看 sdk 的源码发现并没有作为第三个参数传递，而是在 object 添加了一个 key=__ct__，value=duration 的键值对。

所以最终明了了，其实是看自己写一个函数合并这几个方法的，新版（8.0.0之后）文档中也弱化了其他，只保留一个了 onEventObject，这个感觉有点诡异，因为演示中可以看到，有一个消息时长的数据面板，按道理应该保留 onEventValue 才对。

猜测可能是 onEventObject 可接受的 object 参数更有普遍性，按照官方文档，onEventValue 接受的参数为：

{
    key:String,
    ....
}
// 在做筛选时，仅可以有上图2的筛选效果

而 onEventObject 则可以

{
    key:String|Long|Integer|Float|Double|Short,
    ....
}
// 在做筛选时，String 为上图2 ，Number类型则为上图1的效果

实际使用中，可根据产品需要进行不同维度的埋点，方便后期验证效果。

友盟推送

推送的集成和 api 都比较简单，易于理解，就不再单独写一篇文章，直接在这里合并记录一下。可以在集成文档、厂商通道集成查看集成方法。

在没有集成厂商通道的情况下：如果 app 处于打开状态（即用户在线）一定可以收到消息、如果用户离线，但另外一个使用了友盟推送的 app 在线，可能会收到消息（鉴于当下各种app会疯狂推送的环境下，这个估计要看友盟的策略了）

在集成了厂商通道的情况下：无论用户是否在线，基本都可以收到消息，这个要看不同厂商的处理规则了。

查看高级功能集成文档，总结一下推送的功能分类

一、通知栏图标、知栏声音、通知栏样式、通知响铃、震动、呼吸灯

属于 UI 性质的，即用户收到通知，会看到什么，听到什么；其中通知栏样式可以扩展，个人感觉没多大必要性

二、标签（Tag）与别名（Alias）

具有统计属性的，方便后期对用户进行分组，查看推送效果

三、消息相关设置

有三个设置，可以让 app 克制一下，对用户友好一点；当然，如果本身就是服务提醒/IM之类的，就尊重用户设置即可

通知栏中可显示消息的最大数目

setDisplayNotificationNumber(int number)

设置勿扰时段，该时段内仅显示消息，但无声音、震动、灯光等

setNoDisturbMode(int startHour, int startMinute, int endHour, int endMinute)

3.当应用处于前台，收到消息是否显示；你可以设置不显示，在 app 内部予以提示，比如加个红点之类的

setNotificaitonOnForeground(bool)

4.让用户决定是否显示消息

disable() 和 enable()

四、消息

有 通知消息、应用内消息、自定义消息 三种；

先说 应用内消息，这个是打开 app 后，显示一个浮层在 app 上，有各种形式可以配置，个人感觉没啥必要，都打开 app 了，显示什么就不用借助友盟了，自己想怎么处理都行，况且使用这个还要增加 active 来做对接处理。

再说 通知消息 和 自定义消息，二者不同之处在于：后者仅把消息传递给 app，不会显示到通知栏，看一下处理消息的三个阶段就明白了

// 收到消息
mPushAgent.setMessageHandler(new UmengMessageHandler(){
    // 收到的是 通知消息
    @Override
    public Notification getNotification(Context context, UMessage msg) {
    }
  
   // 收到的是 自定义消息
   @Override
    public void dealWithCustomMessage(final Context context, final UMessage msg) {
    }
    ...
});


// 若收到的是通知消息，用户点击消息的后续处理
mPushAgent.setNotificationClickHandler(new UmengNotificationClickHandler() {
          // 动作为 打开app
          @Override
          public void launchApp(Context context, UMessage msg) {
          }

          // 动作为 打开url
          @Override
          public void openUrl(Context context, UMessage msg) {
          }

          // 动作为 打开页面
          @Override
          public void openActivity(Context context, UMessage msg) {
          }

          // 动作为 自定义行为
          @Override
          public void dealWithCustomAction(Context context, UMessage msg) {
          }
});


// 已打开消息指定的 active，可以在 active 的 onResume 中获取消息参数
// 另外还需要其配置，可前往官方文档查看
public void onResume() {
     super.onResume();
     .....
}

这三个阶段都有默认的处理方法，都可以