Flutter应用性能追踪插件appsflyer_sdk的使用

概述

为了提供最佳支持，如果您遇到任何问题，请发送邮件至support@appsflyer.com，并请务必提供您的AppsFlyer注册（账户）邮箱、应用ID、复现步骤、日志、代码片段以及任何其他相关信息。

适用平台

• Android AppsFlyer SDK v6.15.2
• iOS AppsFlyer SDK v6.15.3

重要更新与变更

从版本 6.x.x 开始，有以下重大变更：

• API变更：

  • trackEvent -> logEvent
  • stopTracking -> stop
  • validateAndTrackInAppPurchase -> validateAndLogInAppPurchase
  • validateAndLogInAppPurchase -> validateAndLogInAppIosPurchase / validateAndLogInAppAndroidPurchase

• 移除和废弃API：

  • setPushNotification 在iOS上不再工作，改用 sendPushNotificationData
  • 移除了 enableLocationCollection
  • setSharingFilter 和 setSharingFilterForAllPartners 已被废弃，改用 setSharingFilterForPartners

• 回调机制：

  • ConversionData 和 OnAppOpenAttribution 改为基于回调而非流

• 权限管理：

  • Android API 33及以上需要声明 com.google.android.gms.permission.AD_ID 权限来收集广告ID。如果您的应用面向儿童用户，则需要撤销此权限以符合Google的数据政策。

使用指南

添加SDK到项目

参考官方文档 Adding the SDK to your project

初始化SDK

初始化是使用AppsFlyer的第一步，详情见 Initializing the SDK

记录应用内事件

通过记录用户行为事件来分析应用表现，详见 In-app Events

深度链接处理

实现跨平台深度链接功能，参阅 Deep Linking

高级API

探索更多高级特性，如推送通知、用户属性等，查阅 Advanced APIs

测试集成

确保正确配置后进行充分测试，指导文档在 Testing the integration

API列表

完整API列表及说明可查看 APIs

示例程序

您可以参考官方提供的示例应用程序，了解如何实际应用这些功能：Sample App

示例代码

下面是一个简单的Flutter项目结构，展示了如何集成和使用appsflyer_sdk：

import 'dart:async';
import 'package:appsflyer_sdk/appsflyer_sdk.dart';
import 'package:flutter/material.dart';
import 'package:flutter_dotenv/flutter_dotenv.dart';

Future<void> main() async {
  await dotenv.load(fileName: '.env');
  runApp(MyApp());
}

class MyApp extends StatelessWidget {
  final AppsFlyerOptions appsFlyerOptions = AppsFlyerOptions(
    devKey: 'YOUR_DEV_KEY',
    appId: 'YOUR_APP_ID',
    isDebug: true,
  );

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: MainPage(),
    );
  }
}

class MainPage extends StatefulWidget {
  @override
  _MainPageState createState() => _MainPageState();
}

class _MainPageState extends State<MainPage> {
  AppsFlyerSdk? appsFlyerSdk;

  @override
  void initState() {
    super.initState();
    initPlatformState();
  }

  Future<void> initPlatformState() async {
    appsFlyerSdk = AppsFlyerSdk(widget.appsFlyerOptions);

    try {
      await appsFlyerSdk!.initSdk(
        registerConversionDataCallback: (data) {
          print("onInstallConversionData: $data");
        },
        registerOnAppOpenAttributionCallback: (data) {
          print("onAppOpenAttribution: $data");
        },
      );
    } catch (e) {
      print("Error initializing SDK: $e");
    }
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('Appsflyer Demo'),
      ),
      body: Center(
        child: ElevatedButton(
          onPressed: () async {
            try {
              final response = await appsFlyerSdk!.logEvent(AFInAppEventType.purchase, {
                'af_price': '10.99',
                'af_currency': 'USD',
                'af_content_id': 'content_123',
              });
              print('Event logged successfully: $response');
            } catch (e) {
              print('Failed to log event: $e');
            }
          },
          child: Text('Log Purchase Event'),
        ),
      ),
    );
  }
}

在这个例子中，我们首先加载环境变量文件.env中的配置信息，然后创建一个包含必要参数的AppsFlyerOptions对象，并在应用启动时初始化SDK。此外，还定义了一个按钮用于触发模拟的应用内购买事件记录操作。这只是一个基础示例，具体实现可能根据您的需求有所不同。