DocsSnel starten

De Nodale-agent op je website installeren

Eén scripttag zet de Nodale-agent op je site. Waar je hem plakt, wat je site moet toestaan en hoe je controleert dat hij draait.

De Nodale-agent draait op je website via één scripttag. Deze pagina is voor de developer die hem installeert. Wil je de agent vanuit je eigen code aansturen, lees dan de JavaScript API.

Voordat je begint

Twee dingen moeten kloppen in je Nodale-workspace, anders doet de tag niets:

  1. De agent is gepubliceerd en online. Het tabblad Install van je agent toont de regel om te plakken pas als de agent gepubliceerd is en zijn deployment live staat.
  2. Je site is aangemeld. Voeg het adres toe onder Allowed websites, in hetzelfde tabblad. De regels staan hieronder.

Plak de tag

<script src="https://tag.nodale.app/v1/tag.js" data-workspace="YOUR_WORKSPACE_ID" async></script>

Kopieer de regel uit het tabblad Install: je workspace-id staat er al in. Plak hem op elke pagina waar je de agent wilt hebben, in de <head> of vlak voor </body>.

  • Eén regel per workspace, één keer geplakt. De tag leest bij elke paginalading de actuele configuratie van je workspace. Een nieuwe versie van de agent publiceren of de weergave wijzigen bereikt elke pagina zonder dat iemand aan de site komt.
  • Hij draait één keer per pagina. Hem twee keer plakken, of hem zowel via een tagmanager als via de pagina laden, kan geen kwaad: de tweede kopie ziet de eerste en stopt.
  • Single-page apps worden gevolgd. De agent blijft gemount wanneer je app navigeert met pushState, replaceState of popstate.
  • Taal. De widget neemt de taal van de pagina over uit <html lang>. Wil je die zelf instellen, voeg dan data-lang toe aan de tag, bijvoorbeeld data-lang="fr".
  • Eén workspace per pagina. Een pagina draait één tag.

Allowed websites

De tag antwoordt alleen op de sites die je workspace aanmeldt. Op elke andere site wordt er niets aan de pagina toegevoegd.

  • Een invoer is een origin, inclusief schema en poort: https://www.example.com. Zonder pad.
  • Alleen https, behalve localhost en 127.0.0.1 voor lokaal werk.
  • https://*.example.com dekt elk subdomein, op elke diepte, maar niet example.com zelf. Meld het apexdomein aan als eigen invoer.
  • Maximaal 20 sites per workspace.
  • Voor een wijziging hoef je niet te publiceren. Een verwijderde site toont de agent niet meer vanaf de volgende paginalading van de bezoeker.

Waar de agent te zien is

De weergave is een instelling van het tabblad Install, niet van de tag:

  • Floating bar: een zwevende balk onderaan de pagina.
  • Button: een launcher in de hoek rechtsonder, die de widget opent bij een klik.

Wil je de agent in plaats daarvan in je eigen layout zetten, voeg dan dit element toe op de plek waar je hem wilt. De widget mount in het eerste dat hij vindt, in de flow van de pagina, wat de weergave-instelling ook is:

<div data-nodale-agent></div>

Een derde weergave, hidden, houdt de agent uit het zicht totdat je code hem opent. Die staat beschreven bij de JavaScript API.

Content Security Policy

Een site die een Content Security Policy meestuurt, voegt precies drie bronnen toe aan de directives die hij al heeft:

script-src  https://tag.nodale.app;
frame-src   https://nodale.app;
connect-src https://nodale.app
  • Geen 'unsafe-inline', geen 'unsafe-eval', geen wildcard en geen nonce: de tag is een extern script zonder inline code.
  • Geen invoer voor style-src, img-src, font-src of media-src: alles wat de widget rendert, laadt binnen zijn eigen frame.
  • require-trusted-types-for 'script' is compatibel.
  • frame-src valt terug op child-src, daarna op default-src.

Microfoon

Spraak heeft de microfoon nodig, en de browser vraagt er alleen om wanneer de bezoeker op de microfoonknop drukt, nooit bij het laden van de pagina.

Als je site een Permissions-Policy-header meestuurt, mag die de microfoon niet weigeren aan de widget. Laat microphone weg, of sta de origin van Nodale toe:

Permissions-Policy: microphone=(self "https://nodale.app")

Cookiebanners

Een toestemmingstool die scripts automatisch blokkeert, moet de Nodale-tag uitzonderen, of hem indelen in de categorie die je workspace voor bezoektracking heeft gekozen. Een geblokkeerde tag kan de agent niet tonen.

Bezoektracking staat standaard uit. Als je het aanzet, worden paginaweergaven pas geteld nadat de bezoeker akkoord is gegaan. De tag leest het antwoord uit je cookiebanner; een site zonder banner meldt het met nodale('consent'). De agent zelf wordt in beide gevallen gemount.

Controleer de installatie

Open het tabblad Install. De kaart Tag on your sites toont elke aangemelde site als Detected of Not detected, met het laatste moment waarop de tag is gezien. Check again leest de homepage van elke site.

Is de agent niet te zien op een pagina, controleer dan in deze volgorde:

  1. De site staat in Allowed websites, met exact het juiste schema en subdomein.
  2. De agent is gepubliceerd en zijn deployment is online.
  3. De Content Security Policy van de pagina bevat de drie bronnen hierboven.
  4. Geen toestemmingstool blokkeert het script.

De tag schrijft nooit een fout op je pagina. Hij laat één console.debug-regel achter die begint met nodale tag: wanneer hij stopt.

Voor AI-agents: deze pagina in Markdown

Laat elk bezoek tellen.