Integrate the Klaritics iOS SDK in Your App

The Klaritics iOS SDK collects analytics from iOS applications and sends them to your self-hosted Klaritics instance. This guide covers Swift Package Manager setup, initialization, and event logging in both Swift and Objective-C.

Installation

Add the SDK via Swift Package Manager (SPM). CocoaPods is not part of the current setup.

In Xcode, choose File → Add Packages.
Enter the Klaritics iOS SDK repository URL.
Add the package to your application target.

Initialization

Call initialize before logging any events, typically in your AppDelegate or app entry point:

Klaritics.initialize(
    appId: "YOUR_APP_ID",
    serverHost: "https://YOUR_SERVER_HOST"
)

The SDK will not initialize until both appId and serverHost are provided.

Logging events

Use logAppEvent to send standard analytics events. The method accepts an event name and an optional dictionary of additional information.

Klaritics.logAppEvent(
    withName: "ButtonClicked",
    info: ["ButtonLabel": "Hey"]
)

NSDictionary *info = @{
    @"ButtonLabel": @"Hey"
};
[Klaritics logAppEventForEvent:@"LANG_SELECT" withInfo:info];

Important naming note

The client-facing class is Klaritics. Do not use KlariticsSDK, KlariticsCore, or any other variant in your application code.

⌘I

Get Started

User Management

Analysis

Dashboards

Widgets

Data

Templates

Alerts & Integrations

SDK Integration

Deployment

Reference

Integrate the Klaritics iOS SDK in Your App

Installation

Initialization

Logging events

Important naming note

​Installation

​Initialization

​Logging events

​Important naming note

Installation

Initialization

Logging events

Important naming note