📘

Automatic events already captured

The iOS SDK logs Rage Taps and UI Freezes out‑of‑the‑box—no code required. Use custom events only for product‑specific interactions.

Event anatomy

Send a simple event

UIKit / Objective‑C / Swift

UXCam.logEvent("Product Added")

SwiftUI (no extra import)

UXCamCore.logEvent("Product Added")

🏷️

Naming rule of thumb – start with a verb (Opened, Tapped, Completed) so funnels read like sentences.

Send an event with properties

let props: [String: Any] = [
    "sku": "SKU‑9876",
    "price": 29.9,
    "currency": "USD",
    "campaign": "spring‑sale"
]
UXCam.logEvent("Checkout Completed", withProperties: props)

Properties support String, NSNumber, Bool, NSNull and collections thereof. Complex objects should be flattened.

🚧

20‑property cap – extra keys are silently dropped; Xcode console prints a warning when enableIntegrationLogging is on.

Best‑practice checklist

Batch helper (optional)

Fire several events in sequence and wait for the SDK to flush automatically:

func trackPaywallDismiss() {
    UXCam.logEvent("Paywall Dismissed")
    UXCam.logEvent("Trial Started", withProperties: [
        "plan": "Pro Monthly",
        "discount": true
    ])
}

No explicit flush call is required—the SDK uploads when the app resigns active or every 15 seconds on Wi‑Fi.

Debug & verify

1. Enable Console → Filter → UXCam in Xcode.
2. Trigger the interaction in a Debug build.
3. Look for 📤 Event queued: Checkout Completed {…}.
4. Background the app; open Dashboard → Events.
5. Check properties appear under Event Details → Parameters.

If nothing arrives after 30 seconds, confirm the device has internet and your project hasn’t Disabled UXCam in Dashboard settings.

Troubleshooting table