urlscan.io logo urlscan.io
SecurityTrails logo

dashboard.hullapp.io Open in urlscan Pro
54.83.250.134  Public Scan

Back to summary
Submitted URL: http://5510781b.web.hullapp.io/
Effective URL: https://dashboard.hullapp.io/readme?url=https://5510781b.web.hullapp.io
Submission: On April 12 via manual from US — Scanned from DE

Form analysis 0 forms found in the DOM

Text Content

 * Hull

TRACK WEB TRAFFIC AND INTEGRATE WITH OTHER CLIENT SIDE SERVICES.


WEBSITE CONNECTOR

The website connector makes it easy to send your website data to Hull and any
connected tool using the Hull.js library. It allows to track the website traffic
and merge it with data coming from other services.


INSTALLATION

This connector integrates with a website through a single HTML tag which then
lets you control it's behaviour entirely from the Settings section.

 1. First, go to the settings pane and whitelist the domains you would like to
    authorize and get data from.

> Note 1: You can use the wildcard entry to whitelist all subdomains of specific
> domain. Example: whitelisting *.website.com will whitelist en.website.com,
> de.website.com, fr.website.com... etc.

> Note 2: By default connector expects HTTPS to be available on whitelisted
> domains, if you want to allow non-https website to load Hull.js you need to
> explicitly add http:// protocol in front of the domain in the whitelist.

 2. Then, copy the HTML tag show below the whitelist and paste it in the <head>
    section of your website. You may need to refer to your website system to
    know how to embed the code, but below we provide guides for common systems.



> Note: If you are using Google Tag Manager, make sure to checkout the Guide on
> how to set up Hull.js with Google Tag Manager


GENERAL NOTES

Whitelist reference

The domain whitelist controls Content Security Policy header used for the
Hull.js library. Check header reference for all possible configuration options.

Caching

Due to performance reasons the configuration of the Hull Website tag is cached
for 5 minutes, so you may need to wait for your changes to take effect. This
affects all settings of the connector. On your own browser you can clean the
cache or hot-reload the page to see the changes immediately.

Deactivation

When website connector is deactivated the Hull.js snippet won't run at all. No
tracking will be performed and none of the additional scripts will be loaded to
the page.


TRACKING

Tracking of web traffic is performed by Hull.js. To learn more about how it
works, checkout the Hull.js Guide.

By default this connector provides automatic tracking of page view events and
default identity resolution.

Automatic Page tracking can be disabled in the settings of the Website connector
and replace by your own custom tracking which can be implemented through
additional javscript code deployed to the website.

Further customization capabilities are described at length in the Hull.js
reference.




EMBEDDED AND EXTERNAL SCRIPTS

To make the customization easier the connector comes with support for Embedded
Script and External Scripts, allowing you to quickly and easily deploy
additional javascript code.

 * External Scripts let you load additional code libraries without having to
   edit your website. Hull will load them asynchronously, without blocking the
   page. This is also the recommended way of deploying client-side parts of
   other connectors to integrate with external services not only on the back-end
   but also on the front-end.

 * Embedded Script let you quickly deploy code to the website Hull connector is
   installed in. This allows to adjust the tracking plan without constant
   updates to the website.




CLIENT-SIDE CONNECTORS

Some connector for specific services such as Intercom can also have a
Client-side component that you should inject using the Embedded Scripts feature,
to establish some connection between Hull and the service. Here is a list of the
supported Client-side connectors:

connector url intercom https://hull-intercom.herokuapp.com/ship.js


BEST PRACTISES

Deploying javascript code to a website when using Hull connector is easy, but
it's important to keep in mind some best practises to avoid problems with
front-end code.

Wrap code in self-executing functions

It's very easy to pollute website global namespace which leads to risk of
overwriting existing variables and function names. We recommend you wrap every
custom code deployed to website with self-executing or self-invoking function.

// BAD: not wrapped code, pollutes global namespace
var foo = 'Hello';

// GOOD: wrapped function, no risk of collision
(function() {
  var foo = 'Hello';
})();