# Guide d'installation

## Installation :package:&#x20;

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](https://www.commandersact.com/en/) ou [Google Tag Manager](https://tagmanager.google.com/).

{% tabs %}
{% tab title="HTML" %}

```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>
```

{% endtab %}
{% endtabs %}

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**.

```javascript
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é.

```javascript
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 :heavy\_check\_mark:&#x20;

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.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.veasybl.io/guide-dinstallation.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
