简介
SkarbSDK 是一个使您更快乐的框架。它自动报告
- 安装事件 - 在 SDK 初始化阶段。
- 订阅事件 - 该事件也可以通过
sendPurchase()
手动报告,但不是推荐的做法。
此外,您可以通过显式调用 sendSource()
方法来使用从流量源获得的功能来丰富这些事件。如果您对应用内的拆分测试感兴趣,请查看 sendTest()
方法。
安装
CocoaPods
CocoaPods 是一个 Cocoa 项目的依赖管理器。有关使用和安装说明,请访问他们的网站。要使用 CocoaPods 将 SkarbSDK 集成到您的 Xcode 项目中,请在 Podfile
中指定它。
pod 'SkarbSDK', '~> 0.6'
Swift包管理器
Swift包管理器(Swift Package Manager)是一个用于自动分发Swift代码的工具,并集成到swift
编译器中。
一旦设置了您的Swift包,将SkarbSDK作为依赖项添加就像将其添加到Package.swift
中的dependencies
值一样简单。
dependencies: [
.package(url: "https://github.com/bitlica/SkarbSDK.git", .upToNextMajor(from: "0.6.16"))
]
使用方法
初始化
import SkarbSDK
class AppDelegate: UIResponder, UIApplicationDelegate {
var window: UIWindow?
func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplicationLaunchOptionsKey: Any]?) -> Bool {
SkarbSDK.initialize(clientId: "YOUR_CLIENT_ID", isObservable: true, deviceId: "YOUR_DEVICE_ID")
}
}
参数
clientId
您可以在账户仪表板上获取。
isObservable
自动发送您应用中所有关于购买的事件。如果您要手动发送购买事件,应将此参数设置为false
并参考发送购买事件
部分。默认值为true
。
deviceId
如果您想使用自己生成的deviceId,默认值为nil
。
发送功能
用于日志记录归因。
import SkarbSDK
SkarbSDK.sendSource(broker: SKBroker,
features: [String: Any],
brokerUserID: String?)
参数
broker
表示您用于归因的服务。有三个预定义的经纪人:facebook
、searchads
、appsflyer
。还可以使用任何值 - SKBroker.custom(String)
。
features
。参见功能段落,受支持的功能具有字符串类型,不受支持的功能将静默忽略。
brokerUserID
。如果要使用postbacks,请使用该SKBroker的唯一userID。例如,对于Appsflyer - AppsFlyerLib.shared().getAppsFlyerUID()
Appsflyer示例
代理方法
import SkarbSDK
func onConversionDataSuccess(_ conversionInfo: [AnyHashable : Any]) {
SkarbSDK.sendSource(broker: .appsflyer,
features: conversionInfo,
brokerUserID: AppsFlyerLib.shared().getAppsFlyerUID())
}
A/B测试
import SkarbSDK
SkarbSDK.sendTest(name: String,
group: String)
参数
name
A/B测试名称
group
A/B 测试的分组名称。例如:对照组、B组等。
IDFA
SkarbSDK 自动收集 IDFA。如果您想禁用它,请在 SkarbSDK.initialize()
方法之前设置为 false
。默认值是 true
import SkarbSDK
SkarbSDK.automaticCollectIDFA = false
您还可以在从 ATTrackingManager.requestTrackingAuthorization()
获取 status
后发送 idfa,如果 status
是 .authorized
,则从 ASIdentifierManager.shared().advertisingIdentifier.uuidString
获取 idfa 并使用此方法
SkarbSDK.sendIDFA(idfa: String?)
日志记录
如果您想查看 SkarbSDK 的错误和警告,请在 SkarbSDK.initialize()
方法之前设置为 true
。默认值是 false
import SkarbSDK
SkarbSDK.isLoggingEnabled = true