Importing website data with Hull.jsUpdated 01/05/2019

Tracking users via Hull.js on your website is fairly easy; all you have to do is to install the hull.js snippet on your website. This can be done manually within the source of your site, or the snippet can be deployed via Google Tag Manager.

Add hull.js to your Hull account

Hull.js is deployed through the Website connector.

First, find the connector in the gallery and install it.


When the connector is installed in your organization navigate to the settings pane where the rest of configuration is done.


At the top of the screen you can change the name and add description of the connector. This is entirely optional.

Actual Hull.js installation starts below where you need to define all domains where you want Hull.js to run on.


You can define multiple entires and use asterisk character * as a wildcard. See documentation of the connector for further details.

When you're ready, click the "Save changes" button.

Below the whitelist you'll see the unique snippet that you'll need to use in order to install hull.js on your site.


Installing the Snippet

To manually install hull.js, follow these simple steps.

  1. Copy your unique snippet from the newly created hull.js platform. website-configuration3

  2. Add your hull.js snippet to the of your website website-snippet

If you just want to send anonymous traffic to Hull, you're done! Hull will automatically capture your traffic and show it in the Users section of your Dashboard.

If you want to capture know user data (as opposed to anonymous users), you need to identify those users when you know about them.

Identifying users

User Email

Identifying users allows to tie Email information and custom attributes to the users who visit your website in Hull.

Once an anonymous user on your website fills out a contact form with an email address you can use hull.js to capture this email. This will apply the identity resolution with the email address and anonymous_id (cookie value) so you have a unified user profile.

Here is how to perform the call:

hull.traits({ email: "" });

The Hull platform will detect users with the same email address if any exists, and merge them automatically into a unified profile.


Attributes are values that are associated to the User. Here's how you would pass those:

  preferred_language: "French"

Note: You don't need to pass the email at every call. Once data has been passed, you don't need to send it again.

There are a few special attributes you want to treat specifically, Read about them here Special, reserved attributes

How to track Track Custom events and attributes

The Hull.js library is a very powerful tracking snippet, that works cross-domain, can send any custom event, syndicate and centralize your tracking plan and inject custom behaviours. For a complete reference, please checkout the Hull.js Documentation to learn everything about it.