Skip to content


Repository files navigation

Woopra iOS SDK Documentation



CocoaPods is a dependency manager for Cocoa projects. You can install it with the following command:

$ gem install cocoapods

To integrate the SDK into your Xcode project using CocoaPods, please, specify it in your Podfile:

source ''
platform :ios, '12.0'

target '<Your Target Name>' do
    pod 'WoopraSDK', '1.2.0'

Then, run the following command:

$ pod install

Swift Package Manager

Installing from Xcode(using Xcode15.3 for example)

  1. Add a package by selecting FileAdd Package Dependencies... in Xcode’s menu bar.
  2. Search for the WoopraSDK using the repo's URL:
  3. Set the Dependency Rule to be Exact Version with version 1.2.0
  4. Select Add Package.

Alternatively, integrate WoopraSDK in your Package.swift file(swift-tools-version:5.0)

dependencies: [
    .package(url: "", from: "1.2.0")

Then, add the dependency to your target:

targets: [
        name: "YourAppName",
        dependencies: [
            .product(name: "Woopra", package: "Woopra-iOS")]


Instantiate Tracker

import Woopra

When the app loads, you should load the Woopra Tracker and configure it.

WTracker.shared.domain = ""

You can update your idle timeout (default: 60 seconds) by updating the timeout property in your WTracker instance:

WTracker.shared.idleTimeout = 30

Event Tracking

To track an appview event:

// create event "appview"
let event = WEvent.event(name: "appview")
// add property "view" with value "login-view"
event.add(property: "view", value: "login-view")
// track event


To add custom visitor properties, you should edit the visitor object.

WTracker.shared.visitor.add(property: "name", value: "John Smith")
WTracker.shared.visitor.add(property: "email", value: "")

You can then send an identify call without tracking an event by using the push method: