Overview of the Trustbadge parameters

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. Ordner 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 (+49 221 77536 58) or send us an e-mail (members@trustedshops.com).


Was this article helpful?

0 out of 0 found this helpful