HarmonyOS 鸿蒙Next应用统计功能的开发总结

应用统计功能的开发总结

场景

在项目开发过程中，为了深入了解用户行为、优化产品体验以及做出基于数据驱动的决策，需要一套完善的统计分析工具。某应用统计功能能够帮助我们收集应用的各类数据，包括用户的启动次数、使用时长、页面浏览路径、事件触发情况等多维度信息。通过这些数据，我们可以分析用户在不同时间段、不同地域、不同设备上的使用习惯，找出用户使用过程中的痛点和热点功能，从而为产品的迭代优化提供有力依据，例如确定哪些功能需要改进，哪些新功能可能更受用户欢迎，以及如何进行精准的市场推广等。

集成过程

官方文档：开发者中心

集成步骤：

安装sdk

在项目的跟目录下执行如下命令

ohpm install [@umeng](/user/umeng)/common --registry=https://ohpm.openharmony.cn/ohpm

ohpm install [@umeng](/user/umeng)/analytics --registry=https://ohpm.openharmony.cn/ohpm

在项目的AppScope/resources/rawfile目录下新增一个配置文件umconfig.json

{
  "appKey": "你的apppkey",
  "channel": "你的渠道"
}

在应用模块目录下，添加abilityStage工程文件，例如entry/src/main/ets/abilityStage/MyAbilityStage.ets，具体位置如截图

import AbilityStage from '[@ohos](/user/ohos).app.ability.AbilityStage';

import { preInit, InternalPlugin, setLogEnabled, init, onEventObject } from '[@umeng](/user/umeng)/analytics';

setLogEnabled(true); // 开发时，打开调试日志，可观察sdk是否集成成功

export default class MyAbilityStage extends AbilityStage {

 onCreate() {

   preInit({

     context: this.context.getApplicationContext(),

     plugins: [new InternalPlugin()]

   });

   init(); // 在用户同意隐私政策后再调用此方法

   onEventObject("eventA", {

     "key": "value"

   }); // 埋个点

 }

}

在模块的module.json5文件中添加权限声明

 "requestPermissions": [

      {

        "name": "ohos.permission.INTERNET"

      },

      {

        "name": "ohos.permission.GET_NETWORK_INFO"

      } ],

至此就以及集成完成了，只需要进行注册和调用就可以了。

代码如下：

onCreate() {

    this.initUmConfig()

    console.log('MyAbilityStage.onCreate is called');

  }



  initUmConfig() {

    preInit({

      context: this.context.getApplicationContext(),

      plugins: [new InternalPlugin()]

    });

    init(); // 在用户同意隐私政策后再调用此方法



  }

调用：

onCreate(want: Want, launchParam: AbilityConstant.LaunchParam): void {

    hilog.info(0x0000, 'testTag', '%{public}s', 'Ability onCreate');

    ZRouter.init(true)

    // 添加拦截器

    ZRouter.setGlobalInterceptor(new GlobalNavigateInterceptor())

    // this.initUmConfig()

    onEventObject("eventA", {

      "key": "onCreate-ability"

    }); // 埋个点

  }

遇到问题

初始化的时候一直不成功，报错信息如下：

报错：10-10 16:16:44.236 45576-45576 xxx/xxx/xxx(路径) E [@umeng][common][core]:init初始化失败

解决办法：

经过对该问题的深入排查与反复调试，并依据官方提供的详细提示信息，最终确定在应用的生命周期特定阶段准确注册某应用统计的 SDK 初始化接口，以此为切入点进行操作，才得以顺利解决所面临的问题，成功实现某应用统计功能的正常运作与数据采集。

埋点的时机问题，如果不正确会导致埋点失败。

关于埋点的时机把控至关重要，如果未能在恰当的节点设置埋点，将会致使埋点操作无法成功完成。

在添加埋点的流程之前，务必先获取用户的明确授权，唯有如此，方可顺利开展后续的埋点工作。

总结经验

页面统计逻辑优化：为了提高数据准确性，对页面统计逻辑进行精细化处理。在处理页面生命周期时，除了常规的 WillAppear 和 viewWillDisappear方法外，针对特殊情况（如对话框、悬浮窗等影响页面可见性的元素）进行额外的逻辑判断和数据修正，确保页面的统计时间能够准确反映用户的实际浏览情况。 库冲突解决策略：在引入多个第三方库时，提前进行充分的兼容性测试。当出现库冲突时，仔细分析冲突的原因，查看相关库的文档和源代码，尝试通过调整库的引入顺序、排除重复依赖或者对冲突部分进行代码层面的修改和适配来解决问题。例如，在与数据加密库冲突的情况下，可以与加密库的开发者沟通，协商是否可以对加密库的某些功能进行调整以避免与某应用统计 SDK 的冲突，或者在某应用统计 SDK 中对受影响的部分进行自定义修改，使其能够与加密库共存。通过以上措施，成功解决了某应用统计功能开发过程中的各种问题，实现了稳定、准确的应用数据统计分析，为产品的持续优化和运营提供了可靠的数据支持。