Guide d'installation

Installation 📦

Pour installer le SDK JavaScript sur votre site, il vous suffit de copier et coller les lignes suivantes dans chaque page de votre site web. Ces lignes peuvent être insérées à la fin de la balise <body> ou via un système de gestion de balises (TMS) tel que Commander Act ou Google Tag Manager.

HTML

<script>
(function(v,easy,bl) {
    v = easy.createElement("script");
    v.type = "text/javascript";
    v.async = true;
    v.src = bl;
    (easy.head || easy.body).appendChild(v);
})(this, document, "//m.vzbl.eu/js/[retailer].js")
</script>

Cette méthode permet d’éviter que l’exécution du tag ne bloque le chargement d’autres éléments de la page, afin de minimiser l’impact sur les performances globales du site. ⌛

Content-Security-Policy

Si votre site utilise une Content Security Policy (CSP) pour renforcer sa sécurité, il est nécessaire d’ajouter les sources utilisées par notre tag à la liste des sources autorisées dans votre CSP. La configuration requise inclut l’autorisation du chargement de scripts via la directive unsafe-inline.

script-src 'unsafe-inline' https://*.vzbl.eu

Nous utilisons XMLHttpRequest et la Beacon API pour transmettre des données à nos serveurs. Par conséquent, il est nécessaire que nos domaines soient autorisés dans votre configuration de sécurité.

connect-src https://*.vzbl.eu

Quand charger le script ?

Le chargement du script doit être déclenché dès que la page est affichée. Vous devez positionner le script avant la fermeture de la balise <body> sur toutes les pages du site.

Si vous utilisez un TMS, installez le script sur toutes les pages du site et choisissez d’exécuter le script lors de l’événement “Dom Ready”.

Evènements ✔️

Lorsque la librairie est chargée, elle enregistre et transmet les événements survenant sur la page où les annonces sponsorisées ont été affichées. Ainsi, les impressions et les clics sont collectés et traités pour évaluer la performance des campagnes.