#Installation

Le script Audit.js est un script hébergé qui, utilisé en conjonction avec Access.js, permet de tracker des évènements supplémentaires sur votre page.

Audit.js est requis pour utiliser la segmentation native.

Historiquement, ce tracking additionnel était fait automatiquement par la fonction poool() en même temps que la création d'un paywall dans la page. Dans le but de pouvoir afficher un paywall sans utiliser la segmentation native, Audit.js est maintenant une librairie à part entière.

Comme Access.js, le script Audit.js peut être chargé de plusieurs manières différentes.

Nous ne couvrirons volontairement pas l'implémentation de React ici car nous gérons déjà tout automatiquement pour vous dans @poool/react-access.

ℹ️ Si vous utilisez des politiques de sécurité du contenu (Content Security Policy) sur votre site, assurez-vous d'ajouter https://*.poool.fr (ou les sous-domaines api, assets et cdn si vous n'êtes pas à l'aise avec les wildcards) à votre liste blanche pour que le paywall fonctionne normalement.

Bien que le mode sync soit plus facile à lire et à utiliser, nous vous recommandons d'utiliser le mode async pour éviter tout effet secondaire indésirable sur le navigateur de vos visiteurs lors du chargement du script.

Audit.js a été créée comme une librairie soeur d'Access.js et sera automatiquement détecté dans votre page par Access.js. Access.js attendra qu'Audit.js soit complètement chargé afin d'utiliser la même identité utilisateur.

Cependant, si vous détestez la magie et aimez faire les choses à votre façon, vous pouvez désactiver ce comportement par défaut en utilisant l'option de configuration skip_audit_loader d'Access.js et écouter manuellement l'événement identityAvailable d'Audit.js.

Dans le cadre des dernières réglementations européennes concernant le consentement de l'utilisateur, vous devez fournir les informations à Audit.js stipulant que le visiteur a explicitement consenti à l'existence du cookie _poool afin de permettre au tracking de fonctionner normalement.

Cela se fait via l'option de configuration cookies_enabled.

Selon votre fournisseur de Consent Management Platform, la méthode de récupération du consentement peut différer. Voici quelques exemples :

Maintenant que tout est installé, vous pouvez rechercher la bonne configuration qui correspond à vos besoins.