Personyze op je website installeren

Pad in de interface: het icoon Trackingcode in het linkermenu van Personyze (</>) → Trackerinstellingen.

Personyze installeren gaat in twee stappen: vertel Personyze op welke domeinen je personaliseert, en zet daarna het trackingsnippet op die pagina’s. Zodra het snippet live is, kan Personyze bezoekers herkennen, betrokkenheid volgen en personalisatie leveren.

De pagina Trackerinstellingen is ook je gezondheidscontrole. Een banner bovenaan vertelt je of de tracker vuurt, wanneer het laatste bezoek was, over hoeveel domeinen, en hoeveel bezoeken er in de laatste 90 minuten zijn geregistreerd. Daaronder staat elk domein met de laatste activiteit en een grafiekje van 90 minuten, en je kunt filteren op Alle / Actief / Inactief / Vuurt niet om domeinen te vinden die stil zijn gevallen.

De pagina Trackerinstellingen van Personyze met de statusbanner van de tracker, de domeinfilters en de lijst met gevolgde domeinen — Trackerinstellingen: de statusbanner bevestigt dat de tracker vuurt en hoeveel bezoeken er de laatste 90 minuten binnenkwamen. Elke domeinrij toont de laatste activiteit, een trend over 90 minuten, en acties per rij rechts.

Stap 1: voeg de domeinen toe die je volgt

Klik op + Nieuw domein en geef Personyze de URL van de rootpagina — de homepage die het gebruikt om de status van de tracker te bepalen. Die moet vanaf het openbare internet bereikbaar zijn.

Twee opties bepalen hoe bezoekers worden geteld:

Subdomeinen meenemen — volg bezoekers over *.example.com als één gebruiker. Zet dit uit als je subdomeinen losstaande producten bedienen en geen bezoekersprofiel moeten delen.
Getrackte domeinen — voeg alle andere hostnamen toe die hetzelfde gebruikersprofiel moeten delen. Bezoekers die tussen deze domeinen wisselen, worden herkend als één persoon; dat heb je nodig als bijvoorbeeld je checkout op een aparte host staat.

Het paneel Nieuw domein toevoegen in Personyze met het veld voor de URL van de rootpagina, de optie om subdomeinen mee te nemen, en de lijst met getrackte domeinen — Nieuw domein toevoegen: vul de openbare URL van de rootpagina in, bepaal of subdomeinen één bezoekersprofiel delen, en noem alle extra hostnamen die als dezelfde persoon moeten worden behandeld.

Voeg elk domein toe waarop je personaliseert. Wil je liever het hele account met één snippet dekken, gebruik dan de Code voor alle domeinen in plaats van elk domein apart toe te voegen.

Stap 2: installeer de trackingcode

Haal het snippet op via Trackingcode ophalen in de statusbanner (voor het hele account), of via het icoon </> in de kolom Acties van een domein, voor het snippet dat op dat specifieke domein is afgestemd.

De acties per domeinrij in de trackerinstellingen van Personyze, met de knop voor de trackingcode per domein gemarkeerd — Elke domeinrij heeft eigen acties. De knop `</>` opent de trackingcode voor dat specifieke domein; de andere iconen dekken de privacyinstellingen, het bewerken en het verwijderen van het domein.

Het paneel met de trackingcode biedt twee varianten van het snippet:

Asynchroon (aanbevolen) — het standaardsnippet. Het laadt op de achtergrond en blokkeert het weergeven van de pagina nooit. Zet het in de <head> van je site en je bent klaar.
Async + verbergen bij laden (anti-flikker) — gebruik dit als bezoekers op een pagina kunnen komen voordat de beslissingen over personalisatie zijn opgehaald. Het verbergt de content heel even, zodat de oorspronkelijke versie niet oplicht voordat de gepersonaliseerde versie wordt weergegeven.

Belangrijk: kies per pagina één variant — gebruik ze niet door elkaar. Beide snippets mag je wel meer dan één keer opnemen: duplicaten worden herkend.

Het paneel met de trackingcode van Personyze, met het asynchrone snippet, het tabblad met de anti-flikkervariant, en de installatieopties — Het paneel met de trackingcode: kopieer het asynchrone snippet (of schakel naar de anti-flikkervariant) en installeer het daarna via kale HTML, Google Tag Manager, Shopify of WordPress.

Waar je het plaatst

Header van de hoofdpagina (aanbevolen). Zet het snippet in de <head> -tag, zo hoog mogelijk — bij voorkeur direct na je charset-declaratie en de essentiële metatags. Lager plaatsen vertraagt de personalisatie en maakt flikkeren waarschijnlijker.
Tagmanager. Je kunt het snippet via je tagmanagementsysteem uitrollen. Stel het zo in dat het zo vroeg mogelijk afgaat, om die vertraging te beperken. De snelkoppelingen Installeren via in het paneel dekken Kale HTML, Google Tag Manager, Shopify en WordPress.

Voor instructies per platform, zie Installatie per type site — tracking, feeds & integraties.

De installatie controleren

Ga terug naar Trackerinstellingen en bekijk de rij van het domein. De kolom Laatste activiteit toont wanneer Personyze voor het laatst een bezoek van dat domein heeft geregistreerd, en het grafiekje toont de laatste 90 minuten. Toont een domein waarop je net hebt geïnstalleerd Geen bezoeken in de laatste 90 min, dan staat het snippet niet op de pagina, vuurt het niet, of staat het op een andere hostnaam dan de hostnaam die je hebt geregistreerd. Het filter Vuurt niet toont al die domeinen in één keer.

Sluit Personyze uit van caching en optimalisatie

Wat je verder ook installeert, houd Personyze buiten je tools voor caching, minificatie en
“snelheid”. De bibliotheek moet laden en beslissen voordat de bezoeker de pagina ziet. Een
tool die hem vertraagt, bundelt of een gecachte kopie van zijn uitvoer serveert, maakt van personalisatie iets wat te laat
komt — of nooit.

Het symptoom is onmiskenbaar: er wordt niets gepersonaliseerd totdat de bezoeker de muis beweegt. Dat is een
regel die JavaScript vertraagt, geen kapotte tag. De meeste optimalisatietools houden elk script tegen tot de eerste interactie —
en een bezoeker die meteen vertrekt, heeft nooit interactie, dus juist de mensen die je het liefst wilde bereiken, zien de
niet-gepersonaliseerde pagina.

Wat je uitsluit

Drie tekenreeksen, in wat de tool ook maar zijn uitsluitingslijst noemt:

_S_T
stat-track-lib
counter.personyze.com

Item	Wat het dekt
`_S_T`	Het inline snippet, herkend aan de inhoud. Het item dat er echt toe doet — de andere twee zijn externe bestanden en worden nooit opgevraagd zonder dit snippet.
`stat-track-lib`	De trackerbibliotheek zelf.
`counter.personyze.com`	Alles wat de tracker daarna van die host ophaalt — de gecompileerde bundel van je account en de chatwidget.

Instellingen hebben per tool een andere naam. Zoek naar delay JavaScript, defer,
combine en minify, en sluit in elk dezelfde drie tekenreeksen uit. Staat minificatie of combineren van
JavaScript aan, voeg dan counter.personyze.com ook aan die uitsluiting toe — een
tracker van derden in een bundel stoppen is een gebruikelijke manier om hem ongemerkt kapot te maken. Laat opties voor lazy loading en CSS met rust; die
zijn hier niet relevant.

Zo controleer je of het werkte

Open de pagina in een nieuw tabblad en voer, zonder iets aan te raken, dit uit in de browserconsole:

window._S_T && _S_T.uid

Vóór de uitsluiting geeft het undefined terug totdat je de muis beweegt. Daarna meteen een getal. Dat is de hele test — en de reden om die uit te voeren voordat je de pagina aanraakt, want elke
interactie laat de vertraagde scripts los en laat een kapotte opzet er goed uitzien.

WordPress? De exacte instellingen voor WP Rocket staan op de
pagina van de WordPress-plug-in.

Single-page-applicaties (SPA’s) personaliseren

In een single-page-app verandert de URL zonder dat de pagina volledig opnieuw laadt, dus Personyze moet weten welke URL-wijzigingen als nieuwe paginaweergave tellen — dat activeert nieuwe personalisatieacties en sluit acties die niet meer van toepassing zijn.

Open Single-page-app-instellingen boven de domeinlijst en kies welke delen van de URL tellen:

Padwijzigingen — bijv. /shop → /shop/shoes
Querywijzigingen — bijv. ?color=red → ?color=blue
Fragmentwijzigingen — ankers of hashroutes, bijv. #cart

Het pop-upvenster Single-page-app-instellingen in Personyze met opties voor pad-, query- en fragmentwijzigingen — Single-page-app-instellingen: vink de URL-wijzigingen aan die als nieuwe paginaweergave moeten tellen. Routeert je app met hashes, zet dan Fragmentwijzigingen aan; staan filters in de querystring, bepaal dan of elke filterwijziging echt een nieuwe paginaweergave is.

Zie voor meer details de handleiding One-page-applicaties.

Tracking over domeinen

Personyze kan bezoekers automatisch over meerdere domeinen volgen, zodat een persoon die tussen je sites wisselt als één bezoeker wordt herkend in plaats van als meerdere. Het veld Getrackte domeinen bij het toevoegen van een domein koppelt die hostnamen aan één gebruikersprofiel.

Zie voor de volledige installatie de handleiding voor tracking over domeinen.