Create survicate-kotlin-android.md

Author: dariusz-survicate

src/connections/sources/catalog/libraries/mobile/kotlin-android/destination-plugins/survicate-kotlin-android.md

@@ -0,0 +1,67 @@
+---
+title: Analytics Kotlin Survicate Plugin
+strat: kotlin-android
+---
+
+[Survicate](https://survicate.com/){:target="_blank"} is an all-in-one customer feedback platform that helps you collect and act on feedback from your customers. It helps you understand your customers and improve their experience with your product or service.
+
+Add Survicate device mode support to your applications using this plugin for [Analytics-Kotlin](https://github.com/segmentio/analytics-kotlin){:target="_blank"}.
+
+## Getting started
+
+First you need to provide a Survicate workspace key.
+
+You can do this in 2 ways:
+
+1. Add the key in the Segment panel -> Destinations -> Your Android app destination -> Settings. You need to put the key inside the Connection Settings as a "Workspace Key".
+
+2. Alternatively, you can add your Survicate workspace key as a metadata inside AndroidManifest
+
+   ```xml
+   <application
+       android:name=".MyApp"
+   >
+       <!-- ... -->
+       <meta-data android:name="com.survicate.surveys.workspaceKey" android:value="YOUR_WORKSPACE_KEY"/>
+   </application>
+   ```
+## Adding the dependency
+Add Survicate maven:
+```
+allprojects {
+    repositories {
+        // ...
+        maven { url 'https://repo.survicate.com' }
+    }
+}
+```
+   
+## Using the Plugin in your App
+In order to activate the Survicate plugin, you have to add a `SurvicateDestination` to the Analytics instance.
+
+```kotlin
+analytics = Analytics(segmentKey, applicationContext) {  
+  // ...
+}
+analytics.add(SurvicateDestination(applicationContext))
+```
+
+Make sure to keep only one instance of the `Analytics` (e.g. initialize it inside Application's onCreate method). This is important, because the Survicate SDK underneath can only be initialized once.
+
+Now you can use the Analytics as usual, having the events mapped to Survicate SDK as described below.
+
+_**Identify**_
+
+In the SurvicateDestination plugin, the `identify` method from Segment is transferred to the `setUserTraits` method of Survicate. You can provide multiple key-value pairs. The `userId` argument of `Analytics.identify` is also set as a user trait with the key "user_id".
+
+_**Track**_
+
+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.