Skip to main content

Voyado Engage

Track product views

By registering product views Voyado is able to calculate products of interest for each customer.

productview()

Invoke this method every time when a product has been viewed regardless if the user has been identified by the website or not. This method will generate a http request to the Collect endpoint.

Param

Type

Description

*categoryName

string

Product category, e.g. “Men / Sweaters / Cardigan”

*itemId

string

Maps against SKU in Voyado

contactId

string

Voyado contact id

Fields marked with * are mandatory

va("productview", {
   "categoryName": "Women / Sweaters / Cardigan",
   "itemId": "123XYZ",
   "contactId":"afa7625d-2e97-4667-b4c1-ad3b01194bee" 
})

Use cases

User signs in to the e-commerce
  • User clicks a link to the e-commerce through a newsletter from Voyado.

  • The URL contains a contact id (vtid) and gets stored in _vaI cookie.

  • User clicks on a specific product → invoke productview()

    • populate categoryName (e.g. “categoryName”:”Computer accessories > Printers > Toners”)

    • populate itemId with the field that is defined as SKU in Voyado. This varies depending on the setup. (Ex. “itemId”:”549852″)

    • do not populate contactId

User enters the e-commerce unidentified
  • User enters the e-commerce unidentified

  • User clicks on a specific product → invoke productview()

    • populate categoryName (e.g. “categoryName”:”Computer accessories > Printers > Toners”)

    • populate itemId with the field that is defined as SKU in Voyado. This varies depending on the setup. (Ex. “itemId”:”549852″)

    • do not populate contactId

API

Its possible to submit product views directly via API instead of implementing our tracking script. If you choose this approach, it is important that you make sure to that you identify contacts that come to ECOM via clicks in email (add “vtid” in “contactId”).

Corresponding functionality is exposed via REST API:s as well. See documentation here.

Important steps to ensure during implementation

Call “productview()” regardless of whether the user is anonymous/identified or logged in or not.

All behavioral data can be used to build understanding and insights. A product view belonging to an anonymous user can be linked afterwards when the user is identified.

Call “productview ()” at all product views and with an itemId that matches SKU in Voyado.

A product view can be a product page, but also other ways that show a selected product to the user, for example as a “quick look” in a popup. itemId will match against SKU in Voyado to be enriched with item (from the item register) and transaction data. A product page can call “productview ()” multiple times if it represents multiple SKUs.