Integratie Whitelabelwinkelreview module

[view this text in English]

Om de Whitelabel winkelreview module te integreren op jouw website, maak je gebruik van een iframe met als bron: http://www.kieskeurig.nl/wl/winkelreview/[token]. De token die hiervoor door Kieskeurig wordt verstrekt kan indien gewenst ook gebruikt worden om de gegenereerde reviews op je eigen website te tonen vanuit de Kieskeurig.nl API.

Het token is de unieke code die toegang geeft tot de rest-API en meteen de koppeling maakt met de juiste (web)shop.

Voorbeeld met 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>

Voorbeeld met standaard HTML

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

 Tracking/succesmeting

Op de kieskeurig iframe pagina is een zgn. eventhandler actief. Met onderstaande code kan deze op de parent pagina worden uitgelezen, waarna het iframe kan worden gesloten en bv. een eigen bedank/vervolg pagina worden geladen.

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.');
}
});
Er zijn een aantal extra optionele parameters mogelijk:

<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=""/>

Deze data wordt dan meegegeven aan de review en opgeslagen in de Kieskeurig database. De data wordt niet zichtbaar in het formulier en de uiteindelijke gepubliceerde review. Deze data kan enkel in rapportages achteraf worden gebruikt.

Vragen

Heb je vragen? Mail dan naar: datamanagement@kieskeurig.nl.

Meer informatie/technische documentatie