Topics

Overview

The legacy way to connecting your website and platform is through a front-end integration with our JavaScript connector.

It requires placing a code snippet to your body section, potentially with some additional calls to identify users and accounts, and to send events, screens and page views to journy.io. The JavaScript calls itself are described in the following doc: https://developers.journy.io/#section/Frontend.

This article describes the setup of the JavaScript connector named "Website" in journy.io connection.

How to connect "Website" JavaScript to journy.io

Go to your connections and navigate to the legacy tab. Click the 'Connect' button under the Website logo:

Open

The following screen will appear:

Open

Here's what to fill in:

• Domain: The is the top-level domain of your website or application. Even if e.g. your application is on e.g. tools.app.example.com, your top-level domain would be example.com.

• Tracking subdomain: This is the subdomain handler that will be used to track traffic. In above example, you could choose go.example.com.

• Allow any domain: Some of the applications being monitored front-end, serve as landing page for your customers. You customers will then typically route their subdomain to your own domain. In the same example as before, a customer might route sub.customer-example.com to landingpage.example.com. We will only track customer-routed traffic when this option is switched on. If not, we will only track traffic from the top-level domain set above.

• Validate email addresses: If this option is switched on, we will check for fake and time-limited email addresses and only allow valid email addresses.

• Identify users with URL Parameters: This option is to allow users to be identified with a certain URL parameter — e.g. www.example.com/?jmail=hi@journy.io

  • Email URL parameter name: is the parameter name to be used to identify users. In above example, we set it to 'jmail'.

  • Remove email URL parameter when user is identified? After the user was identified, you may want to remove the parameter from the URL bar, to prevent copying it.

Review JavaScript settings

Going to your Connection→Website settings, you can choose JavaScript settings tab:

In general, you can find your site details to install on various destinations. For the journy.io WordPress plugin, we ask you for Tracking ID and SiteID. For a lot of other destinations (WebFlow, Native HTML, Shopify...) you can simply copy-paste the snippet.