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. |
| URL Full | Full URL. |
| URL Pathname | Pathname of the URL. |
| URL Query String | Query string of the URL. |
| URL Hash | Hash 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). For more information about this variable, click here. |
Duration#tracking_duration | Stores the duration it took to complete the form in seconds. For more information about this variable, click here. |
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. For more information about this variable, click here. |
URL Hash#tracking_hash | Hash of the URL. For more information about this variable, click here. |
Hostname#tracking_host | Stores the server hostname. For more information about this variable, click here. |
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. For more information about this variable, click here. |
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. For more information about this variable, click here. |
Location (By IP)#tracking_ip_lookup_latlon | This will obtain an approximate latitude and longitude of a website visitor by their IP address. For more information about this variable, click here. |
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. For more information about this variable, click here. |
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. For more information about this variable, click here. |
Operating System#tracking_os | Stores the website visitors operating system. For more information about this variable, click here. |
URL Pathname#tracking_pathname | Pathname of the URL. For more information about this variable, click here. |
URL Query String#tracking_query_string | Query string of the URL. For more information about this variable, click here. |
Referrer#tracking_referrer | Stores the web page address a website visitor was on prior to completing the submitted form. For more information about this variable, click here. |
Remote IP Address#tracking_remote_ip | Stores the website visitors remote IP address, e.g. 123.45.67.89 For more information about this variable, click here. |
URL Full#tracking_url | Full URL. For more information about this variable, click here. |
UTM Campaign#tracking_utm_campaign | This can be used to store the UTM (Urchin Tracking Module) campaign parameter. For more information about this variable, click here. |
UTM Content#tracking_utm_content | This can be used to store the UTM (Urchin Tracking Module) content parameter. For more information about this variable, click here. |
UTM Medium#tracking_utm_medium | This can be used to store the UTM (Urchin Tracking Module) medium parameter. For more information about this variable, click here. |
UTM Source#tracking_utm_source | This can be used to store the UTM (Urchin Tracking Module) source parameter. For more information about this variable, click here. |
UTM Term#tracking_utm_term | This can be used to store the UTM (Urchin Tracking Module) term parameter. For more information about this variable, click here. |