Implementing the white label review module for product reviews

Integrating the white label product review module on your own website can be done with an iframe.

There are two options:

a form voor each specific product..
https://www.kieskeurig.nl/wl/productreview/[eancode]/[token]
example:
https://www.kieskeurig.nl/wl/productreview/9789076174112/ee982612-3988-4fa5-8bc7-b4636f61cf91

a form for a specified brand where the user can use dropdowns to select a product.
https://www.kieskeurig.nl/review-keuzehulp/[token]/[brand-id]
example:
https://www.kieskeurig.nl/review-keuzehulp/ee982612-3988-4fa5-8bc7-b4636f61cf91/42388

The resulting page is responsive and has a minimal required width and dynamic height. To show the iframe as well as possible, a minimal width of 800 pixels and a minimal height of 1800 pixels is recommended. For the best result however, our advice is to use a so called ‘javascript resizer’.
This is the source:


Example using Javascript

<script type=”text/javascript” src=”https://pym.nprapps.org/pym.v1.js”></script>
<script>
var pymParent = new pym.Parent(‘reviewmodule’,
‘// www.kieskeurig.nl/wl/productreview/[EAN]/[token]’, {});
</script>

Example using standard HTML

<iframe style=”margin:0 ;padding:0; width:850px; height:1800px; border:0” frameborder=”0”
src=”https://www.kieskeurig.nl/wl/productreview/[EAN]/[token]”></iframe>

Explanation of parameters

[EAN-code]
The EAN code is a unique combination of numbers (and sometimes letters) with which products and product units identify themselves. Replace this parameter with the EAN code of the relevant product.
Products in Kieskeurig.nl’s database can have multiple EAN codes. All of these can be used for selecting the product.
[token]

This security token is provided by Kieskeurig.nl when signing up for using the white label product and/or shop review module. If the module will be used on multiple websites we can discuss to use multiple tokens or use one and the same token for several websites.
[brand-id] the id for the desired brand. Can be provided by Kieskeurig.

Tracking

Kieskeurig.nl’s iframe has an event handler which can be called on the parent page. This gives the user the opportunity to close the iframe and, for example, load a custom ‘thank you’ message or an additional web page.

Tracking code

window.addEventListener(“message”, function(event) {
if (typeof event.data != “undefined” &&
typeof event.data.kieskeurig_review_success != “undefined” &&
event.data.kieskeurig_review_success) {
// replace the next line with code that loads the custom thank you page
alert(‘Kieskeurig review success, you could show a custom thank you page now.’);
}
});

A few extra optional parameters can be used:

<param name=”partner_campaign” desc=”” datatype=”string_0_255” default=””/>
<param name=”partner_user_id” desc=”” datatype=”string_0_255” default=””/>
<param name=”partner_order_number” desc=”” datatype=”string_0_255” default=””/>

This data will then be submitted to the review and stored in Kieskeurig.nl’s database. It will not be visible in the white label form nor in the published review. This data can only be used for reporting purposes afterwards.

Questions

If you have any questions, you can send them to datamanagement@kieskeurig.nl.

More information and technical documentation