logo

Overview

Segment is a Customer Data Platform (CDP) that collects and processes data from your users. With Segment, you can direct this data to other tools, including 1Flow, to gain insights into your product experience.
If your team already uses Segment, you can easily install the 1Flow SDK and send the necessary data for triggering surveys and targeting users.
This means any events and user identity data you’re tracking in Segment can be utilized by 1Flow – without extra development effort.

From Segment

First, go to your Segment account.
  1. From the Segment web app, click Catalog, then search for 1Flow Mobile Plugin.
  1. Click Add Destination.
  1. Select an existing Source to connect to 1Flow Mobile Plugin.
  1. Go to 1flow.ai -> Settings -> Project Settings, copy the 1Flow project API key, and paste it into the Destination Settings in Segment.
  1. Depending on the mobile source you’ve selected, include 1Flow’s library by adding the following lines to your dependency configuration.

Install 1Flow

Step 1: Add Segment1Flow Package using Swift Package Manager

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/1Flow-Inc/segment-1flow-ios
You’ll then have the option to pin to a version, or specific branch, as well as which project in your workspace to add it to. Once you’ve made your selections, click the Add Package button.

Step 2: Initialize Segment and add 1Fow Destination

swift
import Segment1Flow ... let config = Configuration(writeKey: "YOUR_WRITE_KEY_HERE") let analytics = Analytics(configuration: config) analytics.add(plugin: OneFlowDestination())

Supported methods

Identify

If you’re not familiar with the Segment Specs, take a look to understand what the Identify method does. An example call would look like:
swift
analytics.identify(userId: "peter@example.com", traits: [ "name": "Peter Gibbons", "email": "peter@example.com", "mobile": 1234567890 ])
When you call identify method of segment, it will be equivalent to logUser of 1Flow. userId will be userID and traits will be userDetails.

Track

If you’re not familiar with the Segment Specs, take a look to understand what the Track method does. An example call would look like:
swift
analytics.track(name: "ButtonClicked")
Any value passed in name, will be eventName and if you have passed any event property, then it will be event parameters.

Screen

Send Screen calls to record which mobile app screens users have viewed. For example:
swift
analytics.screen(title: "Home")
Segment sends Screen calls to 1Flow as a screen_[name] event (or screen_view if a screen name isn’t provided).

Settings

Segment lets you change these destination settings from the Segment app without having to touch any code.
SETTING
DESCRIPTION
API Key(required)
string.