De tracker toevoegen
Installeer de scripttag van uw website en controleer of gebeurtenissen binnenkomen. Beoordeel uw toestemmingsvereisten voordat u het verzamelen inschakelt.
1. Kopieer uw fragment
Log in, open uw website en ga naar Settings → Installation → Scripts (Instellingen → Installatie → Scripts). Uw fragment ziet er zo uit, met uw eigen websitetoken. De hier getoonde stijl Minimal (Minimaal) leest de opties uit Installation → Dashboard; de stijl Explicit (Expliciet) schrijft dezelfde opties als scriptattributen (zie Scriptopties).
<script defer src="https://app.seean.io/k.js"
data-site="YOUR_SITE_TOKEN"
data-api="https://app.seean.io"></script>Houd zowel het script- als het API-adres op https://app.seean.io, zoals hierboven, tenzij first-party verzamelen is ingeschakeld onder Installation; dan wordt de gegenereerde hostnaam <slug>-collect.seean.io - of een actief eigen verzameldomein - voor beide gebruikt. Een bestaand fragment met deze adressen hoeft niet te veranderen wanneer Seean zijn infrastructuur bijwerkt.
2. Plak het vóór </head>
Gebruik het gedeelde HTML-document of de root layout voor elke pagina die u wilt meten. Volg uw platformgids voor de juiste plaatsing. Installeer de tracker één keer: zowel een lay-out als een tagmanager gebruiken kan bezoeken dubbel tellen.
De tracker volgt ondersteunde History API-navigatie, zoals / → /pricing. Querystrings maken geen deel uit van het paginapad; hashfragmenten worden genegeerd tenzij u data-hash="true" instelt. Een gewijzigde getagde campagne of een verlopen sessie kan nog steeds een nieuwe sessie starten en dezelfde padnaam opnieuw tellen. Laad de tracker als klassiek extern script; importeer het niet in uw applicatiebundel en voeg geen type="module" toe.
3. Controleer
Open de gepubliceerde website in een normaal browsertabblad en controleer daarna Settings → Installation → Setup health (Installatiestatus) voor de bijbehorende website. Last pageview received (Laatste paginaweergave ontvangen) toont het tijdstip van de nieuwste bewaarde paginaweergave; vóór enige paginaweergave toont Installation verified (Installatie geverifieerd) wanneer de gepubliceerde pagina de controle het laatst doorstond. Gebruik Check installation (Installatie controleren) om de gepubliceerde startpagina te inspecteren op de tracker, het token en het beveiligingsbeleid. Seean controleert de gepubliceerde startpagina ook automatisch op de achtergrond (elke minuut op de eerste dag van de website), zodat de installatie wordt geverifieerd zodra het fragment is gepubliceerd, ook wanneer het dashboard gesloten is. De banner in het Overzicht verdwijnt dan zonder op een bezoek te wachten.
Een verwijzing in de broncode of een oud bezoek bewijst niet dat uw nieuwste implementatie werkt. Zoek een nieuw paginapad en tijdstip in Gebeurtenissen met de installatiecontroles. De gids voor de installatiediagnose legt resultaten, rechten en limieten uit.
Scriptopties
Installation → Dashboard bevat de trackingopties van de website: UTM-campagnes (aan), hash-paginapaden (uit), Web Vitals (aan), automatische conversies (aan voor nieuwe en nooit geconfigureerde websites), foutopsporingslogboek (uit) en cross-domain hostnamen. Save tracking options (Trackingopties opslaan) slaat ze op; een minimaal fragment past ze toe bij de volgende paginalading. De fragmentstijl Explicit schrijft dezelfde keuzes in plaats daarvan als attributen:
| Attribuut | Standaard | Effect |
|---|---|---|
data-conversions="true" |
uit in ruwe HTML | Laadt de ingeschakelde automatische conversievoorinstellingen één keer per document. Gegenereerde expliciete fragmenten bevatten het zolang Auto conversions aan staat. |
data-hash="true" |
uit | Telt wijzigingen van location.hash als paginaweergaven en rapporteert het pad met het fragment, bijvoorbeeld /docs#install. |
data-utm="off" |
aan | Stopt het lezen van utm_source, utm_medium en utm_campaign; een getagde link start geen nieuwe sessie meer. |
data-vitals="off" |
aan | Slaat de Web Vitals-meting volledig over (geen performance observers). |
data-debug="true" |
uit | console.debug van elke payload voordat die wordt verzonden. Veilig wanneer de console niet beschikbaar is. |
data-domains="a.com,b.com" |
uit | Cross-domain overdracht: links naar de vermelde hosts (en hun subdomeinen) dragen de bezoekers-ID mee, en een landingspagina neemt een binnenkomende ID over. |
Wanneer een van deze attributen aanwezig is, worden de dashboardopties voor die pagina genegeerd. Details en standaardwaarden: Script- en trackingopties.
Wat de tracker verstuurt
| Veld | Wat het is |
|---|---|
| path | het paginapad, zonder querystring (met het fragment wanneer data-hash aan staat) |
| hostname | de website die wordt gemeten |
| referrer | de verwijzende URL van de browser; de collector bewaart alleen de hostnaam |
| timezone | terugval voor het land wanneer de netwerkrand er geen meldt |
| visitorId, sessionId | standaardidentiteiten worden op de server afgeleid per website en UTC-dag; de optionele cross-domain overdracht draagt de identiteit in sessieopslag van dezelfde dag |
| campaign | UTM source, medium, campaign, term en content wanneer aanwezig, tenzij data-utm="off" |
| click id | de naam van een advertentie-klik-ID-parameter op de landings-URL (gclid, gbraid, wbraid, fbclid, msclkid, ttclid, li_fat_id, twclid); de waarde wordt nooit gelezen. Uit met data-utm="off" |
| title | document.title, eerste 200 tekens |
| uid | uw eigen gebruikers-ID na seean.identify(id), alleen opgeslagen wanneer Identify users (Gebruikers identificeren) voor de website is ingeschakeld |
| screen | screen.width x screen.height |
| Web Vitals | LCP, INP, CLS, FCP en TTFB; latere metingen kunnen een sample bijwerken. Uit met data-vitals="off" |
De collector leest land, regio en stad uit de netwerkrand-headers van het verzoek, gebruikt de user agent voor browser-, besturingssysteem- en apparaatcategorieën, registreert de eerste Accept-Language-tag van de browser als bezoekerstaal en kan de regio van die taal als terugval voor het land gebruiken. Het IP-adres wordt alleen vergeleken met uitsluitingsregels en wordt nooit opgeslagen. Querystrings anders dan de UTM-velden en de naam van de klik-ID worden nooit verzameld.
Standaardtracking gebruikt een dagelijkse, aan de website gebonden serverhash zonder cookies of permanente meetopslag in de browser. De opt-in cross-domain overdracht gebruikt sessionStorage van dezelfde dag. Het verzamelen stopt bij Do Not Track, Global Privacy Control of de browser-opt-out beschreven in Uitsluitingen. Waar toestemming of een opt-out van toepassing is, regelt u het laden van het script via het toestemmingsmechanisme van uw website. Zie technische privacy en opslag en toestemming.
Lokale ontwikkeling
De tracker negeert localhost en 127.0.0.1 tenzij u data-local aan de scripttag toevoegt. Gebruik een aparte Seean-website/token voor testverkeer en kopieer het API-adres uit het fragment van die website. Geautomatiseerde browsers, Do Not Track, Global Privacy Control en de browser-opt-out kunnen het verzamelen nog steeds stoppen; data-local schakelt die controles niet uit.
Een installatie verwijderen of bijwerken
Verwijder het script uit de lay-out of tagmanager en publiceer de wijziging om toekomstig verzamelen vanuit die installatie te stoppen. Bestaande rapporten blijven bestaan. Het roteren van het trackingtoken van een website maakt de oude fragmenten direct ongeldig; werk elke installatie bij met het nieuwe token. Zie website-instellingen.
Is iets onduidelijk? Neem contact op met de ondersteuning.