BoNiuCore 1.0.1

BoNiuCore 1.0.1

×

由 li199256 维护。

 
依赖
SDWebImage>= 0
Alamofire>= 0
 

BoNiuCore 1.0.1

  • 作者：
  • ZHAO

接入方式

项目地址 (https://github.com/zhao560/UTMSDK)

要使用 CocoaPods 将 UTMSDK 集成到您的 Xcode 项目中，请在您的 Podfile 中指定

由于 SDK 依赖于 Alamofire 和 SDWebImage，如果手动导入 SDK，请自行导入。

pod 'UTMSDK', '~> 1.0.2'

Requirements

  • iOS 10.0+ / macOS 10.12+ / tvOS 10.0+ / watchOS 3.0+
  • Xcode 11+
  • Swift 5.1+

How To Use

SDK 需要在 AppDelegate 的方法 - (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions 里进行初始化（注意需要放在设置 Window 之前）

  • Objective-C
#import <WDUTMSDK/WDUTMSDK-Swift.h>

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
  
    /**
     *  初始化
     * @param channel 渠道
     * @param app 需要传入appName(后台提供)  搏牛产品 加入bn_前缀
     */
    [WDTracker setupWithChannel:@"AppStore" app: [NSString stringWithFormat:@"bn_%@", appName]];
}
  • Swift
import WDUTMSDK

func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
    /**
     *  初始化
     * @param channel 渠道
     * @param app 需要传入appName(后台提供)  搏牛产品 加入bn_前缀
     */
    WDTracker.setup(channel: "AppStore", app: appName)
  	// 是否开启debug模式
    WDTracker.debug = true
}

上报用户id

需要手动上传用户id

接入时请联系后台，通过后台接口获取 dataid

// 自定义上传用户id 需要调用后台接口获取 dataid  接入时请联系后台
[WDTracker fire:@"user.dataid" extra:@{@"dataid" : @"123"}];

广告展示成功埋点

广告展示成功后需要手动埋点 广告类型 csj - 穿山甲 ylh - 优量汇 zhike - 直客

接入的是RhinoXSDK搏牛广告sdk 可在代理中 获取广告类型 advertiserNo

// 开屏广告-穿山甲
[WDTracker fire:@"event.splashAd" extra:@{@"type" : @"csj"}];
// 激励视频-广点通
[WDTracker fire:@"event.rewardedVideoAd" extra:@{@"type" : @"ylh"}];

自动埋点

默认地，SDK会自动收集必要信息以及点击事件。已实现的自动埋点包括

  • 用户首次进入，会上报包含设备信息的一条数据

    image-20201110141603507

  • 如果用户进入页面，会上报包含访问的信息

    image-20201110141652589

  • 如果用户点击按钮，会上报包含点击信息的一条数据

  • 其他事件

    pipe.open  // 打开App时
pipe.close // 关闭App是
pipe.active // 从后台唤醒App时
pipe.deactive // 将App切换到后台时

自定义事件

如果需要上报自定义的埋点事件和数据, 例如在分享成功后上报事件,可以通过以下方法

  • key: 事件的名称, 需要唯一、易识别

  • extra: 事件相关联的数据信息, 例如订单号、金额等

WDTracker.fire("xxx.xxx", extra: { 
    "key": "value" 
})

设置页面标识

  • utm_model: 页面模块名, 默认均为空, 一般可根据业务类型划分模块
  • utm_name: 页面标识名, 默认为“类型标题”, 例如 WDHonePageViewController首页 , 各页面可通过设置该属性进行自定义
  • utm_ignore: 忽略该页面采集, 一般只用在部分业务无关且不需要采集事件的ViewController上, 例如启动页
// UTMSDK为UIViewController添加了3个属性满足页面标识的各种需求
extension UIViewController {
  	// 页面模块
    @objc public var utm_model: String
  	// 页面标识
    @objc public var utm_name: String
  	// 忽略页面跳转埋点
    @objc public var utm_ignore: String
}