Webmodule installatie
Het ontwikkelen van een eigen API integratie voor het afsluiten van een VoordeelPakket kan een grote investering zijn en veel tijd kosten. Voogd & Voogd biedt daarom ook de mogelijkheid voor webmodules. Dit is een integratie die vanuit Voogd & Voogd wordt aangeboden en eenvoudig in een bestaande website kan worden geplaatst, zie eventueel de demo ter illustratie.
Installatie
De webmodule maakt gebruik van een iframe
implementatie die als code snippet in de bestaande website kan worden geplaatst. Aanvankelijk plaatst men de code voor de gewenste module op de webpagina en vervangt hierbij de {agent-id}
door het eigen agentschapsnummer bij Voogd & Voogd.
Neem voor het activeren van de webmodules contact op met uw relatiebeheerder.
De module wordt momenteel aangeboden voor de volgende producten; de andere producten volgen nog.
Product | Voorbeeld url |
---|---|
Auto | https://webmodules.voogd.com/auto/{agent-id} |
Bestelauto | https://webmodules.voogd.com/bestelauto/{agent-id} |
Bromfiets | https://webmodules.voogd.com/bromfiets/{agent-id} |
Motorfiets | https://webmodules.voogd.com/motorfiets/{agent-id} |
Woonhuis | https://webmodules.voogd.com/woonhuis/{agent-id} |
Inboedel | https://webmodules.voogd.com/inboedel/{agent-id} |
Aansprakelijkheid | https://webmodules.voogd.com/aansprakelijkheid/{agent-id} |
<!-- Voorbeeld code implementatie auto webmodule -->
<iframe src="https://webmodules.voogd.com/auto/{agent-id}" style="width: 100%; height: 1200px"></iframe>
Adaptief formaat
Het formaat van de webmodule differentieert op basis van de stap waar de bezoeker zich in bevindt. Voor een flexibele integratie is het daarom belangrijk dat de module adaptief van formaat wisselt naarmate de bezoeker de stappen doorloopt. Anders loopt men het risico dat delen van de module wegvallen achter een scrollbar en niet zichtbaar zijn.
Onderstaand script kan toegevoegd worden op dezelfde webpagina als waar de webmodule draait. Het advies is om deze onderaan de webpagina te plaatsen, net voor de </body>
.
<script defer src="https://webmodules.voogd.com/resizer.js"></script>
Vereisten
HTTPS
Omdat de webmodule persoonlijke informatie verwerkt, is deze enkel beschikbaar over een beveiligde verbinding (HTTPS). Dit betekent dat de webpagina waarop de webmodule geimplementeerd wordt tevens voorzien moet zijn van een HTTPS verbinding.
Een HTTPS verbinding is te herkennen aan het slotje in de webbrowser. En omdat het inmiddels de standaard is geworden geven veel browsers nu zelfs een foutmelding wanneer er geen HTTPS verbinding plaatsvindt.
Content Security Policy (CSP)
Indien de webserver geconfigureerd is om CSP headers te versturen is het noodzakelijk om het domein https://webmodules.voogd.com
toe te voegen als valide bron waar javascript code van mag worden gedownload.
Parameters
De webmodule ondersteunt additionele parameters welke gebruikt kunnen worden voor aanvullende functionaliteit.
Parameter | Omschrijving |
---|---|
lp | Het lp (license plate) parameter kan gebruikt worden om direct een kenteken in te vullen in de module. Dit kan handig zijn wanneer de gebruiker vanuit bijvoorbeeld een splash screen doorverwezen wordt naar de pagina, op die manier hoeft men dan niet opnieuw een kenteken in te vullen. |
ref | Het ref (referral) parameter kan gebruikt worden voor diverse doeleinden. Wanneer meegegeven is deze vervolgens zichtbaar in de visits tab van de css editor.Voorbeeld doeleinden: specifieke funnel / campagne waaruit de bezoeker komt of unieke identificatie van een bezoeker. |
Voorbeeld implementatie
<iframe src="https://webmodules.voogd.com/auto/{agent-id}?ref=1234&lp=X000XX" style="width: 100%; height: 1200px"></iframe>