快速找到所需文档，高效完成接入与排障

适用范围

支持平台：微信小游戏、字节跳动小游戏、QQ小游戏、快应用小游戏

LTV概念概述

LTV用户价值（life time value）指应用从用户获取到用户流失过程中获得的收益总和，收入金额是最常见的收益口径之一，和获客成本比对可判断投入和产出是否平衡。业务方通过LTV用户价值趋势，可分析特定日期或周期内新获取的用户群体在一定时长内所贡献的人均价值，了解拉新活动的效果。

LTV用户价值作为常见的衡量变现效果的通用指标，在广告投放、运营拉新等场景中均有涉及。

适用场景

1. 运营活动拉新的质量如何？通过活动拉新带来的新用户价值是否高于以往？是否带来了显著的收益？

2. 完成获客后，哪个时间段是用户提供价值的黄金阶段？在何时需要再提供刺激使用户产生更多价值？

3. 用户贡献的价值会在多久之后趋于稳定？

4. 用户贡献的价值是否高于用户获取的成本？

wx.uma.revenue({
group:'default',//该字段名称不可修改，必传
  money:100,// 付费金额 （该字段必传） 格式：数值型，number；请注意值格式，传错不能进行金额计算
  name:"充值",// 付费项目（该字段必传），字符格式， 例如：充值、广告、复活等
  desc:"个人中心进行充值充值"// 描述（非必选） String
})

wx.uma.revenue({
group:'stage',// 该字段为关卡付费固定字段不可修改  （该字段必传）
   stageId:"stage1",// 关卡id  （该字段必传）          String  
   stageName:"新手关",// 关卡名称 （该字段必传）    String  
   money:100,// 付费金额 （该字段必传）         Number 
   name:"复活机会",// 付费项目（该字段必传）     String  
   desc:"在关卡中使用火力增强，增加实力",// 描述（可选）  String  
})

3.等级付费

接口

uma.revenue

参数

示例

wx.uma.revenue({
group:'grade',// 该字段为关卡付费固定字段不可修改  （该字段必传）
   levelId:"level1",// 关卡id  （该字段必传）          String  
   levelName:"等级1",// 关卡名称 （该字段必传）    String  
   money:100,// 付费金额 （该字段必传）         Number 
   name:"复活机会",// 付费项目（该字段必传）     String  
   desc:"在关卡中使用火力增强，增加实力",// 描述（可选）  String  
})

使用方法

1.按照指定方式上报

详见上文「付费金额上报方式」，及小游戏高级自定义事件上报规则

2.查看数据

当前为小游戏类型应用（微信小游戏、字节跳动小游戏、QQ小游戏、快应用小游戏），在左侧菜单选择「LTV用户价值」进入看板。

看板支持的最大周期为60天，视所选的周期长度展示LTV首日-LTV10、LTV14、LTV30、LTV60、LTV累计。

LTV趋势

呈现选定周期内的LTV趋势变化，可帮助您了解周期内所有新用户在获客n天内人均贡献的变化趋势。

由于分子是新用户获客后首日内→2天内→3天内→...→n天内的提供的贡献，在周期内是不断进行多日累加的，而分母为周期内每日新用户数的加总，在周期内是固定值，所以LTV的值会逐日增大，最终呈现一个不断向上直至平缓的折线图。

每日明细

呈现周期内每日的LTV明细数据，可帮助您了解单日获得的新用户在获客n天内人均贡献的数值。

例如图例中10.21日获客2400人，则10.21日的LTV首日是这2400位新用户在10.21日的人均贡献，10.21日的LTV4是这2400位新用户在10.21至10.24日这4天内所有贡献的人均值，10.21日的LTV累计是这2400位新用户在10.21至周期内最后一日已经产生的所有贡献的人均值。