Flutter流量感知与控制插件flowsense_flutter_plugin的使用

Flutter流量感知与控制插件flowsense_flutter_plugin的使用

安装Flowsense SDK非常简单。请仔细遵循以下步骤，并开始享受更精确的应用程序互动。

重要事项

Flowsense是一个需要一组认证令牌才能工作的服务。在尝试安装插件之前，请联系销售团队。

要求

• Android版本16或更高。
• 兼容以下依赖版本：

api 'com.google.code.gson:gson:2.8.2'
api 'io.sentry:sentry-android:1.7.2'
api 'com.google.android.gms:play-services-location:16.0.0'
api 'com.google.firebase:firebase-core:16.0.9'
api 'com.google.firebase:firebase-messaging:17.6.0'
api 'com.amazonaws:*:2.11.0'

启动插件

Flowsense为每个平台提供一个令牌。启动插件时传递特定平台的令牌：

if (Platform.isIOS) {
    FlowsenseFlutterPlugin.shared.startFlowsenseService("your_ios_token");
} else {
    FlowsenseFlutterPlugin.shared.startFlowsenseService("your_android_token");
}

地理位置

如果使用地理位置功能，请在运行时包含位置授权请求：

// 请求权限
FlowsenseFlutterPlugin.shared.requestAlwaysAuthorization();

// 开始位置跟踪
FlowsenseFlutterPlugin.shared.startMonitoringLocation();

在iOS上，您必须在Info.plist文件中包含三个键以显示位置权限消息：

1. Privacy - Location Always and When In Use Usage Description
2. Privacy - Location Always Usage Description
3. Privacy - Location When In Use Usage Description

每个键都必须包含您希望向用户展示的消息。

用户标识符

可以通过以下方式传递匿名化用户标识符给Flowsense：

FlowsenseFlutterPlugin.shared.updatePartnerUserId("your_anonimized_user_info");

丰富用户数据

可以通过传递一组键值对来丰富用户信息：

FlowsenseFlutterPlugin.shared.setKeyValue({"Last Purchase ID": "AIFTS-DF86F"});
FlowsenseFlutterPlugin.shared.setKeyValue({"Last Purchase Value": 63});
FlowsenseFlutterPlugin.shared.setKeyValue({"Registered User": false});
FlowsenseFlutterPlugin.shared.setKeyValue({"Last Purchase Date": new DateTime.now()});
FlowsenseFlutterPlugin.shared.commitChanges();

应用内分析

可以跟踪特定的应用事件，通过传递事件名称和可选的数据集：

FlowsenseFlutterPlugin.shared.inAppEvent("eventName", {
    "buttonClicked": "OK",
    "dateClicked": new DateTime.now()
});

推送通知

有关Flowsense推送的更多信息，请参阅以下链接：

• iOS推送通知
• Android推送通知

iOS

Flowsense iOS SDK默认使用方法交换。您可以通过在app的Info.plist文件中添加以下键来禁用它：FlowsenseCallbackSwizzlingEnabled，其布尔值为NO。

注意：这样做后，Flowsense将无法收集推送分析。

在iOS上，需要在运行时请求推送权限。通过请求令牌实现：

FlowsenseFlutterPlugin.shared.requestPushToken();

可以定义回调以检索iOS令牌并查看推送权限状态：

FlowsenseFlutterPlugin.shared.setPushTokenCallback((token){
    // 处理token
});

FlowsenseFlutterPlugin.shared.setPushPermissionCallback((permission){
    // 处理权限
});

两个平台

可以在接收到通知和/或点击通知时定义回调：

FlowsenseFlutterPlugin.shared.setPushReceivedCallback((notification){
    // 处理接收到的通知
});

FlowsenseFlutterPlugin.shared.setPushClickedCallback((notification){
    // 处理点击的通知
});

完整示例代码

以下是完整的示例代码：

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

import 'package:flutter/services.dart';
import 'package:flowsense_flutter_plugin/flowsense_flutter_plugin.dart';

void main() => runApp(MyApp());

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

class _MyAppState extends State<MyApp> {
  String _platformVersion = 'Unknown';

  [@override](/user/override)
  void initState() {
    super.initState();
    initPlatformState();
  }

  // 平台消息是异步的，所以我们初始化在一个异步方法中。
  Future<void> initPlatformState() async {
    String platformVersion;
    // 平台消息可能失败，所以我们使用try/catch来捕获PlatformException。
    try {
      platformVersion = await FlowsenseFlutterPlugin.platformVersion;
    } on PlatformException {
      platformVersion = 'Failed to get platform version.';
    }

    // 如果小部件在异步平台消息发送时从树中移除，我们希望丢弃回复而不是调用setState来更新我们的非存在的外观。
    if (!mounted) return;

    setState(() {
      _platformVersion = platformVersion;
    });
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: const Text('插件示例应用'),
        ),
        body: Center(
          child: Text('运行在: $_platformVersion\n'),
        ),
      ),
    );
  }
}