Flutter数据分析与监控插件growingio_flutter_library的使用

Flutter SDK Library for GrowingIO Flutter Plugin.

GrowingIO Flutter SDK 提供了 无埋点SDK 和 埋点SDK 两个版本：

• 埋点SDK：只自动采集用户访问事件，需要开发同学调用相应埋点 API 采集埋点事件。
• 无埋点SDK：具备埋点SDK的所有功能，同时具备自动采集基本用户行为事件，如页面访问，点击事件等。

该仓库为埋点仓库和无埋点仓库的基础库。

GrowingIO简介

GrowingIO（北京易数科技有限公司）是基于用户行为数据的增长平台，国内领先的数据运营解决方案供应商。为产品、运营、市场、数据团队及管理者等，提供客户数据平台、获客分析、产品分析、智能运营等产品和咨询服务，帮助企业在数据化升级的路上，提升数据驱动能力，实现更好的增长。
GrowingIO 专注于零售、电商、金融、酒旅航司、教育、内容社区、B2B等行业，成立以来，服务上千家企业级客户，获得迪奥、安踏、喜茶、招商仁和人寿、上汽集团、东航、春航、首旅如家、陌陌、滴滴、爱奇艺、新东方等客户的青睐。

集成文档

步骤1：添加依赖

在 pubspec.yaml 文件中添加 growingio_flutter_library 依赖：

dependencies:
  growingio_flutter_library: ^最新版本号

然后运行以下命令安装依赖：

flutter pub get

步骤2：初始化SDK

在 main.dart 文件中初始化 GrowingIO SDK：

import 'package:flutter/material.dart';
import 'package:growingio_flutter_library/growingio_flutter_library.dart';

void main() {
  // 初始化 GrowingIO SDK
  GrowingIO.init(
    projectId: "您的项目ID", // 替换为您的项目ID
    dataServerUrl: "https://data-server-url", // 替换为您的数据服务器URL
  );

  runApp(MyApp());
}

class MyApp extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'GrowingIO 示例',
      home: HomePage(),
    );
  }
}

步骤3：手动埋点

如果使用埋点SDK，可以通过调用 trackEvent 方法手动埋点：

void trackCustomEvent(String eventName, Map<String, dynamic> properties) {
  GrowingIO.trackEvent(
    eventName: eventName,
    properties: properties,
  );
}

// 在某个按钮点击事件中触发埋点
ElevatedButton(
  onPressed: () {
    trackCustomEvent(
      eventName: "点击按钮",
      properties: {"按钮名称": "提交"},
    );
  },
  child: Text("提交"),
),

步骤4：无埋点自动采集

如果使用无埋点SDK，则无需手动埋点，SDK会自动采集页面访问和点击事件。例如：

class HomePage extends StatefulWidget {
  [@override](/user/override)
  _HomePageState createState() => _HomePageState();
}

class _HomePageState extends State<HomePage> {
  [@override](/user/override)
  void initState() {
    super.initState();
    // 自动记录页面访问事件
    GrowingIO.pageStart(pageName: "首页");
  }

  [@override](/user/override)
  void dispose() {
    // 页面离开时停止采集
    GrowingIO.pageEnd(pageName: "首页");
    super.dispose();
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text("GrowingIO 示例"),
      ),
      body: Center(
        child: Text("欢迎来到首页"),
      ),
    );
  }
}

示例完整代码

以下是完整的示例代码，展示了如何集成 GrowingIO 无埋点SDK并自动采集页面访问事件：

import 'package:flutter/material.dart';
import 'package:growingio_flutter_library/growingio_flutter_library.dart';

void main() {
  // 初始化 GrowingIO SDK
  GrowingIO.init(
    projectId: "您的项目ID", // 替换为您的项目ID
    dataServerUrl: "https://data-server-url", // 替换为您的数据服务器URL
  );

  runApp(MyApp());
}

class MyApp extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'GrowingIO 示例',
      home: HomePage(),
    );
  }
}

class HomePage extends StatefulWidget {
  [@override](/user/override)
  _HomePageState createState() => _HomePageState();
}

class _HomePageState extends State<HomePage> {
  [@override](/user/override)
  void initState() {
    super.initState();
    // 自动记录页面访问事件
    GrowingIO.pageStart(pageName: "首页");
  }

  [@override](/user/override)
  void dispose() {
    // 页面离开时停止采集
    GrowingIO.pageEnd(pageName: "首页");
    super.dispose();
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text("GrowingIO 示例"),
      ),
      body: Center(
        child: ElevatedButton(
          onPressed: () {
            // 手动埋点示例
            GrowingIO.trackEvent(
              eventName: "点击按钮",
              properties: {"按钮名称": "提交"},
            );
          },
          child: Text("提交"),
        ),
      ),
    );
  }
}