A lightweight JavaScript library for preserving user data from first website visit to signup.
The library stores data such as utm_medium
, landing_page
and referrer
in a localStorage object, and makes the object available via a handy API with the following methods:
Purser.create() // automatically called on first website visit
Purser.fetch() // returns the object
Purser.convert(obj) // returns the object updated with conversion data
Purser.update(obj) // lets you add additional parameters to the object
Purser.destroy // removes the object from localStorage
View a live example at http://purser.herokuapp.com/.
git clone https://github.com/bilbof/purser
- Add purser.js to every page on your website. When a visitor creates an account, call purser.convert(obj) and add the user to your CRM/ChartMogul with attributes returned.
- When a visitor creates an account, call purser.convert(obj) to get the visitor's marketing attributes
- Add the user's marketing attributes to them in your CRM or app
See an example at http://github.com/bilbof/purser/example.
Code example
<script src="purser.js"></script>
<script>
$('.red-signup-button').click(function(){
var attributes = purser.convert({
signup_button: "red-signup-button"
});
// here send the customer object to your CRM/app with their attributes
});
</script>
The attributes
object in the example above would look something like this:
{
"first_website_visit": "2017-02-19T17:52:18.088Z",
"referrer": "www.google.co.uk",
"browser_timezone": 0,
"browser_language": "en-GB",
"landing_page": "http://localhost:5000/product",
"screen_height": 800,
"screen_width": 1280,
"utm_medium": "google_search_ads",
"utm_source": "google",
"signup_button": "red-signup-button",
"converted_at": "2017-02-19T17:52:41.981Z",
"conversion_page": "http://localhost:5000/signup"
}