forms: track

From Genesys Documentation
Jump to: navigation, search
This topic is part of the manual Journey JavaScript SDK for version Current of Genesys Predictive Engagement.

Learn how to use theforms:track method to capture when visitors complete web-based forms.

This article only applies to customers using web chat. If you are a Genesys Cloud CX customer, we encourage you to use the new web messaging feature to replace web chat.


The forms:track method tracks form submission and abandonment events. By default, forms tracking captures form data when a visitor submits or abandons a form.

  • Recorded form data includes the values of all input, select, and text area fields.
  • Recorded form data excludes the values of hidden, submit, and password fields, along with any fields that contain any of the sensitive input strings.
For Genesys Predictive Engagement SDK forms tracking to capture form data, each input requires a properly defined name attribute.

For more information, see Form Tracking API.


ac('forms:track', [selector], [options]);



  • Description: CSS selector for the element or elements to track
  • Type: String
  • Status: Optional
  • Default: Form


  • Description: Activity or behavior to track
  • Type: Object
  • Status: Optional
  • Default: {}
  • Properties: See the following table.
Name Description Type Status Default Arguments
captureFormDataOnAbandon Boolean optional true
captureFormDataOnSubmit Boolean optional true
transform function optional formDataObject
traitsMapper traitsMapper
customAttributes Field used to send additional information when a form-related event occurs. The field can be set with static, predetermined values. Once the form tracker module initiates, the value that is available in the value field is applied for the rest of the session. The value cannot be changed dynamically according to user action. There can be more than one field. object optional


To create an event to track the number of customers who sign themselves up from the sign-up page, use the customAttributes within the form:track SDK as follows:
captureFormDataOnSubmit: [
'forms:track', 'sign-up-form', { captureFormOnSubmit: true, customAttributes: {formValue: 200}

Use events to track outcome value

Use the attributes from the form:track SDK to track an outcome from action maps. You can further use the value set within the SDK to the define the value of the outcome. In this example, the value of sign up is set at 200. This means that if the outcome value of the outcome stands at 2000, the total number of sign ups is 10 whose with a total value of 2000.

Retrieved from " (2024-05-26 20:31:03)"
Comments or questions about this documentation? Contact us for support!