surveysparrow-react-native-sdk

surveysparrow-react-native-sdk

SurveySparrow React Native SDK enables you to collect feedback from your mobile app. Embed the Classic, Chat & NPS surveys in your React Native application seamlessly with few lines of code.

SDK	Latest Version	Tag	Branch
SpotChecks React Native SDK	1.0.11 (latest)	1.0.11	spotchecks
Expo SpotChecks React Native SDK	2.0.3(latest)	2.0.3	expo-spotchecks
Normal React Native SDK	0.3.0 (latest)	-	main

SpotChecks Details

Introducing Spotchecks in 1.x.x version series(surveysparrow-react-native-sdk). Spotchecks docs is available in React Native Spotchecks.

Introducing Expo Spotchecks in 2.x.x version series (surveysparrow-expo-spotchecks). Spotchecks docs is available in React Native Spotchecks.

Normal SDK Share will be maintained in 0.2.x

Normal SDK Implementation

Features

• Fully customizable pre-build Full Size View to take feedback whenever & wherever you want.
• Survey Component to integrate the feedback experience anywhere in your app.
• Schedule Surveys to take one-time or recurring feedbacks.

Installation

npm install surveysparrow-react-native-sdk

yarn add surveysparrow-react-native-sdk

IOS

Add SurveySparrow IOS sdk in pod file and run pod install

pod 'SurveySparrowSdk', :git => 'https://github.com/surveysparrow/surveysparrow-ios-sdk.git', :tag => '0.5.2'

ANDROID

Android doesn't require any changes and note the min sdk version should be 19

Usage

import {
  SurveySparrow,
  invokeSurveySparrow,
  onSurveyResponseListener,
  scheduleSurveySparrow,
  clearSurveySparrow,
} from 'surveysparrow-react-native-sdk';

// Embedded Survey
<SurveySparrow
  styles={styles.box}
  config={{
    domain: 'domain-name',
    token: 'survey-token',
    surveyType: 'classic',
    customParams: [
      { name: 'testname', value: 'custom value 10' },
      { name: 'testname2', value: 'custom value 2' },
    ],
  }}
  onSurveyComplete={(data) => {
    console.log('survey response from embed survey is', data);
  }}
/>
//  Full Survey
<Button
  title="Open Survey"
  onPress={() => {
    invokeSurveySparrow({
      domain: 'domain-name',
      token: 'survey-token',
      surveyType: 'classic',
    });
  }}
/>

// Schedule Survey
<Button
  title="Open Survey"
  onPress={() => {
    scheduleSurveySparrow({
      domain: 'domain-name',
      token: 'survey-token',
      surveyType: 'classic',
    });
  }}
/>

// clear schedule
<Button
  title="Open Survey"
  onPress={() => {
    clearSurveySparrow({
      domain: 'domain-name',
      token: 'survey-token',
      surveyType: 'classic',
    });
  }}
/>

// listining to survey complete event
React.useEffect(() => {
  const sub = onSurveyResponseListener.addListener(
    'onSurveyResponse',
    (data: any) => {
      console.log('survey response is', data);
    }
  );
  return () => sub.remove();
}, []);

Methods

1) invokeSurveySparrow()

This method will be used to invoke Survey from SurveySparrow

parameter	Description	Default	Optional
domain	survey domain to load	value has to be provided	no
token	survey token for the survey	value has to be provided	no
surveyType	survey type for the survey	value has to be provided	no
customParams	any custom params to be passed for the survey	[]	yes
thankYouPageTimeLimit	how long the full view has to be shown before closing	3000 (ms)	yes

2) scheduleSurveySparrow()

This method will be used to schedule Survey from SurveySparrow

parameter	Description	Default	Optional
domain	survey domain to load	value has to be provided	no
token	survey token for the survey	value has to be provided	no
surveyType	survey type for the survey	value has to be provided	no
customParams	any custom params to be passed for the survey	[]	yes
thankYouPageTimeLimit	how long the full view has to be shown before closing	3000 (ms)	yes
alertTitle	dialouge box alert title	'Rate us'	yes
alertMessage	dialouge box alert message	'Share your feedback and let us know how we are doing'	yes
alertPositiveText	dialouge box positive text	'Rate Now'	yes
alertNegativeText	dialouge box negative text	'Later'	yes
startAfter	after how long the initial schedule has to happen	259200000	yes
repeatInterval	after how long the schedule should repeat	432000000	yes
repeatSurvey	if the schedule should repeat	false	yes
incrementalRepeat	if schedule has to be a incremental repeat	false	yes

3) clearSurveySparrow()

This method will be used to clear the schedule that was previously set

parameter	Description	Default	Optional
domain	survey domain to load	value has to be provided	no
token	survey token for the survey	value has to be provided	no

Event Listener

1) onSurveyResponseListener

Listener name	Description	Optional
onSurveyResponse	this event listener will be triggered after completing the survey	yes

Component

1) SurveySparrow

This Component can be used to render a survey view

prop	Description	Default	Optional
config	survey config such as domain,token,surveyType,customParams	config object has to be provided	no
onSurveyComplete	callback function that will be called after survey complete	null	yes
styles	component styles	null	yes

Contributing

See the contributing guide to learn how to contribute to the repository and the development workflow.

License

MIT

Please submit bugs/issues through GitHub issues we will try to fix it ASAP.