Flutter插件mida的安装与使用

Mida.so - 服务端A/B测试和特性标记

这是用于与Mida平台集成的服务端A/B测试和特性标记代码。代码用Dart编写，可以在Flutter项目中使用。

前提条件

在使用此代码之前，请确保已设置以下内容：

• 在您的机器上安装了Flutter和Dart。
• 拥有Mida.so账户，并获取了项目密钥和实验密钥。

安装

1. 下载此插件。
2. 将以下命令添加到pubspec.yaml文件中以导入必要的依赖项：

dev_dependencies:
  mida:
    path: ../mida-core

运行flutter pub get以安装依赖项。

使用方法

要使用服务端A/B测试和特性标记代码，请按照以下步骤操作：

导入Mida包

在您的代码中导入Mida包：

import 'package:mida/mida.dart';

创建Mida实例

通过提供您的Mida项目密钥创建Mida类的实例：

final mida = Mida(publicKey: 'YOUR_PROJECT_KEY');

A/B测试

1. 使用getExperiment方法为用户检索实验的当前版本。您需要提供实验密钥和用户的唯一ID（distinct ID）：

final version = await mida.getExperiment(
  experimentKey: 'EXPERIMENT_KEY',
  distinctId: 'USER_DISTINCT_ID',
);

if (version == 'Control') {
  // 处理控制逻辑
}

if (version == 'Variant 1') {
  // 处理变体1逻辑
}

// 根据您创建的变体数量
if (version == 'Variant 2') {
  // 处理变体2逻辑
}

1. 使用setEvent方法记录用户的事件。您需要提供事件名称和用户的唯一ID：

final event = await mida.setEvent(
  eventName: 'EVENT_NAME',
  distinctId: 'USER_DISTINCT_ID',
);

用户属性

1. 使用setAttribute方法为特定用户设置属性。您需要提供用户的唯一ID和包含属性键值对的对象：

final track = await mida.setAttribute(
  properties: {'gender': 'male', 'company_name': 'Apple Inc'},
  distinctId: 'USER_DISTINCT_ID',
);

API引用

Mida(projectKey, options)

• projectKey: （必需）您的Mida项目密钥。
• userId: （可选）默认用户ID。

getExperiment(experimentKey, distinctId)

• experimentKey: （必需）您想要获取版本的实验密钥。
• distinctId: （可选）用户的唯一ID（不同于默认用户ID）。
• 返回一个解析为实验版本的响应。

setEvent(eventName, distinctId)

• eventName: （必需）您想要记录的事件名称。
• distinctId: （可选）用户的唯一ID（不同于默认用户ID）。
• 返回一个解析为事件成功记录的响应。

setAttribute(distinctId, properties)

• properties: （必需）包含属性键值对的对象。
• distinctId: （可选）用户的唯一ID（不同于默认用户ID）。
• 返回一个解析为属性成功设置的响应。

示例代码

以下是一个完整的示例代码，展示如何使用mida插件进行A/B测试和设置用户属性：

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

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

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

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

class _HomePageState extends State<HomePage> {
  String version = 'Loading...';

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

  Future<void> initMida() async {
    final mida = Mida(publicKey: 'YOUR_PROJECT_KEY');

    // 获取实验版本
    final result = await mida.getExperiment(
      experimentKey: 'EXPERIMENT_KEY',
      distinctId: 'USER_DISTINCT_ID',
    );

    setState(() {
      version = result;
    });

    // 设置用户属性
    await mida.setAttribute(
      properties: {'gender': 'male', 'company_name': 'Apple Inc'},
      distinctId: 'USER_DISTINCT_ID',
    );

    // 记录事件
    await mida.setEvent(
      eventName: 'APP_OPENED',
      distinctId: 'USER_DISTINCT_ID',
    );
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('Mida Plugin Example'),
      ),
      body: Center(
        child: Text('Experiment Version: $version'),
      ),
    );
  }
}