Skip to content
master
Switch branches/tags
Go to file
Code

Latest commit

 

Git stats

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
 
 
src
 
 
 
 
 
 

README.md

utmkeeper

It is a library built to persist the utm tracking codes throughout navigation across your landing pages.

It works by extracting them from the navigation url and applying it to all page links and forms.

Usage

At the end of the html <body> add a reference to the script and then call the load function to let the magic begin:

<script src="path/to/utmkeeper.js" charset="utf-8"></script>
<script charset="utf-8">
  utmkeeper.load();
</script>

The load function starts utmkeeper and makes all the magic and it can receive a configuration parameter:

{
  forceOriginUTM: true,
  fillForms: true,
  utmObject: {},
  postLoad: null,
}
  • forceOriginUTM: if true the url utms of the page will override any utm present at the links and forms
  • fillForms: if true all forms will be added the utms, if it does not have the inputs for that hidden ones will be created
  • utmObject: an object where the utms will be stored, you can use it to send initial utm values to the utmkeeper, if it collides with a url UTM it will be overridden
  • postLoad: receives a function with one parameter, that function will be runned at the end of load passing an object with the parsed utms of the url to run any custom logic

One example of calling load with the post load function will be like this:

utmkeeper.load({
  forceOriginUTM: true,
  fillForms: true,
  utmObject: {
    utm_test: 'test'
  },
  postLoad: function(utms){console.log(utms);}
});

About

Keep utm tracking codes throughout navigation across your landing pages

Resources

Packages

No packages published