React Native Surveys & Feedback

Supported on: iOS SDK 1.0.61+ · Android SDK 1.0.33+ · React Native SDK 1.0.4+

The surveys module lets you collect user feedback through in-app surveys. Surveys can trigger automatically based on events (like in-app messages) or be presented manually from your code.

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[]`

Rich Media

Survey questions support rich media content configured in the Console:

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.

​How It Works

​Present a Survey Manually

​Module Access

​Module Methods

​8 Question Types

​AppDNASurveyDelegate

​Response Shape

​Rich Media

​Auto-Tracked Events

​Full Example

How It Works

Present a Survey Manually

Module Access

Module Methods

8 Question Types

AppDNASurveyDelegate

Response Shape

Rich Media

Auto-Tracked Events

Full Example