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 when a user submits or abandons a form.

• Recorded form data includes the values of all input, select, and textarea 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.

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