Flutter事件分析插件event_analysis_library的使用

Flutter事件分析插件event_analysis_library的使用

开始使用

首先，在你的 pubspec.yaml 文件中添加 event_analysis_library 包作为依赖项。

dependencies:
  event_analysis_library: ^1.0.0

然后运行 flutter pub get 来获取新的依赖项。

配置权限

在 Android 平台的 AndroidManifest.xml 文件中添加以下权限：

<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
<uses-permission android:name="android.permission.FOREGROUND_SERVICE" />
<uses-permission android:name="android.permission.ACCESS_BACKGROUND_LOCATION"/>

在 iOS 平台的 Info.plist 文件中添加以下权限描述：

<key>NSLocationWhenInUseUsageDescription</key>
<string>此应用需要访问您的位置信息。</string>
<key>NSLocationAlwaysUsageDescription</key>
<string>此应用需要在后台访问您的位置信息。</string>

在 Podfile 文件中添加以下配置：

post_install do |installer|
    installer.pods_project.targets.each do |target|
        target.build_configurations.each do |config|
        config.build_settings['GCC_PREPROCESSOR_DEFINITIONS'] ||= [
            '$(inherited)',
            'PERMISSION_LOCATION=1',
        ]
        end
    end
end

创建SDK单例类

创建一个单例类来初始化和使用事件分析插件：

import 'package:event_analysis_library/event_analysis_library.dart';

class AnalysisSdk {
  factory AnalysisSdk() {
    return _instance;
  }

  AnalysisSdk._internal();

  static final AnalysisSdk _instance = AnalysisSdk._internal();

  CreateEvent? _createEvent;
  bool? result;

  initializeSdk({required String locale}) async {
    _createEvent = CreateEvent(productKey: 'bigmart-mobile', locale: locale);
    result = await _createEvent!.initialize(askLocationPermission: true); //False if you want to handle location permission in app
    return result;
  }

  postEvent(String eventType, String eventValue, String userId, var offset) async {
    if(result!){
      await _createEvent!.postEvent(eventType: eventType, eventValue: eventValue, userId: userId, position: offset);
    }else{
      result = await initializeSdk(locale: 'en_us');
      await _createEvent!.postEvent(eventType: eventType, eventValue: eventValue, userId: userId, position: offset);
    }
  }

  userIdentity(String userId) async {
    if(result!){
      await _createEvent!.userIdentity(userId);
    }else{
      result = await initializeSdk(locale: 'en_us');
      await _createEvent!.userIdentity(userId);
    }
  }
}

初始化SDK

在应用启动时初始化SDK并提供当前使用的语言环境：

Future<void> main() async {
  WidgetsFlutterBinding.ensureInitialized();
  await AnalysisSdk().initializeSdk(locale: "en_US");
  runApp(MyApp());
}

记录用户身份

当用户登录应用时调用 userIdentity 方法：

await AnalysisSdk().userIdentity('123123');

记录事件

在需要记录事件的地方调用 postEvent 方法。例如，记录按钮点击事件：

var offset = _getPositions(context, _globalKey);
await AnalysisSdk().postEvent("BUTTON CLICK", "EVENT VALUE", 'USER ID', offset);

_getPositions(BuildContext context, GlobalKey key) {
  final RenderBox? renderBox = key.currentContext!.findRenderObject() as RenderBox?;
  final offSet = renderBox!.localToGlobal(Offset.zero);
  return offSet;
}

完整示例

以下是一个完整的示例代码，展示了如何在应用中使用事件分析插件：

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

import 'analysis_sdk.dart';

Future<void> main() async {
  WidgetsFlutterBinding.ensureInitialized();
  await AnalysisSdk().initializeSdk(locale: "en_US");
  runApp(MyApp());
}

class MyApp extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Flutter Demo',
      theme: ThemeData(
        primarySwatch: Colors.blue,
      ),
      home: MyHomePage(title: 'Flutter Demo Home Page'),
    );
  }
}

class MyHomePage extends StatefulWidget {
  MyHomePage({Key? key, required this.title}) : super(key: key);

  final String title;

  [@override](/user/override)
  _MyHomePageState createState() => _MyHomePageState();
}

class _MyHomePageState extends State<MyHomePage> {
  GlobalKey _globalKey = GlobalKey();
  List<GlobalKey> _list = [
    GlobalKey(),
    GlobalKey(),
    GlobalKey(),
  ];
  List<String> list = [];

  _getPositions(BuildContext context, GlobalKey key) {
    final RenderBox? renderBox = key.currentContext!.findRenderObject() as RenderBox?;
    final offSet = renderBox!.localToGlobal(Offset.zero);
    return offSet;
  }

  [@override](/user/override)
  void initState() {
    super.initState();
    list = [];
    for (var i = 0; i < 50; i++) {
      list.add("test");
    }
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text(widget.title),
      ),
      body: Center(
        child: Column(
          mainAxisAlignment: MainAxisAlignment.center,
          children: [
            ElevatedButton(
              key: _globalKey,
              onPressed: () async {
                var offset = _getPositions(context, _globalKey);
                await AnalysisSdk().postEvent("BUTTON CLICK", "EVENT VALUE", 'USER ID', offset);
              },
              child: Text('EVENT TRIGGER'),
            ),
            ElevatedButton(
              onPressed: () async {
                await AnalysisSdk().userIdentity('123123');
              },
              child: Text('USER IDENTITY'),
            ),
          ],
        ),
      ),
    );
  }
}