3. Events API

Points in Time vs. Persistent State

While Attributes track the continuous, ongoing state of a session, Events represent specific, instantaneous occurrences.

An event fires at the exact moment something noteworthy happens - like a purchase, a completed step, or a match result. Events are sent through NX10Core.shared.events, backed by the SDK's EventsProvider.

The API Surface

The SDK provides a straightforward method to dispatch events, allowing an optional flat data dictionary to be attached to the payload.

1. Sending Simple Events

For basic occurrences that do not require extra metadata, call sendEvent(_:) with just an event name.

import NX10CoreSDK

NX10Core.shared.events.sendEvent("settings_opened")

2. Sending Events with Metadata

To provide deeper insight into an event, pass a flat dictionary as the second argument to sendEvent(_:with:). This is useful for tracking transaction amounts, item identifiers, or outcome details.

import NX10CoreSDK

func resolvePurchase(amount: Double) {
    let eventData: [String: Any] = [
        "amount": amount
    ]

    NX10Core.shared.events.sendEvent("purchase_completed", with: eventData)
}