目录

订阅分析

功能概述

华为分析服务支持查看按照周期订阅型商品的分析报告,通过分析应用的新增订阅用户数、累计订阅用户、累计订阅金额等关键指标洞察用户订阅情况。同时支持查看用户订购明细、留存分析、付费分析以及续订分析报告。

订阅分析中的所有报告均基于按User-ID的计算逻辑展示。

前提条件

开通华为分析服务并集成华为分析SDK。开通华为分析服务操作详情请参见开通服务,集成Android SDK操作详情请参见集成SDK。

配置说明

查看订阅分析报告,需要完成相关的预置事件上报,如下表所示:

序号

事件名称

参数说明

场景说明

可选上报方式

建议方式

1

订阅事件

$Subscribe

用户在App内产生订阅行为,数据由App上报,需要从App端侧上报预置事件。

App侧上报预置事件

推荐App侧上报预置事件。

2

取消订阅事件

$Unsubscribe

场景1:

用户在App内产生取消订阅行为,取消订阅事件数据由App上报,需要从App端侧上报预置事件。

场景2:

取消订阅事件App端侧无法获取,数据需要从云侧获取时,需要从服务器侧上报数据。

推荐从服务器侧上报预置事件

3

付费事件

$InAppPurchase或者$CompletePurchase

场景1:

付费事件数据从服务器产生,后续扣费事件的数据由服务器获取时,需要从服务器侧上报数据。

场景2:

付费事件从App端侧产生,数据由端侧产生,可以从App侧上报预置事件,但如后续扣费数据的上报获取需从服务器获取,需按场景1上报。

推荐从服务器侧上报预置事件

4

退费事件

$RefundOrder

场景1

退费事件从云侧产生,数据由服务器获取时,需要从服务器上报数据 。

场景2

App端侧支持退费,退费事件数据从App端侧上报预置事件。

推荐从服务器侧上报预置事件

[h2]App侧上报预置事件

数据由App上报,从App端侧上报预置事件,需在华为分析端侧SDK中埋点预置事件。

请参考如下代码在SDK中埋点预置事件及参数:

“Java”
Bundle bundle = new Bundle();
bundle.putString("$ProductId", "123"); 
bundle.putString("$ProductName", "name"); 
instance.onEvent("$Subscribe", bundle);
“Kotlin”
val bundle = Bundle()
bundle.putString("$ProductId", "123")
bundle.putString("$ProductName", "name")
instance.onEvent("$Subscribe", bundle)

此处仅提供了订阅事件$Subscribe埋点方法的样例,其它事件及其参数埋点可参考此样例的方法进行埋点。其它事件及参数说明请参考事件参数说明。

[h2]服务器侧上报预置事件

对于App端侧无法获取的事件,例如非用户主动在App上取消订阅的行为、后续扣费行为、部分退费行为(用户申诉后操作员从云侧操作产生的退费),数据需要从云侧获取,需要从服务器侧完成埋点上报数据。

华为分析服务提供直接调用上报用户行为接口和集成服务端SDK的方式完成服务端事件埋点上报,您可以任选一种方式实现上报:

通过上报用户行为接口上报事件信息

事件上报通过上报用户行为接口中的eventid实现,接口详细说明请参见上报用户行为,以$Unsubscribe事件为例,埋点样例如下:

POST /analytics/datacollection/import/event HTTP/1.1
Content-Type: application/json; charset=UTF-8
Content-Length: xxxx
Accept: application/json
Authorization: Bearer 78C239xxxxxxxx 
x-product-id: sample-productid
x-app-id: sample-appid
                                   
                                   
{
    "data_type":3,
    "protocol_version":"1",
    "requestid":"083e920d3f2xxxxxxxx",
    "timestamp":1624435942860,
    "appid":"xxxxxxxxx",
    "productid":"xxxxxxxxxxxxxxxxx",
    "package_name":"com.huawei.test",
    "event_set":[
        {
            "aaid":"xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
            "userid":"",
            "oaid":"xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
            "oaid_source":"oaid",          
            "_oaid_tracking_flag":"true",
            "pushtoken":"",
            "eventtime":1587867045291,
            "event_session_name":"e508bb99af7f41f5b1573690xxxxxxxx_1587866781700",
            "eventid":"$Unsubscribe",
            "first_session_event":"true",
            "properties":{
                "$ProductId":"123",
                "$ProductName":"123",
                "$Reason":"4"
            }
        },
        {
            "aaid":"xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
            "userid":"",
            "oaid":"xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
            "oaid_source":"oaid",          
            "_oaid_tracking_flag":"true",
            "androidid":"",
            "pushtoken":"",
            "eventtime":1587867045292,
            "event_session_name":"e508bb99af7f41f5b1573690xxxxxxxx_1587866781700",
            "eventid":"notification_received",
            "first_session_event":"false",
            "properties":{
                "exam_level":"1-1",
                "exam_difficulty":"high",
                "exam_price":39
            }
        },
        {
            "aaid":"xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
            "userid":"",
            "oaid":"xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
            "oaid_source":"oaid",          
            "_oaid_tracking_flag":"true",
            "androidid":"",
            "pushtoken":"",
            "eventtime":1587867045291,
            "event_session_name":"e508bb99af7f41f5b1573690xxxxxxxx_1587866781700",
            "eventid":"$Unsubscribe",
            "first_session_event":"true",
            "properties":{
                "$ProductId":"123",
                "$ProductName":"123",
                "$Reason":"4"
             }
        }
    ]
}     

集成服务端SDK的方式上报事件信息

如果采用集成服务端SDK的方式,需先集成服务端SDK,通过调用服务端SDK中封装的类实现事件上报。

  1. 集成服务端SDK。
    • 针对Java应用:集成方式请参见JAVA SDK。
    • 针对Python应用:SDK下载及集成方式请参见Python SDK。
    • 针对NodeJS应用:SDK下载及集成方式请参见NodeJS SDK。
  2. 在服务端埋点上报事件信息。

    以Java应用埋点$Unsubscribe事件为例,参考样例如下:

      EventPojo eventPojo = new EventPojo(); 
      eventPojo.setAaid("123"); 
      eventPojo.setUserId(""); 
      eventPojo.setEventTime(1631606679895L); 
      eventPojo.setEventId("$Unsubscribe"); 
      eventPojo.setEventSessionName("123"); 
      eventPojo.setFirstSessionEvent("true"); 
      eventPojo.setProperties(""); 
      Map<String,Object> map = new HashMap<>();
      map.put("$ProductId","111");
      map.put("$ProductName","222");
      map.put("$Reason","4");
      eventPojo.setProperties(map);
      HuaweiAnalyticsClient.addEvent("123", eventPojo);

[h2]服务器侧新建预置事件

预置事件上报设置完成后,还需在“华为分析 > 管理 > 事件管理”界面中通过新建预置事件的方式将$Subscribe、$Unsubscribe、$CompletePurchase和$RefundOrder事件手动注册到系统。

  1. 选择“华为分析 > 管理 > 事件管理”进入事件管理页面。
  2. 点击“新建”,打开“新建事件”页面。

    新建事件页面左侧“添加事件”下方展示未注册的预置事件列表,可在输入框中输入事件ID或名称搜索后选中并保存。新建事件操作详情可参考新建预置事件或自定义事件。

事件参数说明

[h2]$Subscribe

订阅自动续费类型商品时,上报此事件。

参数ID

参数名称

参数类型

可选/必选

参数描述

$ProductId

商品ID

String

必选

订阅的商品的ID。

$ProductName

商品名称

String

必选

订阅的商品的名称。

$TaskId

任务ID

String

可选

营销任务ID。

[h2]$Unsubscribe

取消订阅自动续费类型商品时,上报此事件。

参数ID

参数名称

参数类型

可选/必选

参数描述

$ProductId

商品ID

String

必选

取消订阅的商品的ID。

$ProductName

商品名称

String

必选

取消订阅的商品的名称。

$Reason

取消订阅原因

String

必选

用户取消订阅的原因。取值包括:

  • 1:用户取消
  • 2:商品不可用
  • 3:用户签约信息异常
  • 4:Billing错误
  • 5:用户未同意涨价
  • 6:未知错误

同时有多个异常时,优先级为:1 > 2 > 3…

$TaskId

任务ID

String

可选

营销任务ID。

[h2]$CompletePurchase

用户支付完成后,上报此事件。

参数ID

参数名称

参数类型

可选/必选

参数描述

$ProductId

商品ID

String

必选

被添加到购物车中的商品ID。

$ProductName

商品名称

String

必选

被添加到购物车中的商品名称。

$Quantity

购买数量

Long

必选

用户准备购买的数量。

$CurrName

货币类型

String

可选

标识收入的货币类型。与$Revenue一起使用。

$Revenue

收入

Double

可选

本次交易给您带来的收入。必须与$CurrName同时使用。

$Brand

商品品牌

String

可选

关联的商品品牌。

$Category

商品分类

String

可选

关联的商品分类。

$PayType

支付方式

String

可选

用户选择的支付方式。

$PurchaseType

购买方式

String

必选

购买商品的方式:

  • 0:普通支付类型
  • 1:订单类型
  • 2:订阅类型
  • 3:代扣类型

针对订阅类型,请填写值“2”。

$VoucherName

优惠券名称

String

可选

用户在本次交易中使用的优惠券的名称。

$VoucherPrice

优惠价格

String

可选

用户在本次交易中使用的优惠券的价格。

[h2]$RefundOrder

用户取消订单后,申请退款时,上报此事件。

参数ID

参数名称

参数类型

可选/必选

参数描述

$CurrName

货币类型

String

可选

退款的货币类型。

$Revenue

退款额

Double

可选

退款给您带来的收入损失。

$ProductId

商品ID

String

必选

被退款的商品ID。

$ProductName

商品名称

String

必选

被退款的商品名称。

$Quantity

购买数量

Long

必选

用户准备购买的数量。

$Brand

商品品牌

String

可选

关联的商品品牌。

$Category

商品分类

String

必选

关联的商品分类。

$Source

营销来源

String

可选

营销活动提供者的标识,如:HUAWEI PPS。

$Medium

营销类型

String

可选

营销活动的类型,如:CPC、Email、运营坑位、Banner等。

$PromotionName

营销名称

String

可选

营销活动的名称。

$Content

营销内容

String

可选

营销活动的营销内容。

$Keywords

关键词

String

可选

营销活动的关键词。如:搜索广告的关键词。

$MaterialName

创意名称

String

可选

营销活动使用的创意素材名称。

$MaterialSlot

营销内容展示位置

String

可选

创意素材被展示的位置信息。

$Reason

退款原因

String

必选

用户选择退款的原因。

$PayType

支付方式

String

可选

用户选择的支付方式。

查看分析报告

[h2]订阅分析

订阅分析报告最上方统计筛选日期范围内整体的累计指标,包括累计订阅用户、累计取消订阅、累计退款人数、累计订阅金额、累计退款金额指标。支持选择应用、自定义时间段查询报告。

累计指标下方报告以趋势图形式展示选定日期下Top5订阅商品的新增订阅用户数和取消订阅用户数。

订阅分析指标

指标

指标说明

需埋点事件及参数

累计订阅用户

所选时段内订阅过的用户数。

通过订阅事件$Subscribe统计。

累计取消订阅

所选时段内取消订阅过的用户数。

通过取消订阅事件$Unsubscribe统计。

累计退款人数

所选时段内退款过的用户数。

通过$RefundOrder事件统计。

累计订阅金额

所选时段内订阅商品的付费金额(减去退款金额)。

-

累计退款金额

所选时段内订阅商品的退款金额。

通过$RefundOrder事件下参数$Revenue和$CurrName统计。

新增订阅用户数

统计日当日,订阅过的用户数。

通过订阅事件$Subscribe统计。

取消订阅用户数

统计日当日,取消订阅过的用户数。

通过取消订阅事件$Unsubscribe统计。

[h2]订购明细

按照自定义时间段查询每日数据明细。报告右上角可筛选套餐类型查看对应的分析报告,默认查询所有订阅商品。

订购明细指标

指标

指标说明

需埋点事件及参数

新增订阅用户

统计日当日,订阅过的用户数。

通过订阅事件$Subscribe统计。

购买总价

统计日当日,订阅过的用户购买商品的总价。

-

取消订阅用户数

统计日当日,取消订阅过的用户数。

通过取消订阅事件$Unsubscribe统计。

退款用户数

统计日当日,退款的用户数。

通过$RefundOrder事件统计。

退款金额

统计日当日,用户退款的金额。

通过$RefundOrder事件下参数$Revenue和$CurrName统计。

累计订阅用户

统计日当日,处于订阅状态的用户数。

-

[h2]留存分析

包括处于订阅状态的活跃用户的留存分析报告和没有处于订阅状态的活跃用户的留存分析报告。

[h2]付费分析

筛选范围内按天分析付费用户的平均收入(ARPPU),趋势图中区分订阅付费用户和非订阅付费用户。

付费分析指标

指标

指标说明

需埋点事件及参数

ARPPU

每付费用户每天的平均收入。

通过$CompletePurchase和自动采集事件$InAppPurchase统计。

[h2]续订分析

续订分析可以查看上一周期已订阅的用户中,本周期继续订阅的比例,即查看已订阅用户续订率的情况。

续订率基于固定日期计算,续订周期可选择30天或31天。