Walkthrough: Wallet CES
A complete example: ask users how easy it was to understand their wallet, right after they view it. This is the canonical “contextual micro-survey” flow.
Goal: a 1–7 Customer Effort Score question — “How easy was it to understand your wallet balance and payment methods?” — triggered by the wallet screen-view event, capped to once per user per 30 days, at 100% sampling.
Prerequisites
- A project with your analytics connected.
- The wallet screen fires an event you can target — e.g.
page_viewwith a propertyscreen = "Wallet". - The iOS SDK installed and running with your key.
Create the survey and question
In the survey builder, add one CES question:
- Prompt: How easy was it to understand your wallet balance and payment methods?
- Scale: min
1(“Very difficult”) to max7(“Very easy”). - Required: yes.
Define the trigger
Add a SINGLE trigger:
- Event:
page_view - Match:
screen = Wallet - Delay:
3seconds (let the screen settle before presenting).
Prefer a SEQUENCE when the moment is defined by more than one action — e.g.
page_view {screen: Wallet} then wallet_tap within 60 seconds.
Set eligibility
- Audience: everyone (leave
audienceMatchempty), or narrow to e.g.plan = pro. - Sampling:
100%. - Frequency cap:
maxPerUserDays = 30.
Publish
Set the survey status to Active and save. The SDK picks it up on its next config fetch (immediately on app start, otherwise within the 12-hour foreground refresh window).
Verify on device
Run your app, navigate to the wallet screen, and — after the 3-second delay — the survey appears as a bottom sheet. Submit a score.
With debug logging on, filter the Xcode console by
[MicroSurveys] to watch the trigger match and each eligibility gate.
See the response
Open the survey’s analytics in the dashboard: the impression and the CES score appear once the SDK flushes them (immediately when online).
What just happened
The SDK matched your page_view event locally, ran the full
eligibility order, waited the delay, presented the survey
with your dashboard theme, and reported the impression and response — all without
any survey-specific code in your app. Change the prompt, targeting, or look, and
it’s a dashboard edit, not a release.