Flutter AdSpark Pro 技术文档

【免费下载链接】flutter_adspark 🔥🔥🔥 Flutter 版本的 AdSpark (穿山甲、巨量引擎、增长参谋、巨量广告、归因上报、广告监测) 项目地址: https://gitcode.com/FlutterAdss/flutter_adspark

1. 安装指南

1.1 环境要求

• Flutter SDK 3.0.0 或更高版本
• iOS 11.0+ / Android 5.0+ 系统支持
• 已注册穿山甲/巨量引擎开发者账号

1.2 依赖添加

在项目pubspec.yaml文件中添加依赖：

dependencies:
  flutter_adspark: ^3.7.1

运行命令安装依赖：

flutter pub get

2. 项目使用说明

2.1 初始化配置

在应用启动时初始化SDK：

import 'package:flutter_adspark/flutter_adspark.dart';

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  await FlutterAdSpark.init(
    appId: "您的应用ID",
    channel: "默认渠道",
    debug: true, // 调试模式
  );
  runApp(MyApp());
}

2.2 基础功能使用

用户行为上报：

// 用户注册事件
FlutterAdSpark.onRegister(userId: "123456");

// 支付事件上报
FlutterAdSpark.onPayment(
  orderId: "order_123",
  amount: 100,
  currency: "CNY",
  paymentType: "alipay"
);

// 自定义事件
FlutterAdSpark.onEvent(
  eventName: "custom_event",
  params: {"key1": "value1"}
);

3. API使用文档

3.1 核心API

初始化方法

static Future<void> init({
  required String appId,
  String? channel,
  bool debug = false,
})

事件上报API

// 激活事件
static void onActivate()

// 用户登录
static void onLogin(String userId)

// 支付上报
static void onPayment({
  required String orderId,
  required double amount,
  String currency = "CNY",
  String? paymentType,
  Map<String, dynamic>? params,
})

3.2 可视化调试助手

通过FlutterAdSpark.showDebugView()方法可调出可视化调试面板，包含：

• 实时事件日志
• 网络请求监控
• 数据上报状态
• 测试工具集

4. 项目安装方式

4.1 标准安装流程

1. 添加pub依赖
2. 执行flutter pub get
3. 配置Android/iOS原生环境
4. 初始化SDK

4.2 平台配置

Android配置

在AndroidManifest.xml中添加权限：

<uses-permission android:name="android.permission.INTERNET"/>
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/>

iOS配置

在Info.plist中添加：

<key>NSAppTransportSecurity</key>
<dict>
  <key>NSAllowsArbitraryLoads</key>
  <true/>
</dict>

4.3 注意事项

1. 确保测试环境与生产环境使用不同的appId
2. 用户敏感信息需脱敏处理
3. 建议在WiFi环境下进行调试
4. 正式发布前关闭debug模式

【免费下载链接】flutter_adspark 🔥🔥🔥 Flutter 版本的 AdSpark (穿山甲、巨量引擎、增长参谋、巨量广告、归因上报、广告监测) 项目地址: https://gitcode.com/FlutterAdss/flutter_adspark