Troubleshooting

Symptom	Resolution
SDK not initializing	Verify apiKey and appIdentifier are valid, set logLevel = .debug, and check the Xcode console for the disabled-SDK warning.
Events not appearing	Events may still be queued — wait for flushInterval or call flush(). Confirm network connectivity and that the API key is correct.
Push tracking not working	Confirm the Push Notifications capability and APNs certificate are configured, and that registerDeviceToken / trackPushOpened are called from the right delegate methods.