Event Tracking
With event tracking, you can measure events or clicks on internal or external links as well as button clicks.
Event parameters are custom parameters that can be used to enrich the analytical data with your web page-specific information and metrics.
Examples
- Scroll depth
- Link type (e.g. internal/external)
- Click area (e.g. text/image/header)
- Link target (e.g. if a link position is used as link name)
Note, that you have to set up the parameter in Mapp Q3, too. Find more information here.
Configuring a Single Event Name
It is needed to provide an action name to analyse it in Intelligence. The action name is configured in the JSON object under "triggers.trackClicks.vars":
<amp-analytics type="mapp_intelligence">
<script type="application/json">
{
"vars": {
"trackDomain": "analytics.mapp.com",
"trackId": "111111111111111"
},
"triggers": {
...
"trackClicks": {
"on": "click",
"selector": "a",
"request": "event",
"vars": {
"actionName": "click"
},
}
...
}
}
</script>
</amp-analytics>
Parameter | Description |
---|---|
actionName | Enter the name of the event. |
Configuring Multiple Event Names
For multiple links, it is possible to use the attribute "data-vars-action-name" within the link. The value of the attribute will then be used as a name for the link:
<a href="#more" data-vars-action-name="more">more</a><br />
<a href="//www.mapp.com" data-vars-action-name="external.www_mapp_com">www.mapp.com</a><br />
<a href="/link/to/an/internal/page.html" data-vars-action-name="link to an internal page">link to an internal page</a><br />
<amp-analytics type="mapp_intelligence">
<script type="application/json">
{
"vars": {
"trackDomain": "analytics.mapp.com",
"trackId": "111111111111111"
},
"triggers": {
...
"trackClicks": {
"on": "click",
"selector": "a",
"request": "event"
}
...
}
}
</script>
</amp-analytics>
Parameter or Attribute | Description |
---|---|
data-vars-action-name | Please include names of the events here. |
Configuring Event Parameters
Event Parameters can either be used globally for all links or individually for each link.
Configuring Event Parameters Globally
The event parameter for global use is set in the JSON object under "triggers.trackClicks.extraUrlParams":
<amp-analytics type="mapp_intelligence">
<script type="application/json">
{
"vars": {
"trackDomain": "analytics.mapp.com",
"trackId": "111111111111111"
},
"triggers": {
...
"trackClicks": {
"on": "click",
"selector": "a",
"request": "event",
"vars": {
"actionName": "click"
},
"extraUrlParams": {
"actionParameter1": "200.51",
"actionParameter2": "green"
}
}
}
}
</script>
</amp-analytics>
Parameter | Description |
---|---|
extraUrlParams | Any additional event parameter can be included here. |
Configuring Event Parameters per Link
If you want to send several links with different information, you can use additional to the "data-vars-action- name" attribute even more "data" attributes (data-vars-*).
<a href="#more" data-vars-action-name="more" data-vars-action-parameter-test="test" data-vars-foo="bar">more</a><br />
<a href="//www.mapp.com" data-vars-action-name="external.www_mapp_com" data-vars-external-link="yes">www.mapp.com</a><br />
<a href="/link/to/an/internal/page.html" data-vars-action-name="link to an internal page" data-vars-internal-link="yes">link to an internal page</a><br />
<amp-analytics type="mapp_intelligence">
<script type="application/json">
{
"vars": {
"trackDomain": "analytics.mapp.com",
"trackId": "111111111111111"
},
"triggers": {
...
"trackClicks": {
"on": "click",
"selector": "a",
"request": "event",
"extraUrlParams": {
"actionParameter1": "${actionParameterTest}",
"actionParameter3": "${foo}",
"actionParameter5": "${externalLink}",
"actionParameter12": "${internalLink}"
}
}
...
}
}
</script>
</amp-analytics>
Parameter or Attribute | Description |
---|---|
data-vars-* | Use the additional data-vars attribute to mark the targeted link. |
extraUrlParams | Any additional event parameter can be included here. |