forms: track

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

Description

The forms:track method tracks form submission and abandonment events. By default, forms tracking captures form data upon submit or abandon.

• 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 following sensitive input strings:
  • pass
  • billing
  • creditcard
  • cardnum
  • ^cc
  • ccnum
  • exp
  • seccode
  • securitycode
  • securitynum
  • cvc
  • cvv
  • ssn
  • socialsec
  • socsec
  • csc

Important

In order for Altocloud SDK forms tracking to capture form data, each input needs to have a properly defined name attribute.

See also Form Tracking API.

Signature

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

Arguments

• selector
• options

selector

• Description: The element you want to track.
• Type: string
• Status: optional
• Default: form

options

• Description: The activity or behavior that you want to track.
• Type: object
• Status: optional
• Default: {}
• Properties:

Name	Description	Type	Status	Default	Arguments
captureFormDataOnAbandon		boolean	optional	true
captureFormDataOnSubmit		boolean	optional	true
transform		function	optional		formDataObject
traitsMapper		traitsMapper