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
- Go to
Settings > Tracking Codes > Add tracking code.
A blank tracking code form - In the Tracking code name field, enter the name. It’s used for identifying the code on the list of tracking codes.
- In the Domain name field, enter the URL of the domain (without the protocol).
- 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. - Copy the code.
- Save the configuration by clicking Save.
- 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. - 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.
-
Add the highlighted parameters to the tracking code you created:
Result:function onSyneriseLoad() { SR.init({ 'trackerKey':'XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX', 'customPageVisit': true, 'dynamicContent': { 'virtualPage': true } }); }
The additional initialization parameters disable page visit events and dynamic content retrieval. -
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, triggerSR.event.pageVisit();
andSR.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.
Script version | URI |
---|---|
default: Script with all functionalities |
synerise-javascript-sdk.min.js |
no-cm: Script without Cookie Matching |
synerise-javascript-sdk-no-cm.min.js |
no-wp: Script without WebPush |
synerise-javascript-sdk-no-wp.min.js |
no-wp-cm: Script without WebPush and Cookie Matching |
synerise-javascript-sdk-no-wp-cm.min.js |
no-m-cm-wss: Script without Cookie Matching, Automation-based Dynamic Content, and WebSockets |
synerise-javascript-sdk-no-m-cm-wss.min.js |
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.
_snrs_sa
and _snrs_sb
cookies is 30 minutes and cannot be changed.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.