Tracking
Recommendations
Search
Triggered Emails
Single Page Applications
Click tracking
Products returned from the Hello Retail product recommendation and search apis will contain links that have a tracking code appended to them in the fragment part of the url.
Example for search
https://shop.example.com/best-product.html#aw_source=ps-3335d0a7-5dd1-4044-ba76-d089348abf31Example for product recommendations
https://shop.example.com/awesome-product.html#aw_source=pb-9cb4857e6ff3911d1c76ab6aThis tracking code allows the Hello Retail script to track clicks on products in search and recoms. When the api’s are used by the Hello Retail script these tracking links will be used in the generated dom. But a click handler is implemented so that the actual url that the customer is sent to when clicking the link does not contain the tracking fragment.
If you use the api directly you can leave the tracking fragment on the product urls. This will allow the Hello Retail script to automatically track clicks on the product recommendations or search implemented using our api solution.
Tracking without using the fragment
If you do not want to have the tracking fragment shown on the page the user lands on, or the fragment does not work with your shop platform, you can remove the fragment from the URL. If you do this, you will have to add a click handler to the products in your product recommendations or search. This click handler will ensure that click tracking is sent to Hello Retail even if the tracking fragment is not on the link. The click handler must call the method
ADDWISH_PARTNER_NS.api.tracking.track_click with the value from the fragment as a parameter. A bare-bones implementation of this could look something like this:1
<a href="https://shop.example.com/awesome-product.html" onclick="ADDWISH_PARTNER_NS.api.tracking.track_click('pb-5cb4857e6ff3911d1c76ab6a');">
2
Awesome product
3
</a>
Copied!
Tip: You could consider implementing a click handler that finds the tracking fragment in the href attribute, calls the track_click method, and then navigates to the URL without the tracking fragment.
Verify tracking
To verify that the click tracking works you can click one of the links that should track clicks with the network tab open in the browser developer console. The Hello Retail javascript will request the https://www.addwish.com/partner/init.html url. If tracking a search or product recommendation click that request should include clickedProductBoxId or clickedPartnerSearchConfigKey with the value from the tracking fragment.
Last modified 1yr ago
Copy link