WS Form provides several built-in tracking attributes to provide you with information about the website visitors using your form.
When a form is saved or submitted, you have the option of attaching the tracking attributes to a submission.
Tip: You are advised to make it clear to website visitors that you are storing such information to ensure your website is GDPR compliant.
In order to comply with GDPR, tracking attributes are disabled by default. If you switch these on, you should make it clear to the users of your form that you are tracking this information and also provide a checkbox to acknowledge that the user is providing consent for you to store such information.
To enable or disable tracking attributes, click the form settings icon in the top toolbar when editing a form. The form settings sidebar will then appear on the right side of the page.
The available tracking features are as follows.
| Setting | Description |
|---|---|
| Duration | Stores the duration it took to complete the form in seconds. |
| Remote IP Address | Stores the website visitors remote IP address, e.g. 123.45.67.89 |
| Location (By browser) | If a website visitors device supports geo location (GPS) this option will prompt and request permission for that data and store the latitude and longitude to a submission. |
| Location (By IP) | This will obtain an approximate latitude and longitude of a website visitor by their IP address. |
| Referrer | Stores the web page address a website visitor was on prior to completing the submitted form. |
| Operating System | Stores the website visitors operating system. |
| Agent | Stores the website visitors agent (browser type). |
| Hostname | Stores the server hostname. |
| Pathname | Pathname of the URL. |
| Query String | Query string of the URL. |
| City (By IP) | If checked, WS Form will perform an IP lookup and obtain the city located closest to their approximate location. |
| Region (By IP) | If checked, WS Form will perform an IP lookup and obtain the region located closest to their approximate location. |
| Country (By IP) | If checked, WS Form will perform an IP lookup and obtain the country located closest to their approximate location. |
| Time Zone (By IP) | If checked, WS Form will perform an IP lookup and obtain the time zone closest to their approximate location. |
| UTM Source | This can be used to store the UTM (Urchin Tracking Module) source parameter. |
| UTM Medium | This can be used to store the UTM (Urchin Tracking Module) medium parameter. |
| UTM Campaign | This can be used to store the UTM (Urchin Tracking Module) campaign parameter. |
| UTM Term | This can be used to store the UTM (Urchin Tracking Module) term parameter. |
| UTM Content | This can be used to store the UTM (Urchin Tracking Module) content parameter. |
WS Form requests free IP lookups from geoPlugin, which uses GeoLite data created by MaxMind, available from http://www.maxmind.com. WS Form provides no warranty as to the accuracy or reliability of this data. Please see geoPlugin’s Acceptable Use Policy for more information.
Showing Tracking Data in Emails
If you want to show tracking data in an email acknowledgement you can add #email_tracking to your email content.
Variables
The following variables can be used to insert the various tracking values. These can only be used server-side, e.g. in an action such as Send Email or in a custom mapping setting.
| Name / Variable | Additional Information |
|---|---|
Agent#tracking_agent | Stores the website visitors agent (browser type). |
City (By IP)#tracking_ip_lookup_city | If checked, WS Form will perform an IP lookup and obtain the city located closest to their approximate location. |
Country (By IP)#tracking_ip_lookup_country | If checked, WS Form will perform an IP lookup and obtain the country located closest to their approximate location. |
Duration#tracking_duration | Stores the duration it took to complete the form in seconds. |
Hostname#tracking_host | Stores the server hostname. |
Location (By IP)#tracking_ip_lookup_latlon | This will obtain an approximate latitude and longitude of a website visitor by their IP address. |
Location (By browser)#tracking_geo_location | If a website visitors device supports geo location (GPS) this option will prompt and request permission for that data and store the latitude and longitude to a submission. |
Operating System#tracking_os | Stores the website visitors operating system. |
Pathname#tracking_pathname | Pathname of the URL. |
Query String#tracking_query_string | Query string of the URL. |
Referrer#tracking_referrer | Stores the web page address a website visitor was on prior to completing the submitted form. |
Region (By IP)#tracking_ip_lookup_region | If checked, WS Form will perform an IP lookup and obtain the region located closest to their approximate location. |
Remote IP Address#tracking_remote_ip | Stores the website visitors remote IP address, e.g. 123.45.67.89 |
Time Zone (By IP)#tracking_ip_lookup_time_zone | If checked, WS Form will perform an IP lookup and obtain the time zone closest to their approximate location. |
UTM Campaign#tracking_utm_campaign | This can be used to store the UTM (Urchin Tracking Module) campaign parameter. |
UTM Content#tracking_utm_content | This can be used to store the UTM (Urchin Tracking Module) content parameter. |
UTM Medium#tracking_utm_medium | This can be used to store the UTM (Urchin Tracking Module) medium parameter. |
UTM Source#tracking_utm_source | This can be used to store the UTM (Urchin Tracking Module) source parameter. |
UTM Term#tracking_utm_term | This can be used to store the UTM (Urchin Tracking Module) term parameter. |