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). |
| URL Full | Full URL. |
| URL Hostname | Hostname of the 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. Note that some of these can only be used server-side, e.g. in an action such as Send Email or in a custom mapping setting.
| Variable | Name | Description | Usage |
|---|---|---|---|
#tracking_agent | Agent | Stores the website visitors agent (browser type). | Client-side & Actions |
#tracking_duration | Duration | Stores the duration it took to complete the form in seconds. | Actions |
#tracking_geo_location | 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. | Actions |
#tracking_hash | URL Hash | Hash of the URL. | Client-side & Actions |
#tracking_host | URL Hostname | Hostname of the URL. | Client-side & Actions |
#tracking_ip_lookup_city | City (By IP) | If checked, WS Form will perform an IP lookup and obtain the city located closest to their approximate location. | Actions |
#tracking_ip_lookup_country | Country (By IP) | If checked, WS Form will perform an IP lookup and obtain the country located closest to their approximate location. | Actions |
#tracking_ip_lookup_latlon | Location (By IP) | This will obtain an approximate latitude and longitude of a website visitor by their IP address. | Actions |
#tracking_ip_lookup_region | Region (By IP) | If checked, WS Form will perform an IP lookup and obtain the region located closest to their approximate location. | Actions |
#tracking_ip_lookup_time_zone | Time Zone (By IP) | If checked, WS Form will perform an IP lookup and obtain the time zone closest to their approximate location. | Actions |
#tracking_os | Operating System | Stores the website visitors operating system. | Client-side & Actions |
#tracking_pathname | URL Pathname | Pathname of the URL. | Client-side & Actions |
#tracking_query_string | URL Query String | Query string of the URL. | Client-side & Actions |
#tracking_referrer | Referrer | Stores the web page address a website visitor was on prior to completing the submitted form. | Client-side & Actions |
#tracking_remote_ip | Remote IP Address | Stores the website visitors remote IP address, e.g. 123.45.67.89 | Actions |
#tracking_url | URL Full | Full URL. | Client-side & Actions |
#tracking_utm_campaign | UTM Campaign | This can be used to store the UTM (Urchin Tracking Module) campaign parameter. | Client-side & Actions |
#tracking_utm_content | UTM Content | This can be used to store the UTM (Urchin Tracking Module) content parameter. | Client-side & Actions |
#tracking_utm_medium | UTM Medium | This can be used to store the UTM (Urchin Tracking Module) medium parameter. | Client-side & Actions |
#tracking_utm_source | UTM Source | This can be used to store the UTM (Urchin Tracking Module) source parameter. | Client-side & Actions |
#tracking_utm_term | UTM Term | This can be used to store the UTM (Urchin Tracking Module) term parameter. | Client-side & Actions |
