Implementing the white label review module for shop reviews

Using the white label review module on your own web site can be done with an iframe. The source for this iframe is: http://www.kieskeurig.nl/wl/winkelreview/[token]. The token will be given to you by Kieskeurig.nl. If needed, this token can also be used to show the generated reviews on your own web site by calling them from the Kieskeurig.nl API.

The token is the unique identifier which gives access to the REST API and makes the correct connection with the relevant shop.

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/winkelreview/[token]’,{});
</script>

Example using standard HTML

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

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