Flutter点击事件处理插件clickzinfluttersdk的使用

Additional information

Clickzin Flutter Android 跟踪 SDK

Packages used with version:

android_play_install_referrer: ^0.2.1
shared_preferences: ^2.0.13
http: ^0.13.4

Steps to integrate SDK

Step 1: Add dependency in pubspec.yaml

在项目的 pubspec.yaml 文件中添加以下依赖项：

clickzinfluttersdk: <latest version>

Step 2: 在 main.dart 中添加导入

在 main.dart 文件中导入 Clickzin SDK：

import 'package:clickzinfluttersdk/clickzinfluttersdk.dart';

Step 3: 在第一个 Widget 中创建 ClickzinTracker 实例，并在 initState 中调用 startTracking 方法

通常情况下，初始事件名称为 "install"。

var appKey = "As provided by your marketing partners."; // 替换为您营销合作伙伴提供的应用密钥
final ClickzinTracker _clickzinTracker = ClickzinTracker(appKey, true); // 初始化 ClickzinTracker

[@override](/user/override)
void initState() {
  super.initState();
  _clickzinTracker.startTracking("install"); // 开始跟踪初始事件
}

Step 4: 在相应的事件 Widget 中跟踪事件

例如，当用户完成注册、购买或登录时，可以调用 trackEvent 方法来跟踪这些事件。

final ClickzinTracker _clickzinTracker = ClickzinTracker(appKey, true); // 确保在需要跟踪事件的 Widget 中初始化 ClickzinTracker

void onRegisterSuccess() {
  _clickzinTracker.trackEvent("register"); // 跟踪注册事件
}

void onSaleSuccess() {
  _clickzinTracker.trackEvent("sale"); // 跟踪购买事件
}

void onLoginSuccess() {
  _clickzinTracker.trackEvent("login"); // 跟踪登录事件
}

完整示例 Demo

以下是一个完整的示例，展示如何在 Flutter 应用中集成和使用 Clickzin SDK 来跟踪事件：

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

void main() {
  runApp(MyApp());
}

class MyApp extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: HomeScreen(),
    );
  }
}

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

class _HomeScreenState extends State<HomeScreen> {
  var appKey = "As provided by your marketing partners.";
  final ClickzinTracker _clickzinTracker = ClickzinTracker(appKey, true);

  [@override](/user/override)
  void initState() {
    super.initState();
    _clickzinTracker.startTracking("install"); // 跟踪安装事件
  }

  void handleRegister() {
    _clickzinTracker.trackEvent("register"); // 跟踪注册事件
    ScaffoldMessenger.of(context).showSnackBar(SnackBar(content: Text("注册成功！")));
  }

  void handleLogin() {
    _clickzinTracker.trackEvent("login"); // 跟踪登录事件
    ScaffoldMessenger.of(context).showSnackBar(SnackBar(content: Text("登录成功！")));
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text("Clickzin SDK 示例"),
      ),
      body: Center(
        child: Column(
          mainAxisAlignment: MainAxisAlignment.center,
          children: [
            ElevatedButton(
              onPressed: handleRegister,
              child: Text("模拟注册事件"),
            ),
            SizedBox(height: 20),
            ElevatedButton(
              onPressed: handleLogin,
              child: Text("模拟登录事件"),
            ),
          ],
        ),
      ),
    );
  }
}