Collect reviews, offer Buyer Protections - configure the checkout process correctly
The Trustbadge is the main element in your trust-based marketing. To ensure correct integration, you will find help on the Trustbadge parameters that are important for full product use.
For the automatic collection of customer reviews and the option to register for the Trusted Shops Buyer Protection, the Trustbadge needs a DIV container, which is used to recognise your order confirmation. The data required for using the Trustbadge is loaded into the so-called "trustedShopsCheckout" DIV container. Basically, a shop system stores the order data in a database, which only needs to be called up for the Trustbadge integration on the order confirmation page.
It is possible that individual values are not available within the DIV, therefore you will find the information below that should help you to restore the optimal Trustbadge usage. For this it will be necessary to make adjustments in the plugin files or in the shop files on the order confirmation page.
Test functionality of the DIV container
After completing the DIV container, please test the function of your Trustbadge by triggering an order in your shop. Make sure that the Trustcard appears at the end of the ordering process. The Trustcard contains a button your buyers can click on if they want to receive a review request or register for the Trusted Shops Buyer Protection. In addition, check in the browser console whether the "trustedShopsCheckout" DIV container is now completed.
Which parameters have to be transferred?
In the following you will find an overview and description of the necessary parameters for shop reviews, Buyer Protections and product reviews. Use these parameters to transfer the data required for your individual case to the Trustbadge.
1. Order number
Required for:
Shop reviews, Buyer Protection, Product reviews
Parameters in the DIV-container:
<span id="tsCheckoutOrderNr">2019-05-30-001029</span>
Comment:
Required to be able to assign an ordering process to the review. If an order number is not available, a time stamp of the respective order can also be given as a clear reference
2. E-mail address of the buyer
Required for:
Shop reviews, Buyer Protection, Product reviews
Parameters in the DIV-container:
<span id="tsCheckoutBuyerEmail">my.customer@mail.com</span>
Comment:
Required to send a review invitation to the online shopper a few days after the purchase
3. Shopping basket total including value added tax, shipping costs and any costs for the payment method
Required for:
Buyer Protection
Parameters in the DIV-container:
<span id="tsCheckoutOrderAmount">4005.95</span>
Comment:
Required, the following number format is supported: the decimal separator is a point, two decimal places, such as 4005.95
4. Currency of purchase
Required for:
Buyer Protection
Parameters in the DIV-container:
<span id="tsCheckoutOrderCurrency">EUR</span>
Comment:
Required, alphabetical currency abbreviation according to ISO standard 4217, such as for Euro = EUR. If you are only selling in one currency, you can hard-code the currency code
5. Payment method used for the purchase
Required for:
Buyer Protection
Parameters in the DIV-container:
<span id="tsCheckoutOrderPaymentType">PREPAYMENT</span>
Comment:
Required, a simple text string is sufficient here because there is no mapping. If the payment method is no longer available when the order is completed, hard-code the word other as the value for this parameter
6. Estimated delivery date (latest date for a mixed shopping basket)
Required for:
Buyer Protection, Product reviews
Parameters in the DIV-container:
<span id="tsCheckoutOrderEstDeliveryDate">2019-05-30</span>
Comment:
Optional, the following date format is supported: YYYY-MM-DD, such as: 2019-05-30
7. URL to the product page
Required for:
Product reviews
Parameters in the DIV-container:
<span class="tsCheckoutProductUrl">http://www.shop.url/product_page.html</span>
Comment:
Required, full link to the product is required
8. URL to the product image
Required for:
Product reviews
Parameters in the DIV-container:
<span class="tsCheckoutProductImageUrl">http://www.shop.url/image.png</span>
Comment:
Optional, the product image will be displayed to your buyers when they submit their product review, making it easier to review
9. Product name
Required for:
Product reviews
Parameters in the DIV-container:
<span class="tsCheckoutProductName">Product Name</span>
Comment:
Required, a simple text string is sufficient
10. SKU of the product
Required for:
Product reviews
Parameters in the DIV-container:
<span class="tsCheckoutProductSKU">123456789</span>
Comment:
Required, the SKU (Stock Keeping Unit) is the catalogue number of a product assigned by your shop
11. GTIN of the product
Required for:
Product reviews
Parameters in the DIV-container:
<span class="tsCheckoutProductGTIN">123456789</span>
Comment:
Optional, is required if you run Google Shopping campaigns and want to show your star product reviews on Google Shopping and paid product ads
12. MPN of the product
Required for:
Product reviews
Parameters in the DIV-container:
<span class="tsCheckoutProductMPN">123456789</span>
Comment:
Optional, a key figure that clearly assigns the product to a specific manufacturer
13. Product brand
Required for:
Product reviews
Parameters in the DIV-container:
<span class="tsCheckoutProductBrand">ABCDEFGH</span>
Comment:
Optional
DIV container for order confirmation page
Use the list above to select the parameters necessary for your product constellation and integrate them as described here.
<div id="trustedShopsCheckout" style="display: none;">
<span id="tsCheckoutOrderNr">2016-05-21-001</span>
<span id="tsCheckoutBuyerEmail">my.customer@mail.com</span>
<span id="tsCheckoutOrderAmount">4005.95</span>
<span id="tsCheckoutOrderCurrency">EUR</span>
<span id="tsCheckoutOrderPaymentType">PREPAYMENT</span>
<span id="tsCheckoutOrderEstDeliveryDate">2016-05-24</span>
<!-- product reviews start -->
<!-- for each product in the basket full set of data is required -->
<span class="tsCheckoutProductItem">
<span class="tsCheckoutProductUrl">http://www.shop.url/product_page.html</span>
<span class="tsCheckoutProductImageUrl">http://www.shop.url/image.png</span>
<span class="tsCheckoutProductName">Product Name</span>
<span class="tsCheckoutProductSKU">123456789</span>
<span class="tsCheckoutProductGTIN">123456789</span>
<span class="tsCheckoutProductMPN">123456789 </span>
<span class="tsCheckoutProductBrand">ABCDEFGH</span>
</span>
<!-- product reviews end -->
</div>
Further information about the integration of the Trustbadge can be found here. You are also welcome to call us with your questions (+44 203 364 5906) or send us an e-mail (members@trustedshops.com).