Difference between revisions of "ATC/Current/SDK/Forms: track"
From Genesys Documentation
DannaShirley (talk | contribs) (Published) |
|||
(19 intermediate revisions by 5 users not shown) | |||
Line 2: | Line 2: | ||
|Standalone=No | |Standalone=No | ||
|DisplayName=forms:track | |DisplayName=forms:track | ||
− | |||
|TocName=forms:track | |TocName=forms:track | ||
+ | |Context=Learn how to use the<tt>forms:track</tt> method to capture when visitors complete web-based forms. | ||
+ | |Dimension=DevTracking | ||
|ComingSoon=No | |ComingSoon=No | ||
− | | | + | |Platform=PureConnect, GenesysCloud, GenesysEngage-cloud |
|Section={{Section | |Section={{Section | ||
+ | |alignment=Vertical | ||
+ | |structuredtext={{NoteFormat|1=This article only applies to customers using {{Link-AnywhereElse|product=ATC|version=Current|manual=AdminGuide|topic=About_web_chats|display text=web chat}}. If you are a Genesys Cloud CX customer, we encourage you to use the new {{Link-AnywhereElse|product=ATC|version=Current|manual=AdminGuide|topic=About_web_messaging|display text=web messaging}} feature to replace web chat.|2=}}<br /> | ||
+ | |Status=No | ||
+ | }}{{Section | ||
|sectionHeading=Description | |sectionHeading=Description | ||
− | |||
|alignment=Vertical | |alignment=Vertical | ||
− | + | |structuredtext=The <tt>forms:track</tt> method tracks form submission and abandonment events. By default, forms tracking captures form data when a visitor submits or abandons a form. | |
− | |structuredtext=The <tt>forms:track</tt> method tracks 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 {{Link-SomewhereInThisVersion|manual=SDK|topic=Form_tracking_API|anchor=SensitiveFields|display text=sensitive input strings}}. | ||
+ | {{NoteFormat|For {{MintyDocsProduct}} SDK forms tracking to capture form data, each input requires a properly defined <tt>name</tt> attribute.|}} | ||
+ | |||
+ | For more information, see {{Link-SomewhereInThisVersion|manual=SDK|topic=Form_tracking_API}}. | ||
|Status=No | |Status=No | ||
}}{{Section | }}{{Section | ||
|sectionHeading=Signature | |sectionHeading=Signature | ||
− | |||
|alignment=Vertical | |alignment=Vertical | ||
− | |||
|structuredtext=<tt>ac('forms:track', [selector], [options]);</tt> | |structuredtext=<tt>ac('forms:track', [selector], [options]);</tt> | ||
− | |||
|Status=No | |Status=No | ||
}}{{Section | }}{{Section | ||
|sectionHeading=Arguments | |sectionHeading=Arguments | ||
− | |||
|alignment=Vertical | |alignment=Vertical | ||
− | + | |structuredtext=*[[#selector|selector]] | |
− | |structuredtext=* [[#selector|selector]] | + | *[[#options|options]] |
− | * [[#options|options]] | ||
− | |||
|Status=No | |Status=No | ||
}}{{Section | }}{{Section | ||
|sectionHeading=selector | |sectionHeading=selector | ||
− | |||
|alignment=Vertical | |alignment=Vertical | ||
− | + | |structuredtext=*'''Description:''' CSS selector for the element or elements to track | |
− | |structuredtext=* Description: | + | *'''Type:''' String |
− | * Type: | + | *'''Status:''' Optional |
− | * Status: | + | *'''Default:''' Form |
− | * Default: | ||
− | |||
|Status=No | |Status=No | ||
}}{{Section | }}{{Section | ||
|sectionHeading=options | |sectionHeading=options | ||
− | |||
|anchor=options | |anchor=options | ||
|alignment=Vertical | |alignment=Vertical | ||
− | + | |structuredtext=*'''Description:''' Activity or behavior to track | |
− | |structuredtext=* Description: | + | *'''Type:''' Object |
− | * Type: | + | *'''Status:''' Optional |
− | * Status: | + | *'''Default:''' {} |
− | * Default: {} | + | *'''Properties:''' See the following table. |
− | * Properties: | + | |
{{{!}} class="wikitable" | {{{!}} class="wikitable" | ||
{{!}}- | {{!}}- | ||
Line 63: | Line 61: | ||
{{!}}- | {{!}}- | ||
{{!}}{{!}}captureFormDataOnAbandon | {{!}}{{!}}captureFormDataOnAbandon | ||
− | {{!}}{{!}} | + | {{!}}{{!}} |
− | {{!}}{{!}} | + | {{!}}{{!}}Boolean |
{{!}}{{!}}optional | {{!}}{{!}}optional | ||
{{!}}{{!}}true | {{!}}{{!}}true | ||
− | {{!}}{{!}} | + | {{!}}{{!}} |
{{!}}- | {{!}}- | ||
{{!}}{{!}}captureFormDataOnSubmit | {{!}}{{!}}captureFormDataOnSubmit | ||
− | {{!}}{{!}} | + | {{!}}{{!}} |
− | {{!}}{{!}} | + | {{!}}{{!}}Boolean |
{{!}}{{!}}optional | {{!}}{{!}}optional | ||
{{!}}{{!}}true | {{!}}{{!}}true | ||
− | {{!}}{{!}} | + | {{!}}{{!}} |
{{!}}- | {{!}}- | ||
{{!}}{{!}}transform | {{!}}{{!}}transform | ||
− | {{!}}{{!}} | + | {{!}}{{!}} |
{{!}}{{!}}function | {{!}}{{!}}function | ||
{{!}}{{!}}optional | {{!}}{{!}}optional | ||
− | {{!}}{{!}} | + | {{!}}{{!}} |
{{!}}{{!}}formDataObject | {{!}}{{!}}formDataObject | ||
{{!}}- | {{!}}- | ||
{{!}}{{!}}traitsMapper | {{!}}{{!}}traitsMapper | ||
− | {{!}}{{!}} | + | {{!}}{{!}} |
{{!}}{{!}}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 | ||
+ | {{!}} | ||
+ | {{!}} | ||
+ | {{!}}}<br /> | ||
+ | ====Example==== | ||
+ | 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:<syntaxhighlight lang="javascript">{ | ||
+ | captureFormDataOnSubmit: [ | ||
+ | 'forms:track', 'sign-up-form', { captureFormOnSubmit: true, customAttributes: {formValue: 200} | ||
+ | ] | ||
+ | } | ||
+ | </syntaxhighlight> | ||
+ | ====Use events to track outcome value==== | ||
+ | <span> </span> | ||
+ | |||
+ | Use the attributes from the form:track SDK to {{Link-SomewhereInThisVersion|manual=AdminGuide|topic=Manage_outcomes|display text=track an outcome}} from {{Link-SomewhereInThisVersion|manual=AdminGuide|topic=About_action_maps|display text=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. | ||
|Status=No | |Status=No | ||
}} | }} | ||
}} | }} |
Latest revision as of 13:00, September 20, 2022
This topic is part of the manual Journey JavaScript SDK for version Current of Genesys Predictive Engagement.
Contents
Learn how to use theforms:track method to capture when visitors complete web-based forms.
Important
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.Description
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.
Important
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.
Signature
ac('forms:track', [selector], [options]);
Arguments
selector
- Description: CSS selector for the element or elements to track
- Type: String
- Status: Optional
- Default: Form
options
- 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 |
Example
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.
Comments or questions about this documentation? Contact us for support!