The Fresh Relevance software development kit (SDK) is a set of tools designed to give you full control over how your website integrates with Fresh Relevance. Using a combination of data imports and web API calls through the Dotdigital Tag, you can control what data you track and send to Fresh Relevance, and how you do it.

Learn more about the Fresh Relevance SDK.

The Dotdigital Tag streamlines the process of connecting your website activity and data to our platforms. You can use the Tag to make your tracking data available across both Dotdigital and Fresh Relevance.

You can use a single implementation of the Dotdigital Tag to track:

Website views
User identification
Products browsed
Cart updates
Purchase completions
Custom events, as defined by you

Custom events are only available on certain account packages. Contact your Customer Success representative to discuss.

Learn more in Use events with the Dotdigital Tag.

Before you start

Things you need to know:

Abandoned cart and browse functionality is configured in Fresh Relevance, and not through the Dotdigital Tag settings, but you must still extend the Tag to track browsing and cart data.

Learn more

Create your Dotdigital Tag

Log in to Dotdigital, then go to Connect and select Connect website.
Select NEW CONNECTION.
Enter your website name for this connection.
In the Domains field, enter each domain that you want to track on a new line.
Don’t include https:// or www..
Select SAVE.

Tracking subdomains

Subdomains of a specified parent domain are automatically tracked, so you don’t need to specify them separately. If you want to track activity for a specific subdomain only, list it without the parent domain.

Dotdigital Tag connection settings

Set Enable Web behaviour tracking to YES to track your site visitors’ browsing behaviour.
To power abandoned cart and browse, you must make some customisations to the Tag. Learn how in Extend the Dotdigital Tag for abandoned cart and browse.
Set Enable Chat to Yes to embed the Chat widget on your site.
This feature allows you to offer one-to-one customer support through a two-way chat on your site. Learn more in Get started with Chat.
Set Enable Fresh Relevance to Yes.
Your accounts must already be connected for this setting to be available. Otherwise, you see a link to Learn more. Contact your Customer Success representative in this case.
To enable one-click publishing and automatic updates to Dotdigital Surveys, pages, and forms popups, set Enable popup publishing to Yes.
Learn more in Add a popup to your site.

Abandoned cart and browse

Leave these settings in Dotdigital unconfigured. Once the extended Tag is added to your site, you can manage cart and browse abandon triggers in Fresh Relevance.

Learn more in Set up cart and browse abandonment messages.

Advanced settings

Set Require cookie consent to Yes to ensure cookies are only stored on a visitor’s browser after consent is given.

You can use the following methods to integrate this feature with your existing cookie management system:
- To deny consent: ddg.setCookiesConsent(false);
- To grant consent: ddg.setCookiesConsent(true);
Set Enable guest carts to Yes to create a contact in Dotdigital for visitors who abandon a cart but are not yet contacts in your account.
You must ensure you have collected the necessary consent before sending any marketing communications to these contacts. This setting applies to contacts in Dotdigital only, and does not affect contact records in Fresh Relevance.
Set Track order insights from purchaseComplete events to Yes to create an order Insight record for each purchaseComplete event tracked by the Tag.
This is only recommended if you aren’t already syncing your order data through another method, such as an ecommerce integration.
Select SAVE to confirm your configuration.

Regulatory settings for guest carts

For Dotdigital, we strongly recommend leaving your Regulatory settings on Enforce double opt-in for signups from signup forms and some API methods only (default). If you enforce double opt-in for all signups, then we don't recommend using abandoned cart emails for guests, as the process won't work correctly.

Deploy and test

Select VIEW CODE to see the Tag that has been generated for your account.
Select COPY TO CLIPBOARD.
Paste your Connection code onto each page of your website, before the closing </body> tag.

You can install the Dotdigital Tag through a tag manager if you want to.

Test the installation

Select TEST to check the installation of the Dotdigital Tag, and enter a URL to test.
Select TEST again to check that the Tag is correctly installed on the specified page.

If there are any issues with the installation, you see a message with information about the error and the steps to take to fix it.

After you have saved your connection and added the Dotdigital Tag to your site, it may take some time before you start seeing data be populated. You can expect to results within about an hour, depending on the amount of web traffic your site receives. This built-in delay ensures that the data is accurately captured and processed.

If you don’t see any data after a few hours, check that the Tag has been correctly added to your website and that it’s not being blocked or affected by any other scripts running on your site.

For further assistance, contact our Support team.