Supported on: iOS SDK 1.0.61+ · Android SDK 1.0.33+ · React Native SDK 1.0.4+
How It Works
Surveys are configured in the Console with content, question types, and trigger rules. Like in-app messages, they can appear automatically when trigger conditions are met — no code required for trigger-based surveys.
Present a Survey Manually
import { AppDNA } from '@appdna/react-native-sdk';
await AppDNA.surveys.present('nps_q1_2026');
present returns once the survey request has been dispatched to the native SDK. Whether the survey actually appears depends on the survey’s status, audience, and trigger rules configured in the Console — the SDK fires the survey_presented analytics event (and your delegate’s onSurveyPresented callback) when it does. If you need to confirm that a survey was shown to the user, observe the delegate rather than the return value.
Module Access
const surveys = AppDNA.surveys;
Module Methods
| Method | Signature | Description | |
|---|
present | present(surveyId: string): Promise<void> | Request that the SDK present a survey | |
setDelegate | `setDelegate(delegate: AppDNASurveyDelegate | null): void` | Set a delegate for survey lifecycle callbacks |
8 Question Types
Surveys support the following question types, configured in the Console:
| Type | Display | Response |
|---|
nps | 0-10 numeric scale | Integer 0-10 |
csat | 1-5 satisfaction scale | Integer 1-5 |
rating | Star rating | Integer 1-5 |
emoji_scale | Emoji options | Selected emoji value |
yes_no | Binary choice | Boolean |
single_choice | Radio button options | Selected option string |
multi_choice | Checkbox options | List of selected strings |
free_text | Text input field | Free-form string |
Question types and their content are defined entirely in the Console. The SDK renders them automatically based on the survey configuration.
AppDNASurveyDelegate
All 3 methods on this delegate fire from the native survey pipeline alongside the existing analytics events. Register your delegate via AppDNA.surveys.setDelegate(...).
onSurveyPresented(surveyId) — fires when the survey view appears (alongside the survey_shown event).onSurveyCompleted(surveyId, responses) — fires when the user submits the final question. responses is a Record<string, unknown> keyed by question ID containing the user’s answers, suitable for forwarding to your own analytics or CRM.onSurveyDismissed(surveyId) — fires when the user closes the survey before completing it (X button, swipe-to-dismiss, outside tap).
Implement the delegate to capture survey responses and lifecycle events:
import { AppDNA, AppDNASurveyDelegate } from '@appdna/react-native-sdk';
const feedbackHandler: AppDNASurveyDelegate = {
onSurveyPresented(surveyId) {
console.log(`Survey shown: ${surveyId}`);
},
onSurveyCompleted(surveyId, responses) {
const score = responses.nps_question as number | undefined;
if (score !== undefined) {
if (score >= 9) {
showReferralPrompt();
} else if (score <= 6) {
showSupportLink();
}
}
const feedback = responses.free_text_question as string | undefined;
if (feedback) {
console.log(`User feedback: ${feedback}`);
}
},
onSurveyDismissed(surveyId) {
console.log(`Survey dismissed: ${surveyId}`);
},
};
AppDNA.surveys.setDelegate(feedbackHandler);
Response Shape
The responses object passed to onSurveyCompleted is keyed by questionId. Value types follow the question type:
| Question Type | Value Type |
|---|
nps, csat, rating | number |
yes_no | boolean |
single_choice, emoji_scale, free_text | string |
multi_choice | string[] |
- Header images — add images above survey questions
- Icons in options — use icon references in choice options (Lucide, SF Symbols, Material, or emoji)
- Thank-you animations — Lottie or confetti effects on survey completion
- Haptic feedback — triggered on option selection and submission
See the Rich Media guide for details on supported formats.
Auto-Tracked Events
| Event | Trigger |
|---|
survey_presented | A survey is displayed |
survey_response_submitted | User submits a survey response |
survey_dismissed | Survey is closed without completing |
Full Example
import { AppDNA, AppDNASurveyDelegate } from '@appdna/react-native-sdk';
export class FeedbackManager implements AppDNASurveyDelegate {
constructor() {
AppDNA.surveys.setDelegate(this);
}
/** Present NPS survey after a key moment */
async askForFeedback(): Promise<void> {
await AppDNA.surveys.present('nps_q1_2026');
}
onSurveyPresented(surveyId: string): void {
// Survey is visible
}
onSurveyCompleted(surveyId: string, responses: Record<string, unknown>): void {
const score = responses.nps_question as number | undefined;
if (score === undefined) return;
if (score >= 9) {
showReferralPrompt();
} else if (score <= 6) {
showSupportLink();
}
}
onSurveyDismissed(surveyId: string): void {
// User dismissed without responding
}
}
Surveys are created in the Console under Feedback > Surveys. Trigger-based surveys appear automatically — manual presentation with present() is for cases where you want precise control over timing.
