WordPress-plug-in voor personalisatie

De plug-in Personyze System Integration is de brug tussen een WordPress-site en een Personyze-account. Hij doet vier dingen:

Installeert de tracker op elke pagina, zonder aanpassingen aan het thema.
Voedt de catalogus — berichten, pagina’s en WooCommerce-producten — zodat aanbevelingen, de AI-chatagent en AI-zoeken iets hebben om mee te werken.
Meldt wat de bezoeker leest, op bericht-ID in plaats van op URL.
Host de AI-agent van Personyze in wp-admin, zodat je campagnes kunt bouwen zonder WordPress te verlaten.

Campagnes, aanbevelingen, A/B-tests en ontwerpen bouw je nog steeds in Personyze. De plug-in verbindt de twee en zet de agent waar de content staat.

Vereist WordPress 5.6 of hoger en PHP 7.0 of hoger. Getest tot en met WordPress 7.0.3. Download hem uit de pluginmap van WordPress.

Verbinden met één klik

De plug-in komt nu eerst. Er is geen accountnummer om over te nemen, geen trackingcode om te plakken, geen API-sleutel en geen applicatiewachtwoord om met de hand aan te maken.

Plugins → Nieuwe plugin, zoek op Personyze, installeer en activeer.
Personyze → Settings, daarna Connect to Personyze.
Keur goed op het WordPress-scherm en bevestig daarna het account op het Personyze-scherm.

WordPress maakt het applicatiewachtwoord zelf aan tijdens de goedkeuring en geeft het aan Personyze. Voor de bevestigingsstap moet je in Personyze zijn ingelogd.

Eén klik vereist HTTPS. Op een HTTP-site wordt de knop vervangen door de handmatige stappen hieronder. De minimumversie WordPress 5.6 heeft dezelfde reden: applicatiewachtwoorden kwamen in die release.

Wat er onder de motorkap gebeurt

Goed om te weten als je de integratie beoordeelt:

De plug-in stuurt je naar WordPress’ eigen authorize-application.php met een vaste app-ID en een eenmalige state, die dertig minuten wordt bewaard en wordt gecontroleerd als Personyze het account terugstuurt — zodat een derde je site niet aan een eigen account kan koppelen.
WordPress stuurt door naar Personyze met de site-URL, de gebruikersnaam en het nieuwe wachtwoord in de querystring. Personyze zet die direct in een kortlevende HttpOnly-cookie en stuurt door naar een schone URL, zodat het wachtwoord niet in de adresbalk of de browsergeschiedenis blijft staan.
De verbinding wordt nooit alleen op basis van die doorverwijzing gemaakt. Personyze toont wat er gekoppeld gaat worden — de site, de WordPress-gebruiker, het Personyze-account — en wacht op een klik ter bevestiging.

Handmatige installatie, nog steeds ondersteund

Ongewijzigd: maak een applicatiewachtwoord aan onder Gebruikers → Profiel, en vul daarna de site-URL, gebruikersnaam en het wachtwoord in Personyze in onder Instellingen → Integraties → WordPress.

Waar de plug-in staat

Een eigen hoofdmenu “Personyze” in de zijbalk van de WordPress-admin, met twee schermen. Beide vereisen de bevoegdheid manage_options , dus alleen voor beheerders.

Scherm	Wat het is
AI Agent	De AI-agent van Personyze, over de volle breedte, met ruimte om te werken.
Settings	Verbindingsstatus, de schakelaars voor de feeds, de feed-URL’s en ontkoppelen.

De instellingenpagina is verhuisd. Die stond vroeger onder Instellingen op
options-general.php?page=personyze-config en staat nu op admin.php?page=personyze-config. Oude bladwijzers en interne documentatie die naar het oude adres wijzen, werken niet meer.

De AI-agent in WordPress

Dezelfde agent als in het Personyze-panel, op hetzelfde account — geen uitgeklede versie. Hij verschijnt op drie plekken:

Personyze → AI Agent — een scherm over de volle breedte.
Een launcher rechtsonder op elk wp-admin-scherm.
Een launcher aan de voorkant van je eigen site, zolang je als beheerder bent ingelogd — ook bereikbaar via de WordPress-werkbalk als Personyze AI.

Hij weet op welke pagina je bent. Vraag je het vanaf de voorkant, dan krijgt de agent de URL en titel van de pagina mee, zodat “wat moet ik op deze pagina personaliseren?” en “hier” ergens naar verwijzen. Dat is de hele reden dat de launcher aan de voorkant bestaat.

De AI-agent van Personyze die een campagne bouwt — Dezelfde agent als in wp-admin: gewone woorden erin, echte targetingregels eruit, in gewone woorden teruggelezen voordat er iets draait. Klik om te vergroten.

De meter voor AI-acties

Onder het invoervak, net als in het panel. Hij telt AI-acties — nooit tokens, nooit bedragen — en heeft vijf toestanden:

Normaal: “Nog 42 AI-acties deze maand · vernieuwt op 1 sep”.
Minder dan een kwart over: amber.
Op bij een betaald abonnement: “Maandelijks AI-tegoed gebruikt — verdere AI wordt aan je factuur toegevoegd.”
Op bij een gratis abonnement: rood, met een link Add AI credits.
Geen tegoed ingesteld: de meter verbergt zichzelf helemaal.

Hoe hij zich gedraagt

Het gesprek wordt opgebouwd als je het voor het eerst opent, niet bij het laden van de pagina — het kan op een pagina voor bezoekers staan, en bij de meeste paginaweergaven wordt het nooit geopend.
Of het open of dicht staat, wordt onthouden. Esc sluit het; Enter verstuurt en Shift+Enter maakt een nieuwe regel.
Antwoorden in meerdere stappen tonen tijdens het werken wat er wordt geraadpleegd, in plaats van een leeg wachten.
Het is nooit zichtbaar voor bezoekers. Het wordt alleen weergegeven voor ingelogde gebruikers met
manage_options.

Wat hij wel en niet kan

Hij kan een campagne bouwen op basis van een beschrijving en die in je merkstijl opmaken, targeting samenstellen uit gewone woorden en die aan je teruglezen, voorstellen wat je kunt verbeteren op basis van je eigen verkeer, prestatievragen beantwoorden met echte cijfers, bestaande campagnes beheren en een supportticket openen. Nieuwe campagnes worden in staging aangemaakt en alleen getoond aan bezoekers die van een staging-IP komen — publiceren blijft jouw eigen handeling.

Hij kan niet vragen beantwoorden op basis van de documentatie van Personyze, publiceren naar live bezoekers, zien of veranderen hoe een ontwerp eruitziet (dat doet de actie-editor van het panel), of je WordPress-content bewerken.

Je API-sleutel verlaat je server nooit. De browser praat alleen met je eigen site, wat ook betekent: geen cookies van derden en geen CORS — dus de agent werkt in Safari en Firefox, waar een ingesloten panel dat niet zou doen.

De feeds

Beide staan standaard aan, en de productfeed verschijnt alleen waar WooCommerce actief is. Ze worden geregeld via Personyze → Settings → Feeds in WordPress, niet via het Personyze-panel — wat WordPress zegt, wint, en Personyze neemt het over.

Ze worden eenmaal per dag opnieuw gelezen, elk account op een eigen uur, zodat berichten die je publiceert of bewerkt in aanbevelingen terechtkomen zonder dat iemand ergens op drukt. Een schakelaar omzetten laat het Personyze direct weten in plaats van op de volgende ronde te wachten; is Personyze op dat moment niet bereikbaar, dan wordt de instelling toch opgeslagen, bij de volgende run opgepikt, en zegt het scherm dat.

Wat elke feed bevat

Content — gepubliceerde berichten en pagina’s, zonder de met een wachtwoord beveiligde:

id (de WordPress-bericht-ID) · title · description (de samenvatting) · publish_date (laatst gewijzigd, GMT) · name (slug) · author
· type · comment_count · categories ·
interests (tags) · content_url (de permalink) · thumbnail (de uitgelichte afbeelding)

Producten — gepubliceerde producten, met dezelfde velden plus price (normaal) ·
sale_price · is_in_stock · inventory (voorraadaantal).

Bekijken wat Personyze leest

Het instellingenscherm toont de twee Feed URLs. Er een openen is de snelste manier om “pikt het mijn berichten op?” te beantwoorden, en je kunt een ander systeem naar dezelfde catalogus laten wijzen.

https://SITE/?rest_route=/personyze/v1/sitemap     content
https://SITE/?rest_route=/personyze/v1/products    products

Voeg &limit=20 toe om de eerste paar rijen te bekijken. Ze pagineren met id-from en
limit, 100 rijen per keer.

Ze zijn niet openbaar. Er een openen terwijl je als beheerder bent ingelogd, werkt; al het andere moet zich via HTTPS authenticeren met een applicatiewachtwoord. Ze tonen alleen wat al is gepubliceerd — titels, samenvattingen, permalinks, miniaturen, prijzen, voorraad.

Weten wat de bezoeker leest

Dit is het deel dat de meeste personalisatietools je laten instellen, en hier valt niets in te stellen. Op één bericht, pagina of product vertelt de plug-in Personyze direct de WordPress-bericht-ID:

personyze.push(['Article Viewed', 123]);   // or ['Product Viewed', 55]

De feed exporteert diezelfde ID, dus de catalogussleutel en het weergave-event komen precies overeen. Geen paginagroepen, geen URL-patronen en geen container die de adresbalk uitleest.

Overal elders is hij bewust stil: categorie- en tagarchieven, de berichtenindex, zoekresultaten en berichttypen die geen van beide feeds exporteert. Een feed uitzetten stopt ook het melden van weergaven.

Opgelost in 0.27: op een archief meldt WordPress een term-ID, en oudere versies legden die vast alsof het een bericht-ID was — wat betekende: de ID van een echt artikel, meestal van iets heel anders. Zagen je aanbevelingen er vóór 0.27 op categoriepagina’s vreemd uit, dan was dit de reden.

WooCommerce-integratie

Productsynchronisatie — standaard aan waar WooCommerce actief is.
Tracking van toevoegen aan winkelwagen — wijzigingen in de winkelwagen worden gemeld als Product Added to cart met het aantal, en als Products Removed from cart bij het legen.
Tracking van aankopen — op de pagina voor een ontvangen bestelling wordt elke regel Product Purchased met het aantal.
Toevoegen aan winkelwagen vanuit een Personyze-campagne — een aanbevelingswidget of pop-up kan een product aan de echte WooCommerce-winkelwagen toevoegen, via een endpoint dat de plug-in daarvoor beschikbaar stelt.

Anders dan de twee feeds worden tracking van toevoegen aan winkelwagen en van aankopen in het Personyze-panel aan- en uitgezet.

Je eigen templates, via shortcodes

Personyze kan je site vragen een WordPress-shortcode weer te geven en het resultaat in een campagne te gebruiken. Gepersonaliseerde blokken kunnen dus je eigen templates en de uitvoer van je page builder gebruiken en precies bij het thema passen, in plaats van in Personyze opnieuw te worden gebouwd.

Zo test de verbinding zichzelf ook: na het verbinden stuurt Personyze een token via de shortcoderoute en controleert of het terugkomt — dus “verbonden” betekent dat het hele pad werkt, niet alleen dat inloggegevens zijn opgeslagen.

Van account wisselen, en ontkoppelen

Personyze → Settings → “Connect to a different account, or disconnect”. Ontkoppelen:

Trekt het applicatiewachtwoord in dat Personyze gebruikte, zodat het oude account de site niet meer kan lezen. Alleen wachtwoorden die deze plug-in heeft aangemaakt, worden aangeraakt — die van andere integraties blijven ongemoeid.
Stopt het serveren van de Personyze-tag.
Wist het opgeslagen account, de feeds en de sleutel.
Laat alles wat in Personyze is gebouwd ongemoeid. Het ontkoppelt de twee, meer niet.

Dit is ook de uitweg als de integratie aan de kant van Personyze is verwijderd. Daar kan niets de WordPress-pagina wissen, dus zonder hier te ontkoppelen blijft de site een account noemen waaraan die niet meer is gekoppeld.

Cachingplug-ins: sluit Personyze uit

We raden aan Personyze uit te sluiten van elke plug-in voor caching en optimalisatie die je gebruikt. De personalisatiebibliotheek moet laden en beslissen voordat de bezoeker de pagina ziet. Een plug-in die hem vertraagt, in een bundel minificeert of een gecachte kopie van zijn uitvoer serveert, maakt van personalisatie iets wat te laat komt — of helemaal niet.

Het symptoom verraadt het: er wordt niets gepersonaliseerd totdat de bezoeker de muis beweegt. Dat is een regel die JavaScript vertraagt, geen kapotte tag. De meeste optimalisatieplug-ins houden alle JavaScript 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.

Instellingen in WP Rocket

File Optimization → Delay JavaScript Execution → Excluded JavaScript Files, één per regel:

_S_T
stat-track-lib
counter.personyze.com

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

Nu je er toch bent

Excluded from Minify/Combine — staat minificatie van JavaScript aan, voeg dan
counter.personyze.com daar ook toe. Een tracker van derden in een bundel stoppen is een gebruikelijke manier om hem ongemerkt kapot te maken.
Voeg deze niet toe aan Lazy Load of Remove Unused CSS. Daar zijn ze niet relevant en voegen ze alleen ruis toe.

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 zonder eerst de pagina aan te raken, want elke interactie laat de vertraagde scripts los en laat een kapotte opzet er goed uitzien.

Andere cachingplug-ins noemen deze instellingen anders — zoek naar “delay JavaScript”, “defer”, “combine” of “minify” en sluit dezelfde drie tekenreeksen uit. Dezelfde richtlijnen voor elk platform staan op Personyze installeren.

Als iets kapot lijkt

De agent toont een link naar buiten in plaats van de chat. Een site die vóór 0.27 is gekoppeld, heeft pas een API-sleutel na de volgende configuratieronde van Personyze. Klikken op Test in de WordPress-widget van het panel lost het direct op.
Een nieuw bericht staat nog niet in de aanbevelingen. Feeds worden dagelijks opnieuw gelezen, niet direct — normaal gesproken binnen 24 uur live. Sync sitemap in het panel dwingt het nu af.
De launcher van de agent doet niets. Een cache voor volledige pagina’s die ook pagina’s voor ingelogde beheerders cachet, laat de beveiligingsnonce in de pagina verouderen. De meeste caches slaan ingelogde gebruikers over en hebben hier geen last van.
Er wordt niets gepersonaliseerd totdat de bezoeker de muis beweegt. Een cachingplug-in vertraagt de bibliotheek — zie Cachingplug-ins hierboven.
De knop voor verbinden met één klik ontbreekt. De site draait op HTTP; gebruik de handmatige stappen.
Geen productfeed of schakelaar. WooCommerce is niet actief.

Referentie

REST-routes, onder `personyze/v1`

Pad	Methode	Wie mag hem aanroepen	Doel
`/config`	GET, POST	Alleen Personyze (IP + bevoegdheid)	Account-ID, trackingdomeinen, feedschakelaars en API-sleutel lezen of schrijven
`/content`	POST	Alleen Personyze (IP + bevoegdheid)	Shortcodes weergeven voor campagnecontent
`/sitemap`	GET	Elke beheerder	De contentfeed
`/products`	GET	Elke beheerder	De productfeed
`/stats`	GET	Elke beheerder	Aantallen — berichten, pagina’s, producten
`/assistant`	POST, GET	Elke beheerder	Geeft de AI-agent door — POST is een beurt, GET is het AI-tegoed

/config en /content vereisen daarnaast dat de aanroeper herleidt naar
personyze.com, omdat ze instellingen wijzigen en shortcodes uitvoeren. De alleen-lezen feeds zijn alleen afgeschermd met de bevoegdheid, en daardoor zijn hun URL’s bruikbaar voor jou en voor andere systemen.

Opties die in WordPress worden opgeslagen

personyze_account_id · personyze_tracking_domains ·
personyze_api_key · personyze_sync_articles ·
personyze_sync_products · personyze_track_add_to_cart ·
personyze_track_purchase

Stagingomgeving

Het filter personyze_connect_url overschrijft waar de verbinding met één klik haar inloggegevens naartoe stuurt, voor omgevingen die geen productie zijn.

Wat je op een WordPress-site kunt bouwen

Alles wat Personyze op een pagina kan zetten, werkt hier, met de catalogus die de plug-in levert. Vier van de meest gebruikte:

De pagina bewerken die je al hebt

De live editor van Personyze op een echte pagina — De live editor: wijs een element van je eigen thema aan en verander het. Er wordt niets naar WordPress teruggeschreven — de wijziging wordt getoond aan de doelgroep die je target. Klik om te vergroten.

Een pop-up of banner uit een template

Aanbevelingen uit je eigen berichten

Templates voor contentaanbevelingswidgets in Personyze — De widget voor contentaanbevelingen, opgebouwd uit je eigen berichten — de contentfeed van de plug-in vult hem, dus er valt niets te importeren. Klik om te vergroten.

Of bouw het ontwerp zelf

De Canvas Builder stelt een pop-up, banner of inline blok samen uit elementen — kop, afbeelding, aftelklok, formulier, aanbevelingsstrook — als geen enkele template dicht genoeg in de buurt komt.

Gerelateerd

Begin hier — de andere manieren om Personyze te installeren.
Product- / contentfeeds — wat Personyze doet met wat de plug-in stuurt.
AI-chatagent en AI-zoeken — die antwoorden op basis van deze feeds, zonder aparte indexeringsstap.
AI-agent van Personyze — dezelfde agent, in het panel en vanuit Claude of ChatGPT.