Instructions to send to Empathy clicks on any product in the product category page using the Javascript Tagging Library.
Clicks in any product of the product category page should be sent to Empathy using the function trackBrowseProduct.
trackBrowseProduct(categoryid, page, position, productid, title, url, options, callback) |
Parameter | Description | Data Type | Mandatory |
---|---|---|---|
categoryid | The ID of the Product Category Page where the product is selected | String | Yes |
page | The page number | Integer | Yes |
position | The position of the product selected on Product Category Page. | Integer | No* |
productid | The product ID of the selected product. | String | No* |
title | The product selected title | String | Yes |
url | Destination URL, for example product detail page | String | Yes |
options | Object that may contain information about filters and other required data | Object | No* |
callback | Function that will be executed after sending data | Function | No |
*This parameters are not mandatory for the service but necessary for the statistics |
The options object should contains additional parameters not passed as parameters in function call:
{ lang: LANGUAGUE, scope: SCOPE, section: SECTION, user: USER_ID, session: SESSION_ID } |
Parameter | Description | Data Type | Mandatory |
---|---|---|---|
lang | Language identifier (es, en...) | String | No |
scope | Scope identifier (desktop, mobile, android app, iOS app...) | String | No |
section | Section value if it is required for the project | String | No |
user | UserID used for user based services | String* | No |
session | SessionID used for user based services | String | No |
*UserID should be an UUID identifier.
NOTE: The values for scope and lang will be provided by the Empathy Team.
The callback function receives an object with the following content. Also options parameters are included:
{ page: page, productId: productid, categoryId: categoryid, position: position, title:title, url:url, follow: false } |
<a href="http://MY_PRODUCT_URL.com" title="My product title" prodID="My product ID" class="myLink">My Test Link</a> |
/** * 1 -> Capture click on the desired product * 2 -> Avoid default action (redirect to destination url) * 3 -> Execute trackClick function with the desired callback (including url redirection) */ jQuery('a#myLink').click(function(){ event.preventDefault(); var myURL = this.href; var title = this.title; var prodID = this.prodID; empathyTAG.trackBrowseProduct("My_category_ID", 1, 3, this.prodID, this.title, this.href, , {lang:'en',scope:'testscope'}, function(){ //Add your code here document.location.href = myURL; }); }); |