Configuring CDP settings

In Dropsolid Experience Cloud you can configure several parts of your CDP.

All the settings described here can be found in the Settings tab of your CDP.

Domains (required)¶

For your protection, we only allow inbound traffic for allowed domains. Therefore, you need to configure those allowed domains before captures will reach your CDP.

To add, modify or delete the domains linked to your CDP, go to the Allowed Domains subtab of the Settings of your CDP.

There you can see a list of all the current allowed domains for your CDP, and you can add, modify and delete them.

The following values are allowed for the domains:

domain as string: e.g. www.dropsolid.com
IP address and local domains: e.g. 127.0.0.1, localhost

Wildcards are not allowed: e.g. *.dropsolid.com

If you're not sure what domain to use, you can find the domain of your site by typing document.domain in your browser console.

Add-ons¶

There are multiple add-ons you can enable/disable.

These are all optional and allow you to collect more data from users to then use as you please.

These add-ons enrich the user data stored on profiles (and can be used in segments) or can enable the connection with a 3rd party tool.

To configure your add-ons, go to the Profiles subtab of the Settings of your CDP.

There you can see a list of all the current enabled add-ons and their configuration, and you can add and delete them.

Language detection¶

This add-on allows you to know the language of the page users are visiting.

The following data can then be used in segments, with an example:

language: nl

This is where you can find this property in the dropdown-list in segments:

Geolocation¶

This add-on allows you to know where the users are from.

This information is based on their ip-address, but their ip-address is never saved anywhere.

The following data can then be used in segments.

Most important data, with an example:

city: Ghent
country name: Belgium
country code: BE

Other data available from this add-on, with an example:

admin sub div1: 3337388 (more information down below)
admin sub div2: 2789733 (more information down below)
city id: 2797656 (more information down below)
location > lat: 51.047
location > lon: 3.7206
country and city: Belgium@@Ghent@@3337388@@2789733

This is where you can find all of these properties in the dropdown list in segments:

To determine this geolocation data, we use the maxmind GeoLite2-City database.

Note: admin sub div1, admin sub div2 and city id are id's that represent a geoName. More about this can be found here in the maxmind documentation. The last bullet point of the Product Features part gives more information about these id's.

For example:

If we use the same id's as the above example values, then these are the corresponding GeoNames.

admin sub div1: 3337388 => Flanders

admin sub div2: 2789733 => East-Flanders

city id: 2797656 => Ghent

Mautic integration¶

This add-on allows you to link Unomi profiles with Mautic contacts and enrich Mautic contacts with the segment names and uuids from Unomi.

This add-on requires the input of 2 fields:

Segment uuid field
Segment name field

These are aliases of custom fields in Mautic.

The first field will receive the Unomi segment uuids and the second field will receive the Unomi segment names.

If you leave these 2 fields empty, then the Unomi segment data will not be sent to Mautic.

The Mautic id of the user will always be sent to Unomi, regardless of the input from those 2 fields.

How to create custom fields in Mautic¶

Log in as admin in your Mautic and go to Settings (cogwheel in the top right).

There you choose Custom Fields.

There click the New button in the top right, to create a new custom field.

Make sure to fill in the label and the alias of the field.

The alias is what you will have to fill in when enabling this feature in Dropsolid Experience Cloud.

The label is just a human readable name so you know what the field is for.

In the case of this feature, you have to create 2 custom fields. One for the uuids of the Unomi segments and one for the names of the Unomi segments.

Also make sure that the Publicly updatable option is turned on (Yes) so this field can be updated by the capture script.

Remarks¶

Manual integration¶

You can also manually implement this integration if you wish to add extra things on top.

Google Analytics¶

This add-on allows you to send the Unomi segment names to a custom dimension in Google Analytics.

It supports both the Universal Google Analytics and Google Analytics 4, as long as you are using the default function names for them:

ga: Universal Google Analytics
gtag: Google analytics 4

This add-on requires the input of 1 field. What exactly you have to input depends on which Google Analytics version you are using.

When using Universal Google Analytics, you need to input the index of the custom dimension you want to use for the Unomi segment names.

When using Google Analytics 4, you need to input the user property of the custom dimension you want to use for the Unomi segment names.

How to create custom dimensions in Universal Google Analytics¶

Go to the Admin page of your Google Analytics. (cogwheel in the bottom left)

There in the middle column (Property column) scroll down and go to Custom Definitions, Custom Dimensions.

There you can create/edit a custom dimension for the Unomi segment names.

Make sure that the custom dimension has a User Scope.

The Index of this custom dimension is what you will have to input when enabling this feature in Dropsolid Experience Cloud.

Click create or save if you are editing a custom dimension and now your custom dimension is ready to be used.

How to create custom dimensions in Google Analytics 4¶

In the menu on the left side, go to Custom definitions.

There you have 2 tabs. We want the Custom dimensions.

Create a new custom dimension or edit an existing one for the Unomi segment names.