Skip to main content
Version: .NET MAUI SDK

FAQ

Answers to common questions about Screeb.Maui.

Can I use Screeb without identifying users?​

Yes. Screeb assigns an anonymous ID automatically when you initialize the SDK. 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?​

Don't call InitSdk() in test or CI environments. You can use conditional compilation or environment checks:

#if !DEBUG
await Screeb.InitSdk(
    channelId: "<YOUR-CHANNEL-ID>",
    userId: "user-123"
);
#endif

Or use environment variables:

if (Environment.GetEnvironmentVariable("ENVIRONMENT") == "production")
{
    await Screeb.InitSdk(
        channelId: "<YOUR-CHANNEL-ID>",
        userId: "user-123"
    );
}

This prevents Screeb from loading in development, testing, or CI environments.

Can I call InitSdk() multiple times?​

No. The SDK initializes once when your app starts. Calling init multiple times may cause unexpected behavior. If you need to switch users, use ResetIdentity() followed by SetIdentity().

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

Call ResetIdentity() first to clear the current session, then call SetIdentity() with the new user ID:

await Screeb.ResetIdentity();
await Screeb.SetIdentity("new-user-id", new Dictionary<string, object>
{
    ["email"] = "support@screeb.app"
});

Where do I find my Channel ID?​

Your Channel ID is available in the Screeb admin console under Settings > Install. It looks like a UUID: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.

For .NET MAUI, you use the same channel ID for both Android and iOS platforms.

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. SDK initialization: Verify that InitSdk() completed successfully
  4. Platform support: Ensure you're testing on Android or iOS (not Windows/macOS)

See the Troubleshooting page for more detailed debugging steps.

Does Screeb work on all .NET MAUI platforms?​

Screeb currently supports Android and iOS platforms. Windows, macOS, and other platforms are not yet supported.

Why does the survey widget look different on iOS vs Android?​

The Screeb widget renders natively on each platform with consistent styling. However, minor differences may occur due to:

  • System font rendering differences
  • Safe area insets (notches, navigation bars)
  • Platform-specific UI conventions

The core layout, colors, and interactions remain consistent. If you notice significant differences, check that you're using the latest version of Screeb.Maui.

Can I test surveys in the simulator/emulator?​

Yes, Screeb works in both iOS Simulator and Android Emulator. However, some features like camera/microphone access for audio/video surveys may not work properly in simulators.

For the most accurate testing, use a real device.

Do I need separate channel IDs for Android and iOS?​

No. Unlike some other SDKs, .NET MAUI uses a single channel ID that works for both Android and iOS platforms.

Are hooks supported on both platforms?​

Android hook callbacks work fully in v0.1.0. iOS hook callbacks are not yet supported in v0.1.0 but will be available in v0.2.0. See the MAUI Hooks page for details.