Difference between revisions of "ATC/Current/SDK/autotrackClick"
(Published) |
|||
(3 intermediate revisions by 3 users not shown) | |||
Line 3: | Line 3: | ||
|DisplayName=autotrackClick | |DisplayName=autotrackClick | ||
|TocName=autotrackClick | |TocName=autotrackClick | ||
− | |Context=Learn how to configure which click events {{MINTYDOCSPRODUCT}} tracks on your websites. This configuration provides more accurate page tracking information for use in segments and outcomes | + | |Context=Learn how to configure which click events {{MINTYDOCSPRODUCT}} tracks on your websites. This configuration provides more accurate page tracking information for use in segments and outcomes. |
|Dimension=Modules | |Dimension=Modules | ||
|ComingSoon=No | |ComingSoon=No | ||
|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 | ||
|anchor=Description | |anchor=Description | ||
Line 45: | Line 49: | ||
|structuredtext='''Description:''' Identifies an array of click events to track. | |structuredtext='''Description:''' Identifies an array of click events to track. | ||
− | '''Type:''' Object | + | '''Type:''' Object |
− | '''Properties:''' See the following table. | + | '''Properties:''' See the following table. |
+ | {{{!}} class="wikitable" | ||
+ | {{!}}+ | ||
+ | !Name | ||
+ | !Description | ||
+ | !Type | ||
+ | !Status | ||
+ | {{!}}- | ||
+ | {{!}}selector | ||
+ | {{!}}String that selects elements. For more information, see https://developer.mozilla.org/en-US/docs/Web/API/Element/matches | ||
+ | {{!}}String | ||
+ | {{!}}required | ||
+ | {{!}}- | ||
+ | {{!}}eventName | ||
+ | {{!}}String used as the event name when an element matching the selector is clicked. | ||
+ | {{!}}String | ||
+ | {{!}}required | ||
+ | {{!}}- | ||
+ | {{!}}customAttributes | ||
+ | {{!}}Field used to send additional information when the selector is clicked. The field can be set with static, predetermined values. Once the autotrackClick 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.<br /> | ||
+ | {{!}}Object | ||
+ | {{!}}optional | ||
+ | {{!}}} | ||
+ | ====Example==== | ||
+ | To create an event to track the number of clicks on the green button, use the customAttributes as follows:<syntaxhighlight lang="javascript"> | ||
+ | { | ||
+ | clickEvents: [ | ||
+ | { selector: 'button.bg-green', eventName: 'green_button_clicked', customAttributes: {clickValue: 100, name: Insurance}, | ||
+ | { selector: 'footer *', eventName: 'footer_clicked' } | ||
+ | ] | ||
+ | } | ||
+ | </syntaxhighlight> | ||
+ | ====Use events to track outcome value==== | ||
+ | Use the attributes within the autotrackClick 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 a click is set at 100. This means that if the value of the outcome stands at 1000, the total number of clicks is 10 with a total value of 1000. | ||
+ | |Status=No | ||
+ | }}{{Section | ||
+ | |sectionHeading=AI-400 Config (required) | ||
+ | |anchor=outcome_value_tracker | ||
+ | |alignment=Vertical | ||
+ | |structuredtext=*AI-400 - Replace above section with following text for GA: | ||
+ | *Add first row to all autotrack events - without example. | ||
+ | |||
+ | '''Description:''' Identifies an array of click events to track. | ||
+ | |||
+ | '''Type:''' Object | ||
+ | |||
+ | '''Properties:''' See the following table. | ||
{{{!}} class="wikitable" | {{{!}} class="wikitable" | ||
{{!}}+ | {{!}}+ | ||
Line 65: | Line 115: | ||
{{!}}String | {{!}}String | ||
{{!}}required | {{!}}required | ||
+ | {{!}}- | ||
+ | {{!}}customAttributes | ||
+ | {{!}}Field used to send additional information when the selector is clicked. The field can be set with static, predetermined values. Once the autotrackClick 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. | ||
+ | |||
+ | <br /> | ||
+ | {{!}}Object | ||
+ | {{!}}optional | ||
{{!}}} | {{!}}} | ||
====Example==== | ====Example==== | ||
− | <syntaxhighlight lang="javascript"> | + | To create an event to track the number of clicks on the green button, use the customAttributes as follows:<syntaxhighlight lang="javascript"> |
{ | { | ||
clickEvents: [ | clickEvents: [ | ||
− | { selector: 'button.bg-green', eventName: 'green_button_clicked' }, | + | { selector: 'button.bg-green', eventName: 'green_button_clicked', customAttributes: {clickValue: 100, name: Insurance}, |
{ selector: 'footer *', eventName: 'footer_clicked' } | { selector: 'footer *', eventName: 'footer_clicked' } | ||
] | ] | ||
} | } | ||
</syntaxhighlight> | </syntaxhighlight> | ||
− | |Status= | + | |
+ | ====Use events to track outcome value==== | ||
+ | Use the attributes within the autotrackClick 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 a click is set at 100. This means that if the value of the outcome stands at 1000, the total number of clicks is 10 with a total value of 1000. | ||
+ | |Status=Yes | ||
}}{{Section | }}{{Section | ||
|sectionHeading=Callback (optional) | |sectionHeading=Callback (optional) |
Latest revision as of 13:00, September 20, 2022
Contents
Learn how to configure which click events Genesys Predictive Engagement tracks on your websites. This configuration provides more accurate page tracking information for use in segments and outcomes.
Description
The autotrackClick
module tracks when and where a visitor clicks on a webpage. To use autotrackClick
, configure the click events to track using the following options:
Signature
ac('load', 'autotrackClick', config, [callback]);
Example
ac('load', 'autotrackClick', {
clickEvents: [
{ selector: 'button.bg-green', eventName: 'green_button_clicked' },
{ selector: 'footer *', eventName: 'footer_clicked' }
]
}, function () {
console.log('"autotrackClick" has been loaded');
});
Config (required)
Description: Identifies an array of click events to track.
Type: Object
Properties: See the following table.
Name | Description | Type | Status |
---|---|---|---|
selector | String that selects elements. For more information, see https://developer.mozilla.org/en-US/docs/Web/API/Element/matches | String | required |
eventName | String used as the event name when an element matching the selector is clicked. | String | required |
customAttributes | Field used to send additional information when the selector is clicked. The field can be set with static, predetermined values. Once the autotrackClick 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 clicks on the green button, use the customAttributes as follows:{
clickEvents: [
{ selector: 'button.bg-green', eventName: 'green_button_clicked', customAttributes: {clickValue: 100, name: Insurance},
{ selector: 'footer *', eventName: 'footer_clicked' }
]
}
Use events to track outcome value
Use the attributes within the autotrackClick 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 a click is set at 100. This means that if the value of the outcome stands at 1000, the total number of clicks is 10 with a total value of 1000.
Callback (optional)
When a module loads, callback is executed. No arguments pass to the callback.