Overview
This section is written for merchants (or their technical partners) who want to add TruRating Online to their website.
TruRating Online is a lightweight JavaScript widget that collects customer feedback on an ecommerce website. It's added to one or more pages of your site, asks a single question per widget access, and returns the answer (plus an optional comment) to TruRating in near real time. Ratings can be tied to a specific transaction, or collected independently of one, and feedback is always anonymous.
The widget supports two modes of operation, described below. Which mode runs on a given domain is set up by TruRating as part of onboarding, not something an integrator switches per request. Talk to your TruRating contact about which mode(s) you need enabled, and see the Integration Guide for the fields each one uses.
Post Purchase
The widget is added to the payment confirmation page. Transaction details (amount, basket contents, and so on) are passed in, so the resulting rating and any comment can be linked back to that specific transaction. In Post Purchase mode the widget renders automatically on the confirmation page: the customer sees the question immediately and can rate with a single click, with an option to leave a comment.
Always On
The widget is added to any page where feedback should be collectable, independent of a purchase. It uses the same JavaScript snippet as Post Purchase, just without transaction fields populated. Customer and basket data can still be included.
Unlike Post Purchase, the widget does not render automatically in Always On mode. The customer sees a minimized feedback tab; clicking it opens the widget. It's your (or your integrator's) responsibility to control which pages the widget appears on. See Widget Positioning for how the tab and widget are placed.
A domain can have both modes enabled at once. Where that's the case, TruHub shows Post Purchase and Always On as separate rows on your dashboard, so you can review and compare the two independently rather than seeing one blended figure.
Preventing duplicate ratings in Always On
Because Always On isn't tied to a single transaction, TruRating Online uses a proprietary method to recognise a returning visitor and avoid asking them again too soon. By default a visitor is remembered for one week before they can be asked again; talk to your TruRating contact if you need a different period.
Closing the loop
TruRating Online has an optional feature that lets a customer share their contact details directly with your customer service team, alongside their rating and comment. See the "Close the Loop" landing page section of the Integration Guide for how the data is passed.
Where to go next
- Integration Types for the two ways to add the widget to a site.
- Integration Guide for the full technical walkthrough: data points, the JavaScript snippet, and every configurable field.
- Widget Positioning and Embedding for how the widget is placed on the page.