Mixpanel SDKs: iOS (Swift)

/// import Mixpanel class from the library
import Mixpanel

func application(_ application: UIApplication,
                 didFinishLaunchingWithOptions launchOptions: [NSObject: AnyObject]?) -> Bool {
    ...
    /// initialize Mixpanel using your project token
    let options = MixpanelOptions(token: "YOUR_PROJECT_TOKEN")
    Mixpanel.initialize(options: options)
    ...
}

import Mixpanel

func application(_ application: UIApplication,
                 didFinishLaunchingWithOptions launchOptions: [NSObject: AnyObject]?) -> Bool {
    ...
    /// Configure Mixpanel for EU data residency
    let options = MixpanelOptions(
        token: "YOUR_PROJECT_TOKEN",
        serverURL: "https://api-eu.mixpanel.com",
        flushInterval: 15
    )
    Mixpanel.initialize(options: options)

    /// Enable debug logging after initialization
    Mixpanel.mainInstance().loggingEnabled = true
    ...
}

/// track "some_event" 
/// with "plan" event prop set to "Premium"
Mixpanel.mainInstance().track(event: "some_event",
    properties:["Plan": "Premium"])

/// start the timer for the event "Image Upload"
Mixpanel.mainInstance().time(event: "Image Upload")

/// 20 seconds later...

/// track "Image Upload" event with "Duration" event prop set to 20
Mixpanel.mainInstance().track(event: "Image Upload")

/// flush batched events for ingestion immediately
Mixpanel.mainInstance().flush()

/// Set flush interval to 120 seconds during initialization
let options = MixpanelOptions(
    token: "YOUR_PROJECT_TOKEN",
    flushInterval: 120  // Flush every 2 minutes
)
Mixpanel.initialize(options: options)

/// Change flush interval at runtime
Mixpanel.mainInstance().flushInterval = 120

let options = MixpanelOptions(
    token: "YOUR_PROJECT_TOKEN",
    superProperties: [
        "app_version": "1.2.3",
        "platform": "iOS"
    ]
)
Mixpanel.initialize(options: options)

/// track "some_event"
/// "app_version" and "platform" are automatically added as event props
Mixpanel.mainInstance().track(event: "some_event")

/// register a "name" super property
Mixpanel.mainInstance().registerSuperProperties(["name": "Sam"])

/// track "some_event"
/// "name" is automatically added as an event prop
Mixpanel.mainInstance().track(event: "some_event")

Mixpanel.mainInstance().registerSuperProperties([
    "superProp0": "value1",
    "superProp1": "value2",
    "superProp2": "value3",
    "superProp3": 1,
    "superProp4": 2,
    "superProp5": 3
])

Mixpanel.mainInstance().track(event: "test")

/// your user signs in and tracks a sign in event
Mixpanel.mainInstance().track(event: "sign in")

/// upon sign in, identify the user with their ID
/// ensure future events sent from the user have distinct_id 12345
Mixpanel.mainInstance().identify(distinctId: "12345");

/// your user signs out and tracks a log out event
Mixpanel.mainInstance().track(event: "log out")

/// upon logout, call reset to clear local storage
/// new distinct_id is generated for events moving forward
Mixpanel.mainInstance().reset()

let options = MixpanelOptions(
    token: "YOUR_PROJECT_TOKEN",
    useUniqueDistinctId: true  // Use IDFV instead of UUID
)
Mixpanel.initialize(options: options)

// create a device ID provider
let options = MixpanelOptions(
    token: "YOUR_PROJECT_TOKEN",
    deviceIdProvider: {
        return getYourCustomDeviceId()
    }
)

let mixpanel = Mixpanel.initialize(options: options)

// persistent ID - survives reset() calls
let options = MixpanelOptions(
    token: "YOUR_PROJECT_TOKEN",
    deviceIdProvider: {
        return getStoredDeviceId() // returns same value every time
    }
)

// ephemeral ID - changes on reset() calls
let options = MixpanelOptions(
    token: "YOUR_PROJECT_TOKEN",
    deviceIdProvider: {
        return generateNewDeviceId() // returns new value each time
    }
)

/// You must call identify to associate the profile update with the user
Mixpanel.mainInstance().identify(distinctId: "12345")

/// Set user's "Plan" profile prop to "Premium"
Mixpanel.mainInstance().people.set(properties: ["plan":"Premium", "$email":"joe.doe@example.com"])

/// Update "plan" to "Enterprise"
Mixpanel.mainInstance().people.set(properties: ["plan":"Enterprise"])

/// assign the current user to the "mixpanel" company group
Mixpanel.mainInstance().setGroup(groupKey: "company", groupID: ["mixpanel"])

/// track "some_event"
/// event prop "company" = ["mixpanel"] is added automatically
Mixpanel.mainInstance().track(event: "some_event")


/// alternatively you can define the group key manually
Mixpanel.mainInstance().track(event: "some_event", properties: [
    "company": ["mixpanel"]])

/// assign the current user to the "mixpanel" company group
Mixpanel.mainInstance().setGroup(groupKey: "company", groupID: ["mixpanel"])

/// add "mp-us" as an additional company group
Mixpanel.mainInstance().addGroup(groupKey: "company", groupID: "mp-us")

/// track "some_event"
/// event prop "company" = ["mixpanel","mp-us"] is added automatically
Mixpanel.mainInstance().track(event: "some_event")

/// You must call identify to associate the profile update with the user
Mixpanel.mainInstance().identify(distinctId: "12345")

/// set group key "company" as a user prop
/// with group id "mixpanel" as value
Mixpanel.mainInstance().people.set(properties: ["company":"mixpanel", "$email":"joe.doe@example.com"])

/// assign the current user to the "mixpanel" company group
Mixpanel.mainInstance().setGroup(groupKey: "company", groupID: ["mixpanel"])

/// specify the target group using the group_key and group_id using getGroup()
/// set "industry" as a group profile prop to "analytics" using set()
Mixpanel.mainInstance().getGroup(groupKey: "Company", groupID: “mixpanel”).set(properties: [
    "industry": "analytics"
])

let options = MixpanelOptions(
    token: "YOUR_TOKEN",
    autocaptureOptions: AutocaptureOptions()
)

let mixpanel = Mixpanel.initialize(options: options)

let autocaptureOptions = AutocaptureOptions(
    rageClickOptions: RageClickOptions(clickThreshold: 5, timeWindowMs: 800),
    deadClickOptions: DeadClickOptions(enabled: false)
)

let options = MixpanelOptions(
    token: "YOUR_TOKEN",
    autocaptureOptions: autocaptureOptions
)

let autocaptureOptions = AutocaptureOptions(
    clickOptions: ClickOptions(enabled: false),
    rageClickOptions: RageClickOptions(enabled: false),
    deadClickOptions: DeadClickOptions(enabled: false)
)

/// enable debug log
Mixpanel.mainInstance().loggingEnabled = true

let mixpanel = Mixpanel.initialize(token: "YOUR_PROJECT_TOKEN")
mixpanel.backupHost = "api-backup.mixpanel.com"

/// send "some_event"
Mixpanel.mainInstance().track(event: "some_event")

/// opt user out of tracking
/// SDK is prevented from sending any data
Mixpanel.mainInstance().optOutTracking()

/// this track call will not work
Mixpanel.mainInstance().track(event: "some_event")

/// create Mixpanel instance with users opted out of tracking by default
/// SDK is prevented from sending data
let options = MixpanelOptions(
    token: "YOUR_PROJECT_TOKEN",
    optOutTrackingByDefault: true
)
Mixpanel.initialize(options: options)

/// this track call will not work
Mixpanel.mainInstance().track(event: "some_event")

/// opt user into tracking
Mixpanel.mainInstance().optInTracking()

/// send "some_event"
Mixpanel.mainInstance().track(event: "some_event")

/// Initialize Mixpanel with EU data residency
let options = MixpanelOptions(
    token: "YOUR_PROJECT_TOKEN",
    serverURL: "https://api-eu.mixpanel.com"
)
Mixpanel.initialize(options: options)

/// Initialize Mixpanel with India data residency
let options = MixpanelOptions(
    token: "YOUR_PROJECT_TOKEN",
    serverURL: "https://api-in.mixpanel.com"
)
Mixpanel.initialize(options: options)

let options = MixpanelOptions(
    token: "YOUR_PROJECT_TOKEN",
    useIPAddressForGeoLocation: false
)
Mixpanel.initialize(options: options)

/// Disable IP-based geolocation at runtime
Mixpanel.mainInstance().useIPAddressForGeoLocation = false