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.
Logging in
Section titled “Logging in”Visit app.whiskrkit.eu and sign in with your account credentials. Currently, in beta, credentials can be requested by contacting WhiskrKit.
Adding your app
Section titled “Adding your app”Before creating surveys, you need to register your app in the dashboard.
- Click New App in the sidebar
- Enter your app’s name and platform (iOS)
- 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.
API keys
Section titled “API keys”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.
Creating a survey
Section titled “Creating a survey”- Select your app from the sidebar
- Go to Surveys and click New Survey
- Choose a survey type, NPS, star rating, thumbs up/down, or textual
- Set your question text and any follow-up question
- Choose a presentation style, sheet, toast, or full-screen cover
- Configure eligibility rules (see below)
- 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
Section titled “Eligibility rules”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,
onceshows it a single time;cooldownenforces a waiting period between showings;alwaysshows it every time eligibility is checked - Cooldown period, the minimum time between survey presentations when using the
cooldownpolicy
Changes to eligibility rules take effect immediately without requiring an app update.
Viewing responses
Section titled “Viewing responses”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.