Flutter用户互动与数据分析插件webengage_flutter的使用

WebEngage Flutter SDK

WebEngage Flutter SDK 是一个用于在Flutter应用程序中集成用户互动和数据分析功能的插件。它允许开发者通过推送通知、InApp消息和其他渠道与用户进行互动，并收集用户行为数据以便进行深入分析。更多信息请参阅官方网站和官方文档。

更多信息

• 您可以查看示例main.dart以了解如何在Flutter应用中使用WebEngage。

插件信息

您可以从Pub.dev获取WebEngage Flutter SDK插件。

问题？

如果您有任何疑问或需要进一步的帮助，请联系我们的支持团队。

示例代码

以下是一个完整的示例demo，展示了如何在Flutter项目中使用webengage_flutter插件：

import 'dart:io';
import 'package:flutter/material.dart';
import 'dart:async';
import 'package:flutter/services.dart';
import 'package:permission_handler/permission_handler.dart';
import 'package:webengage_flutter/webengage_flutter.dart';
import 'package:intl/intl.dart';

class MyApp extends StatefulWidget {
  @override
  _MyAppState createState() => _MyAppState();
}

class _MyAppState extends State<MyApp> {
  late WebEngagePlugin _webEngagePlugin;
  late String os;

  // 回调函数定义
  void _onPushClick(Map<String, dynamic>? message, String? s) {
    print("Push click callback. Payload " + message.toString());
  }

  void _onPushActionClick(Map<String, dynamic>? message, String? s) {
    print("Push action click callback. Payload " + message.toString());
    print("SelectedId " + s.toString());
  }

  void _onInAppPrepared(Map<String, dynamic>? message) {
    print("Inapp prepared callback. Payload " + message.toString());
  }

  void _onInAppClick(Map<String, dynamic>? message, String? s) {
    print("Inapp click callback. Payload " + message.toString());
  }

  void _onInAppShown(Map<String, dynamic>? message) {
    print("Callback on inapp shown. Payload " + message.toString());
  }

  void _onInAppDismiss(Map<String, dynamic>? message) {
    print("Callback on inapp dismiss. Payload " + message.toString());
  }

  void _onTokenInvalidated(Map<String, dynamic>? message) {
    print("tokenInvalidated callback received " + message.toString());
    WebEngagePlugin.setSecureToken("USER_NAME", "REPLACE_JWT_TOKEN_HERE");
  }

  void _listenToAnonymousID() {
    _webEngagePlugin.anonymousActionStream.listen((event) {
      setState(() {
        data = "${event}";
      });
    });
  }

  Future<void> initPlatformState() async {
    if (Platform.isAndroid) {
      if (await Permission.notification.request().isGranted) {
        print("Notification permission is granted");
        WebEngagePlugin.setUserDevicePushOptIn(true);
      } else {
        print("Notification permission is denied.");
        WebEngagePlugin.setUserDevicePushOptIn(false);
      }
    }
  }

  void initWebEngage() {
    _webEngagePlugin = new WebEngagePlugin();
    _webEngagePlugin.setUpPushCallbacks(_onPushClick, _onPushActionClick);
    _webEngagePlugin.setUpInAppCallbacks(
        _onInAppClick, _onInAppShown, _onInAppDismiss, _onInAppPrepared);
    _webEngagePlugin.tokenInvalidatedCallback(_onTokenInvalidated);
    subscribeToPushCallbacks();
    subscribeToTrackDeeplink();
    subscribeToAnonymousIDCallback();
    _listenToAnonymousID();
  }

  var data = "";
  var anonymousId = "null";

  void _openLoginModal() {
    // 登录对话框逻辑
  }

  void showToast(String msg) {
    // 显示Toast消息
  }

  void subscribeToPushCallbacks() async {
    // Push回调订阅逻辑
  }

  void subscribeToTrackDeeplink() {
    // DeepLink跟踪逻辑
  }

  void subscribeToAnonymousIDCallback() {
    // 匿名ID回调订阅逻辑
  }

  final navigatorKey = GlobalKey<NavigatorState>();

  void showDialogWithMessage(String msg) {
    // 显示对话框逻辑
  }

  @override
  void initState() {
    super.initState();
    initPlatformState();
    initWebEngage();
  }

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      navigatorKey: navigatorKey,
      home: Scaffold(
        appBar: AppBar(
          title: Text('WebEngage Example'),
        ),
        body: ListView(
          children: <Widget>[
            ListTile(
              title: Text("Login"),
              onTap: () {
                String userName = "REPLACE_YOUR_USERNAME";
                WebEngagePlugin.userLogin(userName);
                showToast("Login-" + userName);
              },
            ),
            ListTile(
              title: Text("Logout"),
              onTap: () {
                WebEngagePlugin.userLogout();
                showToast("Logout");
              },
            ),
            ListTile(
              title: Text("Set FirstName"),
              onTap: () {
                WebEngagePlugin.setUserFirstName('Sourabh');
                showToast("User FirstName- Sourabh");
              },
            ),
            ListTile(
              title: Text("Track Event with no attributes"),
              onTap: () {
                WebEngagePlugin.trackEvent('Added to Cart');
                showToast("Added to Cart tracked ");
              },
            ),
            ListTile(
              title: Text("Opt-In Push, InApp, email, sms, whatsapp, viber"),
              onTap: () {
                WebEngagePlugin.setUserOptIn('in_app', true);
                WebEngagePlugin.setUserOptIn('sms', true);
                WebEngagePlugin.setUserOptIn('push', true);
                WebEngagePlugin.setUserOptIn('email', true);
                WebEngagePlugin.setUserOptIn('whatsapp', true);
                WebEngagePlugin.setUserOptIn('viber', true);
                showToast("Opt-In all channels");
              },
            ),
            ListTile(
              title: Text("Opt-Out Push, InApp, email, sms, whatsapp, viber"),
              onTap: () {
                WebEngagePlugin.setUserOptIn('in_app', false);
                WebEngagePlugin.setUserOptIn('sms', false);
                WebEngagePlugin.setUserOptIn('push', false);
                WebEngagePlugin.setUserOptIn('email', false);
                WebEngagePlugin.setUserOptIn('whatsapp', false);
                WebEngagePlugin.setUserOptIn('viber', false);
                showToast("Opt-Out all channels");
              },
            ),
            ListTile(
              title: Text("Track event with attributes"),
              onTap: () {
                WebEngagePlugin.trackEvent('Order Placed', {'Amount': 808.48});
                showToast("Order Placed tracked Amount: 808.48");
              },
            ),
            ListTile(
              title: Text("Track Screen"),
              onTap: () {
                WebEngagePlugin.trackScreen('Home Page');
                showToast("Track Screen :Home Page");
              },
            ),
            ListTile(
              title: Text("Set User attribute with string value "),
              onTap: () {
                WebEngagePlugin.setUserAttribute("twitterusename", "saurav12994");
                showToast("twitterusename:saurav12994");
              },
            ),
            ListTile(
              title: Text("Start GAID Tracking"),
              onTap: () {
                WebEngagePlugin.startGAIDTracking();
                showToast("Started GAID Tracking");
              },
            ),
          ],
        ),
      ),
    );
  }

  @override
  void dispose() {
    _webEngagePlugin.pushSink.close();
    _webEngagePlugin.pushActionSink.close();
    _webEngagePlugin.trackDeeplinkURLStreamSink.close();
    super.dispose();
  }
}

Future<void> main() async {
  WidgetsFlutterBinding.ensureInitialized();
  runApp(MyApp());
}

此代码提供了一个基本框架，展示了如何初始化WebEngage插件并设置各种回调函数。此外，还包括了一些常见的操作，如登录、登出、设置用户属性、跟踪事件等。根据您的具体需求，您可以进一步扩展和完善这些功能。