Integratie Whitelabel productreview module
[view this text in English]
Om de Whitelabel productreview module te integreren op jouw website, maak je gebruik van een iframe met als bron:
Er zijn 2 mogelijkheden:
een formulier voor een specifiek product.
https://www.kieskeurig.nl/wl/productreview/[eancode]/[token]
voorbeeld:
https://www.kieskeurig.nl/wl/productreview/9789076174112/ee982612-3988-4fa5-8bc7-b4636f61cf91
een formulier voor je merk waarbij de gebruiker middels dropdowns het juiste product kan kiezen.
https://www.kieskeurig.nl/review-keuzehulp/[token]/[brand-id]
voorbeeld:
https://www.kieskeurig.nl/review-keuzehulp/ee982612-3988-4fa5-8bc7-b4636f61cf91/42388
De getoonde pagina is responsive en heeft een minimaal gewenste breedte en een dynamische hoogte. Om de iframe goed te tonen wordt een breedte van 800 px en een minimale hoogte van 1800 px aanbevolen. Maar voor een zo optimaal mogelijk resultaat, adviseren wij je gebruik te maken van een zgn. javascript resizer.
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/productreview/[ean]/[token]', {});
</script>
Voorbeeld met standaard 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>
Uitleg parameters
• [EAN-code]* De EAN-code is een unieke combinatie van cijfers (en soms letters) waarmee o.a. producten en productie-eenheden zich identificeren. Vervang deze parameter voor de EAN-code van het betreffende product.
• [token] Bij het aanmelden voor het gebruik van de Whitelabel product- en/of winkelreviewmodule wordt dit security-token verstrekt door Kieskeurig.nl. Indien het formulier op meerdere sites geplaatst wordt, kan in overleg gekozen worden voor verschillende of hetzelfde token voor deze sites.
• [brand-id] het id voor het betreffende merk waarmee de juiste keuze-dropdowns getoond worden.
* Een product in de Kieskeurig.nl database kan meerdere EAN-codes hebben, al deze EAN-codes zijn geschikt om het product te selecteren.
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 geloten 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
