Learn what needs to be done in order to accurately measure the performance of the product recommendations on your website.
⏳ Duration: 30 minutes
🎚️ Complexity: high
⚠️ Prerequisites: Connect the Aqurate Pixel
If you decided to measure the performance of your Aqurate Personalize and want a deeper overview, in this article you’ll learn how to set up granular tracking, directly in Aqurate.
How it works
To correctly "tag" the widgets containing recommendations, you must either:
- ⚓ Anchors option - add specific data attributes to the HTML elements within which the product recommendation widgets are rendered
- 🔗 UTM option - add specific UTMs on all links pointing towards recommended products
Once the widget is tagged correctly, the Aqurate Pixel will track all interactions with the widget, including clicks and purchases. This will provide you with granular insights into the performance of your Aqurate Personalize recommendations, allowing you to fine-tune your strategy and improve your results.
Tagging your widgets correctly is crucial to ensure accurate tracking and measurement.
Please let our team know if you are choosing the ⚓ Anchors option or the 🔗 UTM option by emailing at support@aqurate.ai.
⚓ Anchors option
Naming convention
The widgets containing Aqurate recommendations need to have HTML anchor classes (the <a> elements) added as per the naming convention below.
The format is the following:
.aqurate-personalize
👆 Please make sure the all <a> elements (anchors) in the widget have the correct anchor classes. This includes pictures, product display names, buttons, etc.
Detailed measurement
In order to get a detailed view of which widgets have the most impact on your visitors journey, you can add the following classes to the anchors in the widgets:
Widget location
The format is the following:
.aqurate-location-[location]
The valid entries for locations are the following:
Website location | Value for the location parameter |
Product detail page | pdp |
Home page |
homepage |
Category page |
category |
Checkout page |
checkout |
Cart page |
cart |
Cart pop-up |
cart-popup |
Other pop-up |
pop |
Other page |
other |
Valid examples:
.aqurate-location-pdp
.aqurate-location-cart-popup
Widget content
The format is the following:
.aqurate-endpoint-[endpoint]
The endpoint maps to the endpoint name in our API docs, while the "/" is converted to a "-".
Valid examples:
.aqurate-endpoint-recs-item-substitutes
.aqurate-endpoint-recs-item-cross-sell
.aqurate-endpoint-recs-user
Widget actions
These should be added to any action elements inside the widget (buttons, anchors, etc.).
The format is the following:
.aqurate-action-[action]
The valid entries for actions are the following:
Action | Value for the action parameter |
Add to cart | add-to-cart |
Add to wishlist |
add-to-wishlist |
Valid examples:
.aqurate-action-add-to-cart
.aqurate-action-add-to-wishlist
Wrapping it all up
If you have set everything up correctly, each anchor element of the widget should look something like this:
.aqurate-personalize
.aqurate-location-pdp
.aqurate-endpoint-recs-user
Where applicable, each element that has an action should look something like this:
.aqurate-personalize
.aqurate-location-pdp
.aqurate-endpoint-recs-user
.aqurate-action-add-to-cart
🔗 UTM option
Naming convention
The widgets containing Aqurate recommendations need to have all links pointing towards product recommendations contain UTMs as per the naming convention below.
The format is the following:
https://www.yourstore.com/product?aqurate_personalize=true
👆 Please make sure the all links in the widget have the correct UTMs. This includes pictures, product display names, buttons, etc.
Detailed measurement
In order to get a detailed view of which widgets have the most impact on your visitors journey, you can add the UTMs on all links pointing from the recommendations widget:
Widget location
The format is the following:
https://www.yourstore.com/product?aqurate_location=[location]
The valid entries for locations are the following:
Website location | Value for the location parameter |
Product detail page | pdp |
Home page |
homepage |
Category page |
category |
Checkout page |
checkout |
Cart page |
cart |
Cart pop-up |
cart-popup |
Other pop-up |
pop |
Other page |
other |
Valid examples:
https://www.yourstore.com/product?aqurate_location=pdp
https://www.yourstore.com/product?aqurate_location=homepage
Widget content
The format is the following:
https://www.yourstore.com/product?aqurate_endpoint=[endpoint]
The endpoint maps to the endpoint name in our API docs, while the "/" is converted to a "-".
Valid examples:
https://www.yourstore.com/product?aqurate_endpoint=recs-item-substitutes
https://www.yourstore.com/product?aqurate_endpoint=recs-item-cross-sell
https://www.yourstore.com/product?aqurate_endpoint=recs-user
Widget actions
The format is the following:
https://www.yourstore.com/product?aqurate_action=[action]
The valid entries for actions are the following:
Action | Value for the action parameter |
Add to cart | add-to-cart |
Add to wishlist |
add-to-wishlist |
Valid examples:
https://www.yourstore.com/product?aqurate_action=add-to-cart
https://www.yourstore.com/product?aqurate_action=add-to-wishlist
Wrapping it all up
If you have set everything up correctly, each link on the widget should look something like this:
https://www.yourstore.com/product?aqurate_personalize=true&aqurate_location=pdp&aqurate_endpoint=recs-item-substitutes
Where applicable, each link that has an action should look something like this:
https://www.yourstore.com/product?aqurate_personalize=true&aqurate_location=pdp&aqurate_endpoint=recs-item-substitutes&aqurate_action=add-to-cart
Testing the results
After you finished configuring your website for measurement, data will start getting populated in Aqurate. Please allow for up to 24 hours for the measurements to shop up.
Questions about setting up the measurement? We're excited to help: support@aqurate.ai