Celebrate WordCamp Asia 2024 with 30% OFF! Use coupon WC30 - Terms

TrackingPRO

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.

SettingDescription
DurationStores the duration it took to complete the form in seconds.
Remote IP AddressStores 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.
ReferrerStores the web page address a website visitor was on prior to completing the submitted form.
Operating SystemStores the website visitors operating system.
AgentStores the website visitors agent (browser type).
HostnameStores the server hostname.
PathnamePathname of the URL.
Query StringQuery 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 SourceThis can be used to store the UTM (Urchin Tracking Module) source parameter.
UTM MediumThis can be used to store the UTM (Urchin Tracking Module) medium parameter.
UTM CampaignThis can be used to store the UTM (Urchin Tracking Module) campaign parameter.
UTM TermThis can be used to store the UTM (Urchin Tracking Module) term parameter.
UTM ContentThis 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 / VariableAdditional 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.