Analytics Swift Survicate Plugin

Survicate 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-Swift.

Adding the dependency

When you add the Analytics Swift Survicate Plugin, the Survicate library is installed as an additional dependency.

Using Xcode

In the Xcode File menu, click Add Packages. You’ll see a dialog where you can search for Swift packages. In the search field, enter the URL to this repo:

https://github.com/survicate/analytics-swift-survicate.git

You’ll then have the option to pin to a version or specific branch, and select which project in your workspace to add it to. Once you’ve made your selections, click the Add Package button.

Using Package.swift

Open your Package.swift file and add the following to your the dependencies section:

.package(
name: "SurvicateDestination",
url: "https://github.com/survicate/analytics-swift-survicate.git",
from: "3.0.2"
),

import Segment
import SurvicateDestination // <-- Add this line

Using the Plugin in your App

Open the file where you setup and configure the Analytics-Swift library. Add this plugin to the list of imports.

Just under your Analytics-Swift library setup, call analytics.add(plugin: ...) to add an instance of the plugin to the Analytics timeline.

Your events will now begin to flow to Survicate in device mode.

Using the SurvicateDestination 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 userId from the Identify event 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 userId is also set as a user trait with the key “userId”.

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 user in Segment, it will be reset in Survicate.