Installation and configuration

Synerise works on customers’ online and offline data.
To analyze the activity of your customers, you need to track their actions on the website. You can do this by embedding tracking codes in your pages. You can also use Google Tag Manager.

Creating a tracking code

1. Go to Settings > Tracking Codes > Add tracking code.

   

2. In the Tracking code name field, enter the name. It’s used for identifying the code on the list of tracking codes.
3. In the Domain name field, enter the URL of the domain (without the protocol).
4. From the Select features dropdown list, define the scope of features the tracking code will cover.
   You can find more information about possible tracking code variants further in this article.
5. Copy the code.
6. Save the configuration by clicking Save.
7. Paste the copied code into the source of your web pages before the closing </body> tag.
   Important: If you want to use a custom domain to treat Synerise tracking as first-party, see Third-party and first-party tracking.
   To apply the custom domain, in the tracking code, replace the default URL of the JS SDK script (//www.snrcdn.net/sdk/3.0/synerise-javascript-sdk.min.js) with the one you received from the Synerise Customer Success & Implementation team.
8. If you are creating a single page application, modify the tracking code according to this section.

Tracking code in Single Page Applications

If your website is a Single Page Application (SPA), the tracking code must be modified. The modification changes the mechanism of sending page visit events and retrieving dynamic content.

1. Add the highlighted parameters to the tracking code you created:

       function onSyneriseLoad() {
           SR.init({
               'trackerKey':'XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX',
               'customPageVisit': true,
               'dynamicContent': {
                   'virtualPage': true
               }
           });
       }

   Result:
   The additional initialization parameters disable page visit events and dynamic content retrieval.

2. Re-enable page visit tracking and dynamic content retrieval by implementing the following methods in the page:

   SR.event.pageVisit()
       .then(function () {
           SR.dynamicContent.get();
   })

   Important:

   Page visits and dynamic content retrieval must be implemented according to the following rules:

   • og:tags must be loaded first, regardless of the method that is used to load them
   • page visits and dynamic content must be requested whenever the page is loaded, reloaded, and when the view changes
   Tip: You can use Google Tag Manager to implement the methods. To do so, trigger SR.event.pageVisit(); and SR.dynamicContent.get(); methods on events that indicate a page or DOM being loaded. SR.init is only called when DOM is loaded.

Tracking script variants (no custom domain)

We have several variants of our Javascript SDK that you can use depending on the required features.

Fewer features usually result in smaller page size and shorter load times.

Additional tracking configuration parameters

The only required parameter during the initialization of the tracking code is the trackerKey parameter.
By using the additional parameters described below, you can modify the configuration of the tracking code.

Google dataLayer

If you use Google Data Layer, you can connect it with Synerise.

To track transactions, you need to use Universal Analytics enhanced e-commerce or Google Analytics 4 e-commerce.

SR.init({
    'trackerKey':'XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX',
    'dataLayer':dataLayer,
    'gaVersion': 'CHOOSE_VERSION'
});

The gaVersion parameter is used to set the Google Analytics version.

• If you only use one GA version on your website, you don’t need to add this parameter.
• To send events to Universal Analytics, set the value to UA
• To send events to Google Analytics 4, set the value to GA4

Subdomains

If you are using several subdomains, you can limit tracking to only generate data for particular domains. To do that, add the domain name in the script:

SR.init({
    'trackerKey':'XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX',
    'domain':'.example.com'
});

Automatic tracking of page visits

You can turn off the automatic collection of page visit events with the customPageVisit parameter.
In this case, events should be sent manually using the SDK methods.

SR.init({
    'trackerKey':'XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX',
    'customPageVisit':true
});

Synerise webpush worker scope

If you use Synerise webpush and need to set a custom service worker scope (registration path), you can enter that path as a parameter.

SR.init({
    'trackerKey':'XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX',
    'webpush':{
        'service_worker_scope':'/pl/'
    }
});

Disabling modules

Additionally, if you need to disable some Synerise modules on a specific sub-page or domain, you can do it by specifying the parameters as below:

SR.init({
    'trackerKey':'XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX',
    'disableMessenger':true,
    'disableFormMarker':true,
    'disableWebPush':true,
    'disableDynamicContent':true,
    'disableNotification':true
});

Cookie expiration

By default, the _snrs_p, _snrs_uuid, and _snrs_puuid cookies expire after 30 years. You can change this by using the cookieExpiration parameter. The value is the number of days after which the cookies expire.

The following example sets cookie expiration time to 60 days:

SR.init({ 
    'trackerKey': 'xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx',
    'cookieExpiration': 60
});

Authentication

Requests to the SDK may require customer authentication. For more details, see this article.