How to add product reviews to my Trustbadge integration?

In addition to the reviews for your shop, Product Reviews also create trust in your offer. They give your customers valuable guidance even before they go shopping, so that you have the potential to noticeably reduce both your bounce rate and your returns rate. In addition, by writing Product Reviews, your customers create unique "user-generated content" that adds independent feedback to your product descriptions.

In this article, we'll explain how to set up product reviews through your existing manual integration of the Trustbadge once you've booked the product.

The integration with a shop software plugin
If you are using a shop software plugin for the integration of your Trustbadge, you will find the appropriate instructions for integrating product reviews in the respective plugin integration instructions:
Selecting the appropriate integration instructions

Integrate Product Reviews manually

Before you can collect Product Reviews, you will also need to have the Trustbadge integrated. If you have not already done so, please first follow these guidelines for the manual Trustbadge integration or select the instruction article for the shop software plugin you are using. The following instructions require a functioning integration.

In the course of your Trustbadge integration, you have created a DIV element on your order confirmation page ("Thank you page"), through which your customers' order data is transferred to the Trustbadge. Within this DIV element, you will now need to add further transfer parameters so that from now on data on the ordered products is also transferred.

Add all lines of code in the following code from "<!-- product reviews start -->" to "<!-- product reviews end -->" to your existing Trustbadge code:

<div id="trustedShopsCheckout" style="display: none;">
<span id="tsCheckoutOrderNr">2020-05-21-001</span>
<span id=”tsCheckoutBuyerEmail”></span>
<span id="tsCheckoutOrderAmount">4005.95</span>
<span id="tsCheckoutOrderCurrency">GBP</span>
<span id="tsCheckoutOrderPaymentType">PREPAYMENT</span>
<span id="tsCheckoutOrderEstDeliveryDate">2020-05-24</span>

<!-- product reviews start -->
<!-- for each product in the basket full set of data is required -->
<span class="tsCheckoutProductItem">
<span class="tsCheckoutProductUrl"></span>
<span class="tsCheckoutProductImageUrl"></span>
<span class="tsCheckoutProductName">Product Name</span>
<span class="tsCheckoutProductSKU">0123456789</span>
<span class="tsCheckoutProductGTIN">0123456789</span>
<span class="tsCheckoutProductMPN">0123456789</span>
<span class="tsCheckoutProductBrand">ABCDEFGHIJ</span>
<!-- product reviews end -->

What does each parameter mean?

In the following, we will only explain the additional transfer parameters so that you can take care of providing the required data.

<span class="tsCheckoutProductUrl"></span>

Required. This parameter is used to pass the complete link to the product detail page.

<span class="tsCheckoutProductName">Product Name</span>

Required. This parameter passes the product name. A simple text string is sufficient here.

<span class="tsCheckoutProductSKU">0123456789</span>

Required. This parameter is used to transfer the SKU (Stock Keeping Unit) – the item number assigned by your shop.

<span class="tsCheckoutProductImageUrl"></span>

Optional, but highly recommended. This parameter allows you to pass the URL of a product image. In this case, the product image will be displayed in your customers' review form. This makes it easier for the customer to remember the product so they can review it. Since conversion could increase by using this feature, it is highly recommended that you implement this parameter.

<span class="tsCheckoutProductGTIN">0123456789</span>

Optional, but required when using Google integration. This parameter passes the Global Trade Item Number (GTIN). Since the GTIN uniquely identifies a product worldwide, the transfer of the GTIN makes it especially easy for Google to assign your collected Product Reviews to the right product. So if you have booked our Google Integration and are running campaigns in Google Shopping and Google Ads, the use of this parameter is required.

<span class="tsCheckoutProductMPN">0123456789</span>

Optional. The Manufacturer Part Number (MPN) also serves to uniquely identify the product and is transferred with this parameter.

<span class="tsCheckoutProductBrand">ABCDEFGHIJ</span>

Optional. This parameter passes the product brand. Just like the GTIN and the MPN, it also helps to clearly identify the products and correctly transfer the collected ratings to Google.

What are the sample values replaced with?

Since dynamic order data will be transferred via the DIV element, you should not copy the above parameters into your DIV element unchanged. Instead, replace the bold values of each transfer parameter with corresponding variables in the programming language used by your shop system. The exact definition and designation of the parameters depends on the programming of your shop system, which is why we cannot give a generally applicable explanation at this point. You will find the concrete definitions and designations in the documentation of your shop system.

You also need to ensure that a complete data set is transferred for each purchased product. This ensures that you invite your customers to review the product that they really have bought.

You can find more articles on product reviews here:
- How do I edit collected product reviews?
- How do I integrate Product Review Widgets on my website?
- What do the Product Review questionnaires look like?

Was this article helpful?

12 out of 21 found this helpful