Skip to Content
Getting started

Getting started

This walks you from zero to a project with a published survey and the API key your app’s SDK needs. It takes a few minutes.

Create your account

Open the dashboard and sign in with Google. On first sign-in you’ll go through a short onboarding wizard that creates your first project — one project maps to one app.

Connect an analytics source

MicroSurveys triggers surveys on the analytics events your app already sends. Connect your Amplitude project so we can import your event and user-property catalog:

  • In the project, choose Connect Amplitude and paste your Amplitude API key and secret key.
  • We import your events and user properties via Amplitude’s Taxonomy API so you can pick from real names when building triggers and targeting.

Taxonomy auto-import requires an Amplitude plan that exposes the Taxonomy API (Growth/Enterprise). On other plans you can enter event and property names manually — triggering matches on names at runtime either way, so nothing is blocked.

Copy your API key

Each project has a public SDK API key, prefixed ms_live_ (production) or ms_test_ (test). You’ll pass this to the SDK. Copy it from the project settings.

The full key is shown once at creation. Store it somewhere safe. The SDK key is a public key (it ships in your app) — it only authorizes fetching config and posting impressions/responses for this project.

Build and publish a survey

Open the survey builder and:

  • Add one or more questions (NPS, CES, CSAT, thumbs, single choice, open text — see Concepts).
  • Define a trigger — the event (and optional property match) that makes the survey eligible.
  • Optionally set audience, sampling %, and a frequency cap.
  • Set the survey’s status to Active and save.

Only Active surveys are delivered to the SDK.

Add the SDK to your app

Install the iOS SDK, initialize it with your API key, and forward your analytics events. See the iOS SDK guide — it’s three lines.

What happens next

Once the SDK is running with your key, it downloads your active surveys, watches your events, and presents an eligible survey natively when its trigger fires. Its impressions and responses flow back to the dashboard’s analytics.

Next: iOS SDK →

IntroductionConcepts