javascript-1flow-sdk
v1.0.2
Published
1Flow is a smart in-app survey platform for technology startups. This is the official package for 1Flow Javascript SDK. Visit 1flow.app for more information.
Downloads
206
Maintainers
Readme
Get Started
You can embed our Javascript SDK into any website or web application through NPM.
1. Install node package via npm
Run the below command in terminal in your app’s directory:
npm install javascript-1flow-sdk
2. Initialize 1Flow SDK
Place the below code inside your web app:
import { oneflow } from 'javascript-1flow-sdk';
oneflow.oneFlowInit('<your-project-api-key>')
3. Track events
You need to track events in order to use these events as triggers of 1Flow in-app surveys.
- You can give an event contextual info by placing any key-value pairs inside the
{}
:
import { oneflow } from 'javascript-1flow-sdk';
oneflow.logEvent("event_name",{item_id:"123",type:"legos"});
- You can also log events without any parameters:
import { oneflow } from 'javascript-1flow-sdk';
oneflow.logEvent("event_name");
Example usage
Let’s say you want to trigger an event on a button click. You just need to log that button click event, and then that event can be used to trigger a survey:
import { oneflow } from 'javascript-1flow-sdk';
myFunction() {
...
oneflow.logEvent("event_name");
}
3. Log user (optional)
If your app requires the user to register an account and sign in, you can call a method to bind the user with 1Flow. This way, you'll be able to connect the data with your internal records.
Whenever the user has signed in, you can call oneflow.logUser()
to pass the user identifier, along with any other parameters you'd like to store with us, to 1Flow.
import { oneflow } from 'javascript-1flow-sdk';
const parameter={'firstName': 'steve', 'lastName': 'jobs', 'number': 123456 }; //parameters are optional.
oneflow.logUser(userId, parameter); // parameters are optional, if no parameters, then only pass in userId
Show your first survey
Now that you've successfully integrated 1Flow into your SDK, it's time to create your first survey.
If you've already created a survey and published it (survey shows up in the "In Progress" section of the dashboard), run the app and trigger the event to happen, you should see the survey show up when the event is fired.