Flutter插件lumen的使用方法

数据驱动的自动化消息推送用于增长和留存。

Lumen

Lumen Flutter 插件允许您无缝地识别和跟踪应用中的用户属性和事件。此外还有其他好处。

特性

• 识别用户
• 跟踪用户事件
• 更新用户属性

开始使用

• 设置您的 Lumen 账户。
• 获取您的 API 密钥。

请按照以下步骤获取您的 API 密钥：

• 登录到您的 Lumen 仪表板。
• 导航至设置。
• 选择 API 密钥选项卡以查看并复制您的密钥。

• 安装插件

flutter pub add lumen

使用方法

初始化插件

const lumenApiKey = “<< your-api-key >>”;

void main() { Lumen.init(lumenApiKey);

runApp(const MyApp()); }

<h4 id="identify-a-user">识别用户</h4>
```dart
final identifyData = IdentifyData(
    email: "johndoe@example.com", // 必填
    first_name: "john",
    last_name: "doe",
    phone_number: "0123456789",
    device_id: "device ID");

Lumen.identify("&lt;&lt; user-identifier &gt;&gt;", identifyData);

跟踪事件

识别用户后，您可以捕获他们的行为，例如“产品点击”或“产品查看”，以及其他自定义属性。

Lumen.track("<< user-identifier >>", “<< event-name >>”, customTrackProperties);

<h2 id="contributing">贡献指南</h2>
<ol>
<li>fork 项目</li>
<li>克隆您的 fork (<code>git clone git@github.com:MY_USERNAME/lumen-flutter.git &amp;&amp; cd lumen-flutter</code>)</li>
<li>创建新功能分支 (<code>git checkout -b my-new-feature</code>)</li>
<li>提交更改 (<code>git commit -am 'feat: 添加一些功能'</code>)</li>
<li>推送分支 (<code>git push origin my-new-feature</code>)</li>
<li>创建新的拉取请求</li>
</ol>

### 完整示例 Demo

以下是完整的示例代码：

```dart
import 'package:flutter/material.dart';
import 'package:lumen/lumen.dart';

const lumenApiKey = "&lt;&lt; your-api-key &gt;&gt;";

void main() {
  Lumen.init(lumenApiKey); // 初始化 Lumen 插件

  runApp(const MyApp());
}

class MyApp extends StatelessWidget {
  const MyApp({Key? key}) : super(key: key);

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Lumen Example',
      home: MyHomePage(),
    );
  }
}

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

class _MyHomePageState extends State<MyHomePage> {
  final TextEditingController _emailController = TextEditingController();
  final TextEditingController _firstNameController = TextEditingController();
  final TextEditingController _lastNameController = TextEditingController();
  final TextEditingController _phoneNumberController = TextEditingController();

  void _identifyUser() {
    final identifyData = IdentifyData(
        email: _emailController.text,
        first_name: _firstNameController.text,
        last_name: _lastNameController.text,
        phone_number: _phoneNumberController.text,
        device_id: "device ID");

    Lumen.identify("user-identifier", identifyData); // 识别用户
  }

  void _trackEvent() {
    final customTrackProperties = {"value": "1233"};

    Lumen.track("user-identifier", "event-name", customTrackProperties); // 跟踪事件
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('Lumen Example'),
      ),
      body: Padding(
        padding: const EdgeInsets.all(16.0),
        child: Column(
          children: [
            TextField(
              controller: _emailController,
              decoration: InputDecoration(labelText: 'Email'),
            ),
            TextField(
              controller: _firstNameController,
              decoration: InputDecoration(labelText: 'First Name'),
            ),
            TextField(
              controller: _lastNameController,
              decoration: InputDecoration(labelText: 'Last Name'),
            ),
            TextField(
              controller: _phoneNumberController,
              decoration: InputDecoration(labelText: 'Phone Number'),
            ),
            SizedBox(height: 20),
            ElevatedButton(
              onPressed: _identifyUser,
              child: Text('Identify User'),
            ),
            SizedBox(height: 20),
            ElevatedButton(
              onPressed: _trackEvent,
              child: Text('Track Event'),
            ),
          ],
        ),
      ),
    );
  }
}