Skip to main content

Voyado Engage

Track shopping cart changes

Voyado can trigger abandoned cart communication to identified contacts. To enable this communication flow all cart changes for every unique shopping cart should be sent to Voyado.


Invoke this method for every time the cart has been changed (added/removed cart item or updated quantity) regardless if the user has been identified by the website or not. cart() will generate a http request to the Collect endpoint.






Cart identifier and must be unique for each cart



URL to the cart



Voyado contact id, cookie "_vaI" will be used as fallback



Locale for the site where the cart is (example sv-SE). Format according to IETF language tag. Only locales that has a Product Feed assigned in Voyado can trigger an abandoned cart automation



An array of items added to cart



Item Id (SKU in Voyado)



Item quantity

Fields marked with * are mandatory

<!-- Adds two products in cart-->
        "itemId": "456436",
        "quantity": 2,
        "itemId": "456437",
        "quantity": 2,


Invoke this method when the cart has been emptied either by the user manually or when checkout process has been completed. This method is equivalent to invoking cart() with no items. It’s important to invoke emptyCart() after each successful checkout to avoid faulty abandoned cart communications. emptyCart() will generate a http request to the Collect endpoint.






Cart identifier



Voyado contact id

Fields marked with * are mandatory

    "cartRef":  "354354"}
Submitting cart changes via API

Its possible to submit cart changes 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, see API documentation here.

Handling of shopping cart changes


Site submit shopping carts either via the tracking script (which is implemented on the ecom site) or to the external Tracking API.

Azure Data Factory

Shopping carts that are not considered abandoned are filtered out; ie. has not been untouched for at least 30 minutes, are empty or haven’t be identified (connected to a contact in Voyado).

The remaining abandoned carts are sent to Voyado.


Voyado triggers the correct automation (based on language/locale) if the following conditions are met:

  • contactId matches a contact in the environment

  • the cart has been untouched according to the automation configurations (has to be within about 30 minutes)

  • the locale matches a product feed in Voyado and the set language in the (any) automation

  • the sku/skus match products in the product feed (commonly “g:id”). If one sku doesn’t match that product won’t be included in the email, if no skus matches products in the feed the automation wont be triggered at all

  • if configured: no products in the cart has been purchased (receipt sent to Voyado) since the cart was abandoned

Important steps to ensure during implementation

Call “cart ()” 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 shopping cart belonging to an anonymous user can be linked afterwards when the user is identified.

Call “cart ()” for all updates to the shopping cart, regardless of where or at what stage on the site the update takes place (product page, popup, checkout, etc). 

Voyado handles the shopping cart based on its latest change. It is therefore important that all changes to the shopping cart generate a call to “cart ()” and that the data corresponds exactly with the shopping cart is displayed on the site.

“cartRef” must be unique and must not be shared between different baskets or users. 

cartRef is the unique identifier for a shopping cart, the same cartRef may not be used for any other shopping carts. A cartRef of a specific shopping cart must not be changed, all updates regarding a shopping cart must have the same cartRef.

Call “emptyCart ()” after each completed purchase with the current “cartRef”.

It is important to always call emptyCart () with the correct cartRef after the purchase is completed. Or else the cart can be deemed as abandoned by Voyado.

Call “cart ()” with a “locale” that has a Product Feed in Voyado.

In order for the products in a cart to be enriched with article data, a Product Feed for the same language needs to be set up in Voyado. An automation with the same language also needs to be active.