Flutter用户推荐跟踪插件referral_tracker的使用

本文档将介绍如何在Flutter项目中使用referral_tracker插件来实现用户推荐跟踪功能。此插件支持iOS和Android平台，并帮助开发者轻松追踪用户推荐来源。

使用步骤

1. 添加依赖

首先，在pubspec.yaml文件中添加referral_tracker依赖：

dependencies:
  referral_tracker: ^1.0.0

然后运行以下命令以更新依赖项：

flutter pub get

2. 初始化插件

在应用启动时初始化referral_tracker插件。通常可以在main.dart文件中完成初始化。

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

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

  runApp(MyApp());
}

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

3. 设置推荐来源

当用户通过推荐链接安装应用时，可以通过设置推荐来源来追踪推荐人。

Future<void> setReferralSource(String source) async {
  try {
    await ReferralTracker.setSource(source);
    print('推荐来源已成功设置为: $source');
  } catch (e) {
    print('设置推荐来源失败: $e');
  }
}

调用此方法时，可以传入推荐人的标识符（如用户名或唯一ID）。

4. 获取推荐来源

在应用启动后，可以通过getReferralSource方法获取推荐来源。

Future<void> fetchReferralSource() async {
  try {
    final source = await ReferralTracker.getSource();
    if (source != null) {
      print('当前用户的推荐来源是: $source');
    } else {
      print('当前用户没有推荐来源');
    }
  } catch (e) {
    print('获取推荐来源失败: $e');
  }
}

5. 示例代码整合

以下是一个完整的示例代码，展示如何集成推荐跟踪功能：

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

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

  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? _referralSource;

  [@override](/user/override)
  void initState() {
    super.initState();
    // 在页面加载时获取推荐来源
    fetchReferralSource();
  }

  Future<void> fetchReferralSource() async {
    try {
      final source = await ReferralTracker.getSource();
      setState(() {
        _referralSource = source;
      });
    } catch (e) {
      print('获取推荐来源失败: $e');
    }
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('推荐跟踪示例'),
      ),
      body: Center(
        child: Column(
          mainAxisAlignment: MainAxisAlignment.center,
          children: [
            Text(
              '当前用户的推荐来源是:',
              style: TextStyle(fontSize: 18),
            ),
            SizedBox(height: 10),
            Text(
              _referralSource ?? '未找到',
              style: TextStyle(fontSize: 24, fontWeight: FontWeight.bold),
            ),
            SizedBox(height: 20),
            ElevatedButton(
              onPressed: () {
                // 模拟设置推荐来源
                setReferralSource('user12345');
              },
              child: Text('模拟设置推荐来源'),
            )
          ],
        ),
      ),
    );
  }
}