DocsDémarrage rapide
Installer l’agent Nodale sur votre site web
Une seule balise script place l’agent Nodale sur votre site. Où la coller, ce que votre site doit autoriser, et comment vérifier qu’elle fonctionne.
L’agent Nodale fonctionne sur votre site web grâce à une seule balise script. Cette page s’adresse au développeur qui l’installe. Pour piloter l’agent depuis votre propre code, lisez l’API JavaScript.
Avant de commencer
Deux conditions doivent être remplies dans votre espace de travail Nodale, sinon le tag ne fait rien :
- L’agent est publié et en ligne. L’onglet Installation de votre agent n’affiche la ligne à coller qu’une fois l’agent publié et son déploiement en ligne.
- Votre site est déclaré. Ajoutez son adresse dans Sites autorisés, dans le même onglet. Les règles sont ci-dessous.
Coller le tag
<script src="https://tag.nodale.app/v1/tag.js" data-workspace="YOUR_WORKSPACE_ID" async></script>
Copiez la ligne depuis l’onglet Installation : elle contient déjà l’identifiant de votre espace de travail. Collez-la sur chaque page où vous voulez l’agent, dans le <head> ou juste avant </body>.
- Une ligne par espace de travail, collée une fois. Le tag lit la configuration actuelle de votre espace de travail à chaque chargement de page. Publier une nouvelle version de l’agent ou changer son affichage atteint toutes les pages sans que personne ne touche au site.
- Il s’exécute une fois par page. Le coller deux fois, ou le charger depuis un gestionnaire de balises en plus de la page, est sans conséquence : la seconde copie voit la première et s’arrête.
- Les applications monopages sont suivies. L’agent reste monté quand votre application navigue avec
pushState,replaceStateoupopstate. - Langue. Le widget prend la langue de la page dans
<html lang>. Pour la fixer vous-même, ajoutezdata-langau tag, par exempledata-lang="fr". - Un espace de travail par page. Une page exécute un seul tag.
Sites autorisés
Le tag ne répond que sur les sites que votre espace de travail déclare. Sur tout autre site, rien n’est ajouté à la page.
- Une entrée est une origine, schéma et port compris :
https://www.example.com. Elle n’a pas de chemin. httpsuniquement, sauflocalhostet127.0.0.1pour le travail en local.https://*.example.comcouvre tous les sous-domaines, à n’importe quelle profondeur, mais pasexample.comlui-même. Déclarez l’apex comme une entrée à part.- 20 sites au maximum par espace de travail.
- Un changement ne demande aucune publication. Un site retiré cesse d’afficher l’agent au prochain chargement de page du visiteur.
Où l’agent s’affiche
L’affichage est un réglage de l’onglet Installation, pas du tag :
- Barre flottante : une barre flottante en bas de la page.
- Bouton : un lanceur dans le coin inférieur droit, qui ouvre le widget au clic.
Pour placer plutôt l’agent dans votre propre mise en page, ajoutez cet élément là où vous le voulez. Le widget se monte dans le premier qu’il trouve, dans le flux de la page, quel que soit le réglage d’affichage :
<div data-nodale-agent></div>
Un troisième affichage, hidden, garde l’agent hors de vue jusqu’à ce que votre code l’ouvre. Il est décrit avec l’API JavaScript.
Content Security Policy
Un site qui envoie une Content Security Policy ajoute exactement trois sources aux directives qu’il a déjà :
script-src https://tag.nodale.app;
frame-src https://nodale.app;
connect-src https://nodale.app
- Pas de
'unsafe-inline', pas de'unsafe-eval', pas de joker et pas de nonce : le tag est un script externe sans code inline. - Aucune entrée
style-src,img-src,font-srcoumedia-src: tout ce que le widget affiche se charge dans son propre cadre. require-trusted-types-for 'script'est compatible.frame-srcse rabat surchild-src, puis surdefault-src.
Microphone
La voix a besoin du microphone, et le navigateur ne le demande que lorsque le visiteur appuie sur le bouton du microphone, jamais au chargement de la page.
Si votre site envoie un en-tête Permissions-Policy, il ne doit pas refuser le microphone au widget. Soit vous omettez microphone, soit vous autorisez l’origine Nodale :
Permissions-Policy: microphone=(self "https://nodale.app")
Bandeaux cookies
Un outil de consentement qui bloque les scripts automatiquement doit exempter le tag Nodale, ou le classer dans la catégorie que votre espace de travail a choisie pour la mesure des visites. Un tag bloqué ne peut pas afficher l’agent.
La mesure des visites est désactivée par défaut. Quand vous l’activez, les pages vues ne sont comptées qu’une fois que le visiteur a accepté. Le tag lit la réponse dans votre bandeau cookies ; un site qui n’en a pas la transmet avec nodale('consent'). L’agent lui-même est monté dans les deux cas.
Vérifier l’installation
Ouvrez l’onglet Installation. La carte Tag sur vos sites liste chaque site déclaré comme Détecté ou Non détecté, avec la dernière fois où le tag a été vu. Vérifier à nouveau lit la page d’accueil de chaque site.
Si l’agent ne s’affiche pas sur une page, vérifiez dans cet ordre :
- Le site est dans Sites autorisés, avec le schéma et le sous-domaine exacts.
- L’agent est publié et son déploiement est en ligne.
- La Content Security Policy de la page contient les trois sources ci-dessus.
- Aucun outil de consentement ne bloque le script.
Le tag n’écrit jamais d’erreur sur votre page. Il laisse une ligne console.debug commençant par nodale tag: quand il s’arrête.