LyticsSDK 0.0.1

LyticsSDK 0.0.1

×

由Rae Eversmann维护。

LyticsSDK 0.0.1

Lytics iOS SDK

安装

您可以通过将Lytics SDK作为包依赖项添加到Xcode项目中来添加它。

  1. 从文件菜单中选择添加包...
  2. 在包存储库URL文本字段中输入https://github.com/lytics/ios-sdk然后单击添加包
  3. 将Lytics包产品添加到您的应用程序目标

使用

配置

在使用Lytics SDK之前，您必须使用您的API密钥对其进行初始化。如果您使用的是AppDelegate，建议您在AppDelegate.application(_:didFinishLaunchingWithOptions:)中执行此操作

import Lytics
import UIKit

class AppDelegate: NSObject, UIApplicationDelegate {
    func application(
        _ application: UIApplication,
        didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?
    ) -> Bool {
        Lytics.shared.start(apiToken: "YOUR-VALID-LYTICS-API-TOKEN") { configuration in
            ...
        }

        return true
    }
}

如果您使用的是SwiftUI，您可以在App初始化器中初始化SDK

import Lytics
import SwiftUI

@main
struct MyApp: App {
    init() {
        Lytics.shared.start(apiToken: "YOUR-VALID-LYTICS-API-TOKEN") { configuration in
            ...
        }
    }

    var body: some Scene {
        ...
    }
}

发送数据

Lytics事件方法通用，允许您定义自己的Codable类型，并使用带有完全类型安全性的SDK。

struct MyIdentifier: Codable {
    var userID: String
    var email: String?
}

struct MyConsent: Codable {
    var document: String
    var consented: Bool
}

struct MyProperties: Codable {
    var eventID: Int
    var artist: Artist
}

身份事件

跟踪身份事件提供了一个接口，用于更新设备上存储的当前用户的属性以及向下游集合API推送一个标识事件。

Lytics.shared.identify(
    name: "login",
    identifiers: MyIdentifier(
        userID: "this-users-known-id",
        email: "[email protected]"))

同意事件

同意事件提供了一个接口，用于配置并推送一个特殊的代表应用用户明确同意的事件。该事件执行正常事件的所有操作，并允许开发者在特定细节上提供特殊的有效负载。

Lytics.shared.consent(
    name: "ios consent",
    consent: MyConsent(
        document: "termsAndConditions",
        consented: true))

跟踪自定义事件

跟踪自定义事件提供了一个接口，用于配置并在用户在应用程序中使用自定义事件（例如购物或登录）時推送。

Lytics.shared.track(
    name: "Buy Tickets",
    properties: MyProperties(
        eventID: event.id,
        artist: event.artist))

屏幕事件

屏幕事件提供了一个接口，用于配置并推送一个特殊的事件，该事件代表屏幕或页面视图。这应该被视为track方法的扩展。

Lytics.shared.screen(name: "Dashboard")

广告标识符

在收集IDFA之前，您必须首先将一个NSUserTrackingUsageDescription添加到您的应用程序的Info.plist中。然后您可以调用Lytics.shared.requestTrackingAuthorization()以要求iOS请求授权访问IDFA。请注意，如果用户已关闭系统隐私设置中的“允许应用请求跟踪”选项，则不会显示此警报，并且授权可以随时撤销。