Flutter游戏数据分析插件gameanalytics_sdk的使用

GA-SDK-FLUTTER

GameAnalytics SDK for Flutter。

文档位于 此处。

如果您在SDK使用过程中遇到任何问题或有反馈，请联系我们的客服团队 此处。

ℹ️

Flutter SDK 支持 iOS、Android 和 Web 平台。

示例代码

以下是使用 gameanalytics_sdk 插件的一个完整示例：

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

import 'package:flutter/services.dart';
import 'package:gameanalytics_sdk/gameanalytics.dart';

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

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

class _MyAppState extends State<MyApp> {
  [@override](/user/override)
  void initState() {
    super.initState();

    // 启用信息日志和详细日志
    GameAnalytics.setEnabledInfoLog(true);
    GameAnalytics.setEnabledVerboseLog(true);

    // 配置可用的自定义维度
    GameAnalytics.configureAvailableCustomDimensions01(["ninja", "samurai"]);
    GameAnalytics.configureAvailableCustomDimensions02(["whale", "dolphin"]);
    GameAnalytics.configureAvailableCustomDimensions03(["horde", "alliance"]);

    // 配置可用资源货币和资源类型
    GameAnalytics.configureAvailableResourceCurrencies(["gems", "gold"]);
    GameAnalytics.configureAvailableResourceItemTypes(["boost", "lives"]);

    // 配置构建版本
    GameAnalytics.configureBuild("0.1.0");
    GameAnalytics.configureAutoDetectAppVersion(true);

    // 初始化 SDK
    GameAnalytics.initialize(
        "c6cfc80ff69d1e7316bf1e0c8194eda6",
        "e0ae4809f70e2fa96916c7060f417ae53895f18d"
    );

    // 设置自定义维度
    GameAnalytics.setCustomDimension01("ninja");
    GameAnalytics.setCustomDimension02("dolphin");
    GameAnalytics.setCustomDimension03("alliance");

    // 添加商业事件
    GameAnalytics.addBusinessEvent({
      "currency": "USD",
      "amount": 99,
      "itemType": "weapons",
      "itemId": "shotgun",
      "cartType": "end_of_level"
    });

    GameAnalytics.addBusinessEvent({
      "currency": "USD",
      "amount": 99,
      "itemType": "weapons",
      "itemId": "shotgun",
      "cartType": "end_of_level",
      "receipt": "test_receipt",
      "signature": "test_signature"
    });

    // 添加资源事件
    GameAnalytics.addResourceEvent({
      "flowType": GAResourceFlowType.Source,
      "currency": "gems",
      "amount": 100,
      "itemType": "lives",
      "itemId": "5lives"
    });

    // 添加进度事件
    GameAnalytics.addProgressionEvent({
      "progressionStatus": GAProgressionStatus.Start,
      "progression01": "world01",
      "progression02": "level01",
      "progression03": "phase01",
      "itemId": "5lives"
    });

    GameAnalytics.addProgressionEvent({
      "progressionStatus": GAProgressionStatus.Complete,
      "progression01": "world01",
      "progression02": "level01",
      "progression03": "phase01",
      "score": 666
    });

    // 添加设计事件
    GameAnalytics.addDesignEvent({"eventId": "some:event"});
    GameAnalytics.addDesignEvent({"eventId": "some:other:event", "value": 666});

    // 添加错误事件
    GameAnalytics.addErrorEvent({
      "severity": GAErrorSeverity.Error,
      "message": "This is an error message!!!"
    });

    // 添加广告事件
    GameAnalytics.addAdEvent({
      "adAction": GAAdAction.Show,
      "adType": GAAdType.Interstitial,
      "adSdkName": "mopub",
      "adPlacement": "end_of_level"
    });
  }

  Future<void> printRemoteConfigsInfo() async {
    // 获取远程配置内容
    String content = await GameAnalytics.getRemoteConfigsContentAsString() ?? "";
    print("content=" + content);

    // 检查远程配置是否已准备好
    bool isReady = await GameAnalytics.isRemoteConfigsReady();
    print("isReady=" + isReady.toString());

    // 获取远程配置值
    String value = await GameAnalytics.getRemoteConfigsValueAsString(
            "unicode_key", "null") ??
        "null";
    print("value=" + value);
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: const Text('插件示例应用'),
        ),
        body: Center(
          child: TextButton(
              child: Text('测试'),
              onPressed: () {
                printRemoteConfigsInfo();
              }),
        ),
      ),
    );
  }
}