Flutter广告跟踪与分析插件adjust_sdk的使用

Adjust SDK for Flutter 是 Adjust 公司为 Flutter 提供的广告跟踪和分析插件。通过这个插件，开发者可以轻松集成广告跟踪和用户行为分析功能到他们的 Flutter 应用中。详细的文档可以在 Adjust 开发者文档 中找到。

License

Adjust SDK for Flutter 遵循 MIT 许可证。

示例代码

以下是一个完整的示例 demo，展示了如何在 Flutter 应用中使用 adjust_sdk 插件进行广告跟踪和分析。

1. 添加依赖

首先，在你的 pubspec.yaml 文件中添加 adjust_sdk 依赖：

dependencies:
  flutter:
    sdk: flutter
  adjust_sdk: ^x.x.x # 请替换为最新版本号

然后运行 flutter pub get 来安装依赖。

2. 初始化 Adjust SDK

在应用启动时初始化 Adjust SDK，并设置相关回调函数。

import 'package:adjust_sdk/adjust.dart';
import 'package:adjust_sdk/adjust_attribution.dart';
import 'package:adjust_sdk/adjust_config.dart';
import 'package:flutter/material.dart';

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

class MyApp extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Flutter Demo',
      theme: ThemeData(
        primarySwatch: Colors.blue,
      ),
      home: MyHomePage(title: 'Flutter Demo Home Page'),
    );
  }
}

class MyHomePage extends StatefulWidget {
  MyHomePage({Key? key, this.title}) : super(key: key);

  final String? title;

  @override
  _MyHomePageState createState() => _MyHomePageState();
}

class _MyHomePageState extends State<MyHomePage> with WidgetsBindingObserver {
  bool _isSdkEnabled = true;

  @override
  void initState() {
    super.initState();
    WidgetsBinding.instance!.addObserver(this);
    initPlatformState();
  }

  @override
  void dispose() {
    WidgetsBinding.instance!.removeObserver(this);
    super.dispose();
  }

  void initPlatformState() async {
    AdjustConfig config = new AdjustConfig('YOUR_APP_TOKEN', AdjustEnvironment.sandbox);
    config.logLevel = AdjustLogLevel.verbose;

    config.attributionCallback = (AdjustAttribution attributionChangedData) {
      print('[Adjust]: Attribution changed!');
      // 处理归因数据
    };

    config.sessionSuccessCallback = (AdjustSessionSuccess sessionSuccessData) {
      print('[Adjust]: Session tracking success!');
      // 处理会话成功数据
    };

    config.sessionFailureCallback = (AdjustSessionFailure sessionFailureData) {
      print('[Adjust]: Session tracking failure!');
      // 处理会话失败数据
    };

    config.eventSuccessCallback = (AdjustEventSuccess eventSuccessData) {
      print('[Adjust]: Event tracking success!');
      // 处理事件成功数据
    };

    config.eventFailureCallback = (AdjustEventFailure eventFailureData) {
      print('[Adjust]: Event tracking failure!');
      // 处理事件失败数据
    };

    config.deferredDeeplinkCallback = (String? uri) {
      print('[Adjust]: Received deferred deeplink: $uri');
    };

    config.skanUpdatedCallback = (Map<String, String> skanUpdateData) {
      print('[Adjust]: Received SKAN update information!');
      // 处理 SKAN 更新信息
    };

    Adjust.initSdk(config);
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text(widget.title!),
      ),
      body: Center(
        child: Column(
          mainAxisAlignment: MainAxisAlignment.center,
          children: <Widget>[
            ElevatedButton(
              onPressed: () {
                Adjust.trackEvent(Util.buildSimpleEvent());
              },
              child: Text('Track Simple Event'),
            ),
            ElevatedButton(
              onPressed: () {
                Adjust.getAdid().then((adid) {
                  print('Adjust identifier: $adid');
                });
              },
              child: Text('Get Adjust Identifier'),
            ),
          ],
        ),
      ),
    );
  }
}

3. 定义事件

你可以定义不同类型的事件来跟踪用户的行为。例如，定义一个简单的事件：

class Util {
  static AdjustEvent buildSimpleEvent() {
    AdjustEvent event = new AdjustEvent('YOUR_EVENT_TOKEN');
    return event;
  }
}

4. 启用/禁用 SDK

你还可以根据需要启用或禁用 Adjust SDK：

setState(() {
  if (value == true) {
    Adjust.enable();
  } else {
    Adjust.disable();
  }
  _isSdkEnabled = value;
  print('Switch state = $_isSdkEnabled');
});

总结

通过上述步骤，你可以轻松地在 Flutter 应用中集成 Adjust SDK 进行广告跟踪和用户行为分析。更多详细的功能和配置可以参考 Adjust 官方文档。