SkarbSDK

0.4.13

bitlica/SkarbSDK-iOS

What's New

0.4.13

2021-04-13T08:14:44Z
  • Supports SPM

Introduction

SkarbSDK is a framework that makes you happier. It automatically reports:

  1. install event - during SDK initialization phase.
  2. subscription event - this event could be reported manually as well by sendPurchase(), though it's not recommended way.

In addition, you could enrich these events with features obtained from the traffic source by explicit call of sendSource() method. And if you're interesting in split testing inside an app take a look on sendTest() method.

Installation

CocoaPods

CocoaPods is a dependency manager for Cocoa projects. For usage and installation instructions, visit their website. To integrate SkarbSDK into your Xcode project using CocoaPods, specify it in your Podfile:

pod 'SkarbSDK'

Swift Package Manager

The Swift Package Manager is a tool for automating the distribution of Swift code and is integrated into the swift compiler.

Once you have your Swift package set up, adding SkarbSDK as a dependency is as easy as adding it to the dependencies value of your Package.swift.

dependencies: [
    .package(url: "https://github.com/bitlica/SkarbSDK.git", .upToNextMajor(from: "0.4.13"))
]

Usage

Initialization

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)
    }
}

Params:

clientId You could get it in your account dashboard.

isObservable Automatically sends all events about purchases that are in your app. If you want to send a purchase event manually you should set this param to false and see Send purchase event section.

Send features

Using for loging the attribution.

import SkarbSDK

SkarbSDK.sendSource(broker: SKBroker,
                    features: [String: Any])

Params:

broker indicates what service you use for attribution. There are three predefined brokers: facebook, searchads, appsflyer. Also might be used any value - SKBroker.custom(String).

features. See features paragraphe, supported features has a string type, not supported are ignored silently.

Send purchase event

You have to use this call if isObservable during initialization is false

import SkarbSDK

SkarbSDK.sendPurchase(productId: String,
                      price: Float,
                      currency: String)													 

Params:

productId It’s a SKProduct.productIdentifier of purchased product

price It’s a SKProduct.price

currency It’s SKProduct.priceLocale.currencyCode

Example for Appsflyer:

In delegate mothod:

import SkarbSDK

func onConversionDataSuccess(_ conversionInfo: [AnyHashable : Any]) {
    SkarbSDK.sendSource(broker: .appsflyer, features: conversionInfo)
}

A/B testing

import SkarbSDK

SkarbSDK.sendTest(name: String,
                  group: String)

Params:

name Name of A/B test

group Group name of A/B test. For example: control group, B, etc.

License

MIT

Description

  • Swift Tools 5.3.0
View More Packages from this Author

Dependencies

Last updated: Tue Oct 04 2022 20:56:07 GMT-0500 (GMT-05:00)