快速开始

安装

pnpm install @ifanrx/uni-stats

使用

初始化

请确保在 src/main.js 中进行初始化，如下所示初始化 GA4：

import ga from '@ifanrx/uni-stats/ga'

ga.config('your_measurement_id', 'your_api_secret', {
  log: true,
})

export function createApp() {
  app.use(ga) // 全局挂载，可以通过 `uni.ga` 或者在模板中通过 `ga` 访问。

  return {
    app,
  }
}

然后在页面中，您可以通过显式引入或使用全局变量的方式使用：

<script setup>
import ga from '@ifanrx/uni-stats/ga'

// 可以显式引入后访问
ga.event(...)

// 也可以直接这样访问
uni.ga.event(...)
</script>

<template>
  <!-- 也可以直接在模板中访问，通过实例全局变量 -->
  <div @click="ga.event(...)"></div>
</template>

代码提示

通过全局变量访问会丢失代码提示，可以通过以下方式定义类型声明：

types/global.d.ts

declare namespace UniNamespace {
  interface UniInterface extends globalThis.UniInterface {
    ga: typeof import('@ifanrx/uni-stats/ga').default
    uma: typeof import('@ifanrx/uni-stats/uma').default
  }
}

tsconfig.json

{
  "compilerOptions": {
    "types": ["./types/global.d.ts"]
  }
}