@survicate/analytics-react-native-survicate

@segment/analytics-react-native-survicate

SurvicatePlugin for Survicate. Wraps react-native-survicate.

Installation

You need to install the @survicate/analytics-react-native-survicate and the @survicate/react-native-survicate dependency.

Using NPM:

npm install --save @survicate/analytics-react-native-survicate @survicate/react-native-survicate

Using Yarn:

yarn add @survicate/analytics-react-native-survicate @survicate/react-native-survicate

Configuring

• Add your Survicate workspace key to Info.plist

	<key>Survicate</key>
	<dict>
		<key>WorkspaceKey</key>
		<string>YOUR_WORKSPACE_KEY</string>
	</dict>

• run command pod install in your ios directory

Configuring Survicate Bindings for Android

• Add maven repository to your project build.gradle located under android directory

allprojects {
    repositories {
        // ...
        maven { url 'https://repo.survicate.com' }
    }
}

• Add your Survicate workspace key to AndroidManifest.xml

<application
    android:name=".MyApp"
>
    <!-- ... -->
    <meta-data android:name="com.survicate.surveys.workspaceKey" android:value="YOUR_WORKSPACE_KEY"/>
</application>

Usage

Follow the instructions for adding plugins on the main Analytics client:

In your code where you initialize the analytics client call the .add(plugin) method with an SurvicatePlugin instance:

import { createClient } from '@segment/analytics-react-native';

import { SurvicatePlugin } from '@segment/analytics-react-native-plugin-survicate';

const segmentClient = createClient({
  writeKey: 'SEGMENT_KEY'
});

segmentClient.add({ plugin: new SurvicatePlugin() });

using the Survicate plugin

identify

In the SurvicateDestination plugin, the identify event from Segment is transferred to the setUserTrait method of Survicate. This is achieved within the identify function of the SurvicateDestination class. The traits and user Id from the IdentifyEvent are extracted and set as user traits in Survicate using the setUserTrait method. The traits are a dictionary where each key-value pair is set as a user trait. The user Id is also set as a user trait with the key "user_id".

track

In the SurvicateDestination plugin, the track method from Segment is used as the invokeEvent method in Survicate. This means that when you track an event in Segment, it will be invoked in Survicate.

screen

Similarly, the screen method from Segment is used as the enterScreen method in Survicate. This means that when you track a screen in Segment, it will be entered in Survicate.

reset

The reset method from Segment is used as the reset method in Survicate. This means that when you reset the Segment client, the Survicate client will also be reset.

Issues

Got an Issue?

To make things more streamlined, we’ve transitioned our issue reporting to our customer support platform. If you encounter any bugs or have feedback, please reach out to our customer support team. Your insights are invaluable to us, and we’re here to help ensure your experience is top-notch!

Contact us via Intercom in the application, or drop us an email at: [[e-mail]]

Thank you for your support and understanding!