快速集成

Flutter最新version请参考gravity-flutter库

dependencies:
  gravity_engine_flutter_sdk: ^version

Android配置

• 在 Project 级别的 build.gradle 文件中添加如下配置依赖：

maven("https://nexus.gravity-engine.com/repository/maven-releases/")
maven("https://nexus.gravity-engine.com/repository/maven-snapshots/")
maven("https://developer.huawei.com/repo")
maven("https://developer.hihonor.com/repo")

2.配置并启动 SDK

请参考以下代码来进行 SDK 的初始化，建议在能够获取到用户唯一 ID，如Android 设备的oaid、iOS 设备的IDFV时，尽早的进行初始化。

import 'package:gravity_engine_flutter_sdk/GravityEngineSDK.dart';
GravityEngineSDK.startGravityEngine(
      accessToken // 项目通行证，在：网站后台-->设置-->应用列表中找到Access Token列 复制（首次使用可能需要先新增应用）
    );
//开启自动采集
GravityEngineSDK.enableAutoTrack([AUTO_TRACK_EVENTS.APP_ALL])

3.初始化

3.1 添加 att 弹窗描述（iOS配置）

需要先在 info.plist 文件中添加跟踪权限请求描述文字，如果不添加会导致  idfa  获取失败！描述文字内容仅作示例，具体请联系您的产品同学确认！

<key>NSUserTrackingUsageDescription</key>
<string>此标识符将用于向您推荐个性化广告。</string>

3.2 调用引力初始化

在可以获取到用户唯一性信息时调用本方法，推荐首次安装启动时调用，后续其他方法均需在本方法回调成功之后才可正常使用。

Android初始化

GravityEngineSDK.initialize(clientId,nickname,enableSyncAttribution,channel,MyCallBack());
class MyCallBack extends InitializeCallback {
  @override
  void onSuccess(Map<Object?, Object?>? responseJson) {
    // 成功回调的处理
    print("Initialization succeeded with response: $responseJson");
  }

  @override
  void onFailed(String? errorMsg) {
    // 失败回调的处理
    print("Initialization failed with error: $errorMsg");
  }
}

参数说明：

GravityEngineSDK.initializeIOS(ENABLE_ASA,USER_CLIENT_ID,USER_CAID1_MD5,USER_CAID2_MD5,ENABLE_SYNC_ATTRIBUTION,CHANNEL,MyCallBack());
class MyCallBack extends InitializeCallback {
  @override
  void onSuccess(Map<Object?, Object?>? responseJson) {
    // 成功回调的处理
    print("Initialization succeeded with response: $responseJson");
  }

  @override
  void onFailed(String? errorMsg) {
    // 失败回调的处理
    print("Initialization failed with error: $errorMsg");
  }
}

 参数说明：

static Future<void> trackRegisterEvent();

GravityEngineSDK.trackRegisterEvent();

 static Future<String?> trackPayEvent( int payAmount,String payType,String orderId,String payReason,String payMethod,);

 GravityEngineSDK.trackPayEvent(300, "CNY","order_id","月卡", "支付宝");

static Future<void> trackAdShowEvent(String adUnionType,String adPlacementId,String adSourceId,String adType,String adnType,double ecpm);

GravityEngineSDK.trackAdShowEvent("topon","placement_id","ad_source_id","reward","csj",1.0,);

static Future<void> trackWithdrawEvent(int payAmount,String withPayType,String withOrderId,String payReason,String payMethod);

GravityEngineSDK.trackWithdrawEvent(300, "CNY", "order_id_xxxx1", "用户首次提现","支付宝");

6.接入验证