Skip to content

Dashboard Walkthrough

The WhiskrKit dashboard is where you create surveys, configure eligibility rules, and view responses. Your app code stays minimal, most behaviour is controlled here.

Visit app.whiskrkit.eu and sign in with your account credentials. Currently, in beta, credentials can be requested by contacting WhiskrKit.

Before creating surveys, you need to register your app in the dashboard.

  1. Click New App in the sidebar
  2. Enter your app’s name and platform (iOS)
  3. Save, your app now appears in the sidebar

Once your app is created, navigate to Settings → API Keys to generate your first API key. Copy this key and use it in your initialize call:

WhiskrKit.shared.initialize(
apiKey: "wk_live_your_api_key",
withMockedSurveys: false
)

All surveys you create are scoped to a specific app, so make sure you have the right app selected in the sidebar before creating surveys.

As mentioned, go to Settings → API Keys to manage your keys. During development, use a test key (prefixed wk_test_), test responses are separated from your production data. For production builds, use a live key (wk_live_).

Keep your API keys private. Do not commit them to source control.

  1. Select your app from the sidebar
  2. Go to Surveys and click New Survey
  3. Choose a survey type, NPS, star rating, thumbs up/down, or textual
  4. Set your question text and any follow-up question
  5. Choose a presentation style, sheet, toast, or full-screen cover
  6. Configure eligibility rules (see below)
  7. Save, your survey is now live

The survey identifier shown on the survey detail page is what you pass to .whiskrKitSurvey(identifier:) or present(surveyId:) in your app.

Eligibility rules determine who sees a survey, when, and how often. Configure these per survey under the Targeting tab.

  • Session count, minimum number of app opens before the survey is shown
  • Repeat policy, once shows it a single time; cooldown enforces a waiting period between showings; always shows it every time eligibility is checked
  • Cooldown period, the minimum time between survey presentations when using the cooldown policy

Changes to eligibility rules take effect immediately without requiring an app update.

Open a survey and go to the Responses tab to see individual submissions. The Overview tab shows aggregate data including response rate and trends over time.

Response data accumulates over time, trend charts become more meaningful after several weeks of data, as you can compare across app versions, seasons, or feature releases.