Flutter数据分析插件eanalytics的使用

初始化

在您的应用的顶层调用Eulerian.init方法以进行初始化。这将尝试同步任何本地存储的失败跟踪请求。

await Eulerian.init('test.domain.dev');

注意：对于iOS设备，您可以选择性地通过传递requestTrackingAuthorization标志来请求跟踪授权。

跟踪事件

要跟踪EAProperties，可以在Flutter应用的任何地方调用Eulerian.track方法。如果POST请求失败，它将被存储在本地存储中以供将来重试。

Eulerian.track([
  EAProducts(path: '/add/products')
    ..addProduct(Product(ref: 'p1', name: 'Product 1', group: 'test_group'))
]);

EAProperties 包括 EACart, EAEstimate, EAOrder, EAProducts, EASearch。还有一些辅助模型用于构建 EAProperties：Action, Params, Product, Search, SiteCentric。

iOS设置

如果您计划使用广告标识符（advertising identifier），请确保更新您的Info.plist文件，并添加NSUserTrackingUsageDescription键，描述您的使用方式。

<key>NSUserTrackingUsageDescription</key>
<string>请求跟踪...</string>

在初始化EAnalytics时，传递requestTrackingAuthorization标志以提示用户进行跟踪授权。

[@override](/user/override)
void initState() {
  Eulerian.init('domain.name', requestTrackingAuthorization: true);
  super.initState();
}

全局EAnalytics属性

EAnalytics会根据您的平台内部处理设置以下属性：

(*) url属性在iOS上映射到bundleIdentifier，在Android上映射到getPackageName，在Web平台上映射到当前URL路径。

( ) ea-ios-idfv需要在iOS上初始化eanalytics时传递requestTrackingAuthorization标志。

Flutter SDK版本

>=2.12.0 <3.0.0

示例代码

以下是一个完整的示例代码，展示了如何使用eanalytics插件进行事件跟踪。

import 'package:eanalytics/eanalytics.dart' as EAnalytics;
import 'package:flutter/material.dart';

void main() {
  runApp(MaterialApp(home: Home('EAnalytics Integration')));
}

class Home extends StatefulWidget {
  Home(this.title) : super();
  final String title;

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

class _HomeState extends State<Home> {
  [@override](/user/override)
  void initState() {
    EAnalytics.Eulerian.init('et.eulerian.net',
        requestTrackingAuthorization: true, enableLogger: true);
    super.initState();
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: const Text('Eulerian Analytics TRACKERS'),
      ),
      body: GridView.count(
        primary: false,
        padding: const EdgeInsets.all(20),
        crossAxisSpacing: 10,
        mainAxisSpacing: 10,
        crossAxisCount: 2,
        children: [
          OutlinedButton(
            onPressed: () => EAnalytics.Eulerian.track([
                EAnalytics.EAProperty(path: '/home')
                  ..setLabel('lbl1,lbl2,,lbl4')
                  ..setCustomParam('cpvKey', 'cpvTest')
                  ..setEmail('johndoe@eulerian.dev')
                  ..setProperty(EAnalytics.SiteCentric()
                    ..addParam('prop', ['foo', 'baz']))
                  ..setCFlag(
                      EAnalytics.SiteCentric()..addParam('cflag_', ['foo']))
            ]),
            child: Text('EAProperty'),
          ),
          OutlinedButton(
            onPressed: () => EAnalytics.Eulerian.track([
              EAnalytics.EAProducts(path: '/add/product')
                ..addProduct(EAnalytics.Product(
                    ref: 'p1',
                    name: 'Product 1',
                    group: 'group_of_doom',
                    parameters: EAnalytics.Params()
                      ..addParam('foo', 'bar')
                      ..addParam('baz', [1, 2, 3])))
            ]),
            child: Text('Single product'),
          ),
          OutlinedButton(
            onPressed: () => EAnalytics.Eulerian.track([
              EAnalytics.EAProducts(path: '/add/products')
                ..setLocation(latitude: 1.234543, longitude: 54.35322)
                ..setAction(
                    EAnalytics.Action(name: 'test', mode: 'in'))
                ..addProduct(EAnalytics.Product(
                    ref: 'p1', name: 'Product 1', group: 'group_of_doom'))
                ..addProduct(EAnalytics.Product(
                    ref: 'p2',
                    name: 'Product 2',
                    group: 'group_of_doom',
                    parameters: EAnalytics.Params()
                      ..addParam('foo', {'baz': 'bar'})))
            ]),
            child: Text('Multiple products'),
          ),
          OutlinedButton(
            onPressed: () => EAnalytics.Eulerian.track([
                EAnalytics.EAActions(path: '')
                  ..setStandalone()
                  ..addAction(
                      EAnalytics.Action(
                          name: 'button1', mode: 'in'))
                  ..addAction(
                      EAnalytics.Action(
                          name: 'lbldisplay', mode: null, label: 'label1,,label3' )
                      ..setParams(
                          EAnalytics.Params()
                          ..addParam('input', 'test')
                          ..addParam('select', 'val1')
                          )
                )
            ]),
            child: Text('StandAloneAction'),
          ),
        ],
      ),
    );
  }
}