Skip to main content
Version: iOS SDK

FAQ

Answers to common questions about Screeb for iOS.

Can I use Screeb without identifying users?​

Yes. Screeb assigns an anonymous ID automatically when you call Screeb.initSdk(...). You don't need to call Screeb.setIdentity(...) if you want to track anonymous users. Anonymous users count toward your Monthly Tracked Users (MTU).

How do I prevent Screeb from loading in test/CI environments?​

Simply skip calling Screeb.initSdk(...) in non-production environments. Use a conditional check based on your build configuration:

#if !DEBUG
Screeb.initSdk(context: nil, channelId: "<YOUR-CHANNEL-ID>")
#endif

This prevents Screeb from initializing during development or testing.

Can I call initSdk() multiple times?​

No. Call Screeb.initSdk(...) only once per app session, typically in your AppDelegate or SceneDelegate. Calling it multiple times may cause unexpected behavior. If you need to switch users, use Screeb.resetIdentity() followed by Screeb.setIdentity(...).

How do I switch to a different user (e.g., after login)?​

Call Screeb.resetIdentity() first to clear the current session, then call Screeb.setIdentity(...) with the new user ID. If you also want to attach profile data, pass visitor properties in the same call:

Screeb.resetIdentity()
Screeb.setIdentity(
    uniqueVisitorId: "new-user-id",
    visitorProperty: ["email": AnyEncodable("support@screeb.app")]
)

Where do I find my Channel ID?​

Your iOS Channel ID is available in the Screeb admin console under Settings > Install. Select "iOS" as the platform, and you'll see the channel ID, which looks like a UUID: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.

Why is my survey not showing?​

Common reasons a survey might not appear:

  1. Targeting rules: Check the survey targeting rules in the admin console
  2. User identification: Ensure the user is identified before the survey trigger fires
  3. Initialization timing: Ensure Screeb.initSdk(...) is called before triggering surveys

See the Troubleshooting page for more detailed debugging steps.

Which minimum iOS version is required?​

Screeb for iOS requires iOS 12.0 or higher and Swift 5.0 or higher. See Install for the full technical requirements.

Does the Screeb SDK have external dependencies?​

No, from SDK version 2.0.0 onwards the iOS SDK has no external dependencies.

Can I customize the survey appearance on iOS?​

Survey appearance is configured in the Screeb admin console, not in the SDK. You can customize colors, fonts, and button styles through the survey editor. The SDK respects these settings automatically.