πŸŽ‰ 1Flow is proudly backed by Y Combinator.
logo

Get Started

You can embed our Javascript SDK into any website or web application.

1. Embed our script

Copy and paste the below code snippet inside the header (<head>) section of your site. Place the tracking script between theΒ <head> … </head>Β tags.
javascript
<script src="https://1flow.app/js/1flow.js" data-api-key="your-project-api-key"></script>
πŸ’‘
Note: you need to replace "your-project-api-key" with your actual project API key. Click here and navigate to Project Settings to get your key in the API keys section.

2. 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 {}:
javascript
<script > _1flow.logEvent("event_name",{item_id:"123",type:"legos"}); </script >
  • You can also log events without any parameters:
javascript
<script > _1flow.logEvent("event_name");</script >

Example usage

Let’s say you want to trigger an event on button click. You just need to log that button click event, and then that event can be used to trigger a survey:
javascript
myButton = document.getElementById("some-btn") myButton.onclick = myFunction; function myFunction() { _1flow.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 _1flow.logUser() to pass the user identifier, along with any other parameters you'd like to store with us, to 1Flow.
javascript
const parameter={'firstName': 'steve', 'lastName': 'jobs', 'number': 123456 }; //parameters are optional. <script> _1flow.logUser(userId, parameter); </script> // 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.

Helpful?