In-app survey
An in-app survey is shown inside your Android or iOS app, over the app's own screen, at the moment the app asks for it — after a purchase, a finished task or an update. The app shows it with the Voxtrics mobile SDK, by the survey's ID: the survey slides up from the bottom in a sheet sized to it, and the SDK tells the app what happened — shown, answered (with the score), closed.
The mobile SDK comes with the Business plan and up — see Free vs paid.
Add your app first
An in-app survey is shown in one of your apps. In Settings, Apps, Add app: its name and, if you like, its Android applicationId and iOS bundle ID, shown next to the app for your reference. Your plan sets how many apps you can add. An app belongs to the domain selected at the top of the page when you add it, and only in-app surveys on that domain can use it.
Then Surveys, New survey, In-app survey. Like any other survey, it lives on the domain it is created on, with a website or without one, and is written in that domain's languages. Its app is one of that domain's, picked in the editor's Survey name section, and a new in-app survey starts on the domain's first app.
Add the SDK to the app
The survey's Embed button on the survey list (or Get embed code in the editor's Actions) shows the code for this very survey, with its ID filled in: a tab for Android and one for iOS, each with the line that adds the SDK and the call that opens the survey. Copy them from there.
Android (7.0 and later): add the dependency from the Android tab to your app module's
build.gradle.kts, then, from an activity:
Voxtrics.showSurvey(
activity = this,
surveyId = "YOUR_SURVEY_ID",
options = SurveyOptions(screen = "checkout"),
)
iOS (16.4 and later): in Xcode, File → Add Package Dependencies, with the URL from the iOS tab. Then, in SwiftUI:
Button("Give feedback") { showSurvey = true }
.voxtricsSurvey(id: "YOUR_SURVEY_ID", isPresented: $showSurvey,
options: SurveyOptions(screen: "checkout"))
or from UIKit, Voxtrics.showSurvey(id: "YOUR_SURVEY_ID", from: viewController).
The options are all optional:
- screen — a name for the place in the app the survey opens from (
checkout). It is kept with the response. - theme — light, dark, or the app's own (the default).
- locale — a language code. By default the device's language; a survey that isn't written in it opens in its first language.
What the app is told
- Shown — the sheet is on screen.
- Submitted — the response was saved. It carries the response's main evaluation, the score the response shows in Responses, on a 1–5 scale — for example, to ask for a store review after a 4 or a 5.
- Closed — by the person (the survey's close control, a tap outside the sheet, Back on Android or a swipe down on iOS), or after the thank-you screen.
- Error — the survey can't be shown, and nothing appears on screen: it doesn't exist or isn't published, it isn't an in-app survey, this device already answered a survey that takes one answer per person, there's no connection, its page didn't load within 20 seconds, or it didn't open within 10 seconds of loading.
How it behaves
- The survey loads out of sight; the sheet appears only once the survey is ready to answer.
- The sheet takes the survey's height, up to 90% of the screen, and the survey scrolls past that. With the keyboard up the sheet stays above it.
- Links in the survey open in the phone's browser, and the survey stays where it was.
- Turning the phone keeps the survey open, with whatever was already filled in.
- One survey at a time: the app can't open a second one while one is on screen.
Try it without the app
Under the platform tabs, the survey's code also shows the page the SDK opens, /m/YOUR_SURVEY_ID.
Open it in a browser to see and answer the survey before the app has the SDK — a response sent there
is a real one.
Responses from an app
A response given in an app reads In app as its browser, and its page has an App card: the
platform, the app ID, the app's version and build, the OS version, the device model, the screen and
the SDK's version. The response's page link is app:// followed by the app ID and the screen. See
Response detail.