Cocos Analytics 自定义事件功能介绍

在版号政策限制下，国内游戏开发者纷纷开始寻求更多出路，游戏出海是其中之一，而出海游戏最重要的变现方式便是广告。此外，由于小游戏上线广告仅需软著尚未要求版号，因此各个小游戏厂商近期都开始尝试挖掘广告变现的价值。

部分游戏产品虽然拥有不错的留存表现，人均视频曝光次数却达不到要求，效果不尽人意。若采用埋点分析功能，通过自定义事件，可以在游戏各个环节添加埋点收集数据，依靠准确的数据来分析用户行为，对产品进行调整优化。

什么是埋点？如何埋点？在 Cocos Analytics 中怎样用自定义事件功能做埋点分析呢？

什么是埋点？

埋点分析是产品分析常用的一种数据采集方法，运营或产品等相关人员可以按照具体需求，在产品中埋点，定制性地统计较为复杂的用户数据。例如想要追踪用户行为、查看相关点击数据、路径转化率等，就需要事先进行数据埋点，依据埋点得到的数据进行分析。

在埋点前，要先想清楚需求是什么，为了达到这个目的，需要统计哪些数据，要统计这些数据，需要在哪些环节埋点，埋在什么位置，通过什么形式。举个例子，基于视频广告相关的流程，你可以在产品中加入如下埋点的设计：

进入产品：用户从主页面点击打开并登陆游戏
播放广告：用户从弹窗里点击播放按钮
广告填充：用户点击完广告按钮，到广告素材准备好
播放完成率：用户完整看完视频的比例

加入上述四个埋点，您就可以获得广告效果的漏斗模型，基于用户数、设备数来分析是广告环节中的哪一个环节出现问题，从而进行相对应的广告调优，提高广告播放率。

如何埋点？

目前市面上埋点的方式主要分为两种：代码埋点和可视化埋点（即是无埋点）。

代码埋点

优点：监控用户行为，监测数据准确。
缺点：工作量大，需要手动在需要埋点的地方进行埋点。

可视化埋点

优点：通过集成 SDK 进行埋点，运营可自主选择，操作便捷。
缺点：给数据传输增加压力、无法定制详细的业务数据，比如金额、商品数量等，该类数据需要实时变化；需要统一规范，无法用在不同的设备上，比如某些特殊的设备唯一标识不能识别。

两种埋点方式各有优劣。

埋点数据分析功能

数据埋点设计及分析维度的重要配置便是自定义功能，自定义是做数据埋点分析的基础环节，但里面却有很多技巧需要研究，接下来我将结合具体的案例来手把手教大家进行数据埋点分析。

数据结构示例如下：

"evetID":"barrier","eventValue":{

"关卡数" : "魔法瓶",

"玩家级别" : "100",

"玩家战力" : 100,

"复活次数" : 100,

}

长度限制：

eventid（事件ID） 200
tagkey（标签ID） 200
tagvalue（标签值） 200

在上面这个例子中：

“barrier”为 eventID
“关卡数” 为 tagkey
“魔法瓶”为 tagvalue

自定义事件内置了一些默认模板，包括玩家信息、关卡统计、任务统计、道具统计等，具体可查看默认模版部分的文档内容。

注意：事件 ID 不可使用关键字：init、pay、task、barrier、item、advertising、role、virtual，以免和默认模板的数据产生混淆。

有哪些统计报表？

通过报表、监控和可视化，能够洞察到产品运行中的机会点和优化点，逐步走向最优。统计报表功能包括：事件列表，漏斗管理，事件明细和事件埋点分析。

事件列表

列表里展示所有的事件和标签，是使用自定义事件功能的首要维护基础。可以通过编辑按钮对事件-标签描述和数据类型进行添加和维护，也可以由系统第二天从上报数据中自动捕捉的事件与标签，记录为“sys”：

维护数据类型需与上报自定义数据格式一致，如果不一致会导致后续的漏斗和事件明细数据无法统计。提供可选数据类型：string、int、decimal、date。

漏斗管理

即为自定义事件设计漏斗，设计漏斗是埋点分析的核心步骤。

漏斗管理与事件明细功能联动，只有在漏斗管理中配置的事件-标签才出现在事件明细中。

（1）设计漏斗：

点击【设计漏斗】按钮即可创建一个新的漏斗：

各位开发者可以根据之前的数据埋点，在这个页面进行各种组合设计来满足分析需求捕捉亮点。

名称：可以任意设计漏斗名称。

渠道：默认是全渠道“all”，如果指定渠道，修改为上传数据中 store 的值。

转换周期：分为“每天”和“一次性”：每天指的是每天进行统计计算；一次性，指的是统计填写和修改漏斗后当天的数据。

按设计分步骤选择每步的事件-标签-状态-限定条件：

事件-标签：事件列表中的信息。

状态：对应自定义事件的四种接口开始、成功、失败、取消。

限定条件：等于、不等于、大于、小于、区间根据不同数据类型有不同的条件选项。

点击保存后漏斗报表展示：

埋点分析的核心是业务目标或用户行为目标的反馈，因此要从产品价值进行梳理，这是一个精细活。

（2）查看【漏斗配置】并修改

在漏斗列表中，点击想要漏斗右侧的【配置】按钮，即可查看漏斗的具体配置，也可以重新修改配置信息，非常灵活。

（3）查看历史

在这个页面，你可以选择时间范围来查看具体不同时间点的漏斗设计规则，一天内可以多次修改，但只记录和生效最后一次。

在论坛看到开发者反馈查看不到数据，通过看历史配置才知道，其实是他某个时间点做了修改，与实际数据埋点不符合，所以就匹配不到数据了。

事件明细

在事件明细报表中，你可以查看每条事件的时间趋势。有开发者在社区反馈“事件列表有事件和标签，但是在事件明细里看不到数据”，其实这是我们为了节约算力做的一个准入条件，各位开发者需要先在漏斗中进行配置，才可以看到事件明细数据。

事件埋点分析

方便在埋点设计和测试阶段使用，此外一些需要及时响应的埋点分析也可以通过此功能实现。

【事件埋点分析】报表包括：

分析列表

显示提交的分析作业，可查看结果、终止作业。

新增作业

维度：用户数、设备数、触发次数

条件：自定义事件列表中的所有事件和标签。如果着急的话，先自行配置事件和标签，这样就不用等一天让系统自动捕捉了。

Cocos Analytics 自定义接口设计得十分简单，一共提供了 Android、iOS、JavaScript 三个版本，您可以文档查看对应的接入方式

埋点仅仅是完成数据分析的第一步，如何分析收集到的数据，从中发现规律与问题，从而指导产品优化才是重点！