Das WordPress-Plugin für Personalisierung

Das Plugin Personyze System Integration ist die Brücke zwischen einer WordPress-Website und einem Personyze-
Konto. Es erledigt vier Dinge:

1. Es installiert den Tracker auf jeder Seite, ohne Änderungen am Theme.
2. Es speist den Katalog — Beiträge, Seiten und WooCommerce-Produkte —, damit Empfehlungen, der
   KI-Chat-Agent und die KI-Suche etwas haben, womit sie arbeiten können.
3. Es meldet, was der Besucher liest, per Beitrags-ID statt per URL.
4. Es bringt den Personyze-KI-Agenten in wp-admin, sodass sich Kampagnen bauen lassen, ohne
   WordPress zu verlassen.

Kampagnen, Empfehlungen, A/B-Tests und Designs werden weiterhin in Personyze gebaut. Das Plugin verbindet beides und bringt
den Agenten dorthin, wo die Inhalte sind.

Erfordert WordPress 5.6 oder neuer und PHP 7.0 oder neuer. Getestet bis WordPress 7.0.3.
Im
WordPress-Plugin-Verzeichnis herunterladen.

Verbinden mit einem Klick

Das Plugin kommt jetzt zuerst. Keine Kontonummer, kein Tracking-Code, kein API-
Schlüssel und kein Anwendungspasswort, das Sie von Hand anlegen müssten.

1. Plugins → Installieren, nach Personyze suchen, installieren und aktivieren.
2. Personyze → Einstellungen, dann Connect to Personyze.
3. Bestätigen Sie auf dem WordPress-Bildschirm und dann das Konto auf dem Personyze-Bildschirm.

WordPress stellt das Anwendungspasswort bei der Bestätigung selbst aus und übergibt es an Personyze. Für den Bestätigungsschritt müssen Sie
bei Personyze angemeldet sein.

Was darunter passiert

Wissenswert, wenn Sie die Integration prüfen:

• Das Plugin schickt Sie zur WordPress-eigenen authorize-application.php mit einer festen App-ID und einem
  einmaligen State, der dreißig Minuten gespeichert und geprüft wird, wenn Personyze das Konto zurücksendet — so
  kann kein Dritter Ihre Website an ein eigenes Konto binden.
• WordPress leitet mit der Website-URL, dem Benutzernamen und dem neuen Passwort im Query-String zu Personyze weiter.
  Personyze verschiebt diese sofort in ein kurzlebiges HttpOnly-Cookie und leitet auf eine saubere URL weiter, damit
  das Passwort weder in der Adresszeile noch im Browserverlauf bleibt.
• Die Verbindung entsteht nie allein durch diese Weiterleitung. Personyze zeigt, was verbunden werden soll
  — die Website, den WordPress-Benutzer, das Personyze-Konto —, und wartet auf einen bestätigenden Klick.

Websites mit HTTP

Die Verbindung per Klick erfordert HTTPS. Läuft Ihre Website noch über HTTP, stellen Sie sie auf HTTPS um, damit der Button erscheint, oder wenden Sie sich an den Personyze-Support, der Ihnen beim Verbinden hilft.

Wo das Plugin zu finden ist

Ein eigenes Hauptmenü „Personyze“ in der Seitenleiste von WordPress-Admin, mit zwei Bildschirmen. Beide
erfordern die Capability manage_options , also nur für Administratoren.

Der KI-Agent in WordPress

Derselbe Agent wie im Personyze-Panel, im selben Konto — keine abgespeckte Version. Er erscheint an drei
Stellen:

• Personyze → AI Agent — ein Bildschirm in voller Breite.
• Ein Starter unten rechts auf jedem Bildschirm von wp-admin.
• Ein Starter im Frontend Ihrer eigenen Website, solange Sie als Administrator angemeldet sind —
  auch über die WordPress-Werkzeugleiste als Personyze AI erreichbar.

Die Anzeige der KI-Aktionen

Unter dem Eingabefeld, wie im Panel. Sie zählt KI-Aktionen — nie Tokens, nie
Geldbeträge — und hat fünf Zustände:

• Normal: „Noch 42 KI-Aktionen diesen Monat · Erneuerung am 1. Sep.“.
• Weniger als ein Viertel übrig: gelb.
• Aufgebraucht bei einem kostenpflichtigen Tarif: „Monatliches KI-Kontingent aufgebraucht — weitere KI wird Ihrer Rechnung hinzugefügt.“
• Aufgebraucht bei einem kostenlosen Tarif: rot, mit einem Link Add AI credits.
• Kein Kontingent konfiguriert: Die Anzeige blendet sich ganz aus.

Wie er sich verhält

• Das Gespräch wird beim ersten Öffnen aufgebaut, nicht beim Laden der Seite — der Agent kann auf einer Seite für Besucher
  sitzen, und die meisten Seitenaufrufe öffnen ihn nie.
• Ob er offen oder geschlossen ist, wird gespeichert. Esc schließt ihn; Enter sendet, und
  Shift+Enter erzeugt eine neue Zeile.
• Mehrstufige Antworten zeigen während der Arbeit, was gerade herangezogen wird, statt leer zu warten.
• Er ist für Besucher nie sichtbar. Er wird nur für angemeldete Nutzer mit
  manage_options.

Was er kann und was nicht

Er kann eine Kampagne aus einer Beschreibung bauen und an Ihre Marke anpassen, Targeting aus einfachen
Worten erstellen und Ihnen vorlesen, aus Ihrem eigenen Traffic Verbesserungen vorschlagen, Leistungsfragen mit echten
Zahlen beantworten, bestehende Kampagnen verwalten und ein Support-Ticket eröffnen. Neue Kampagnen werden im Staging angelegt,
nur für Besucher sichtbar, die von einer Staging-IP kommen — das Veröffentlichen bleibt Ihre eigene Handlung.

Die Feeds

Beide sind standardmäßig an, und der Produkt-Feed erscheint nur, wo WooCommerce aktiv ist. Sie werden
in WordPress unter Personyze → Einstellungen → Feeds gesteuert, nicht im Personyze-
Panel — was WordPress sagt, gilt, und Personyze übernimmt es.

Sie werden einmal täglich neu gelesen, jedes Konto zu seiner eigenen Stunde; Beiträge, die Sie veröffentlichen oder bearbeiten, erreichen
die Empfehlungen also, ohne dass jemand etwas drücken muss. Das Umlegen eines Schalters informiert Personyze sofort, statt auf
den nächsten Durchlauf zu warten; ist Personyze in dem Moment nicht erreichbar, wird die Einstellung trotzdem gespeichert, beim nächsten Lauf übernommen, und
der Bildschirm sagt das.

Was jeder Feed enthält

Inhalte — veröffentlichte Beiträge und Seiten, ohne passwortgeschützte:

id (die WordPress-Beitrags-ID) · title · description (der Auszug)
· publish_date (zuletzt geändert, GMT) · name (Slug) · author
· type · comment_count · categories ·
interests (Tags) · content_url (der Permalink) · thumbnail (das
Beitragsbild)

Produkte — veröffentlichte Produkte, mit denselben Feldern plus price (regulär) ·
sale_price · is_in_stock · inventory (Lagerbestand).

Nachsehen, was Personyze liest

Der Einstellungsbildschirm zeigt die beiden Feed-URLs. Eine davon zu öffnen, ist der schnellste Weg zur Antwort auf „Werden
meine Beiträge erfasst?“, und Sie können ein anderes System auf denselben Katalog richten.

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

Hängen Sie &limit=20 an, um die ersten Zeilen anzusehen. Sie blättern mit id-from und
limit, jeweils 100 Zeilen.

Wissen, was der Besucher liest

Das ist der Teil, den die meisten Personalisierungstools Sie konfigurieren lassen, und hier gibt es nichts zu konfigurieren. Auf einem einzelnen
Beitrag, einer Seite oder einem Produkt teilt das Plugin Personyze direkt die WordPress-Beitrags-ID mit:

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

Der Feed exportiert dieselbe ID; Katalogschlüssel und Aufrufereignis passen also genau zusammen. Keine
Seitengruppen, keine URL-Muster und kein Container, der die Adresszeile ausliest.

Überall sonst schweigt es bewusst: Kategorie- und Tag-Archive, der Beitragsindex, Suchergebnisse und Beitragstypen,
die keiner der Feeds exportiert. Einen Feed auszuschalten, stoppt auch seine Aufrufmeldungen.

WooCommerce

• Produktsynchronisierung — standardmäßig an, wo WooCommerce aktiv ist.
• Tracking von „In den Warenkorb“ — Warenkorbänderungen werden als Product Added to cart mit der
  Menge gemeldet, und Products Removed from cart beim Leeren.
• Kauf-Tracking — auf der Seite „Bestellung erhalten“ wird jede Position zu Product Purchased
  mit ihrer Menge.
• In den Warenkorb aus einer Personyze-Kampagne — ein Empfehlungs-Widget oder Pop-up kann ein Produkt in
  den echten WooCommerce-Warenkorb legen, über einen Endpunkt, den das Plugin dafür bereitstellt.

Anders als die beiden Feeds werden Warenkorb- und Kauf-Tracking im Personyze-Panel geschaltet.

Ihre eigenen Vorlagen, per Shortcode

Personyze kann Ihre Website bitten, einen WordPress-Shortcode zu rendern, und das Ergebnis in einer Kampagne nutzen. Personalisierte Blöcke
können daher Ihre eigenen Vorlagen und die Ausgabe Ihres Page Builders nutzen und exakt zum Theme passen, statt in
Personyze nachgebaut zu werden.

So testet sich die Verbindung auch selbst: Nach dem Verbinden sendet Personyze ein Token über den Shortcode-Weg und
prüft, ob es zurückkommt — „verbunden“ heißt also, dass der ganze Weg funktioniert, nicht nur, dass Zugangsdaten
gespeichert wurden.

Konto wechseln und trennen

Personyze → Einstellungen → „Connect to a different account, or disconnect“.
Das Trennen:

• Widerruft das Anwendungspasswort, das Personyze genutzt hat, sodass das alte Konto die
  Website nicht mehr lesen kann. Betroffen sind nur Passwörter, die dieses Plugin angelegt hat — die einer anderen Integration bleiben unberührt.
• Stoppt die Auslieferung des Personyze-Tags.
• Löscht das gespeicherte Konto, die Feeds und den Schlüssel.
• Lässt alles, was in Personyze gebaut wurde, unberührt. Es löst nur die Verknüpfung, mehr nicht.

Caching-Plugins: Personyze ausnehmen

Wir empfehlen, Personyze von jedem Caching- und Optimierungs-Plugin auszunehmen, das Sie nutzen. Die
Personalisierungsbibliothek muss laden und entscheiden, bevor der Besucher die Seite sieht. Ein Plugin, das sie verzögert,
in ein Bundle minifiziert oder eine zwischengespeicherte Kopie ihrer Ausgabe ausliefert, macht Personalisierung zu etwas, das zu spät
ankommt — oder gar nicht.

WP Rocket

File Optimization → Delay JavaScript Execution → Excluded JavaScript Files, einer pro
Zeile:

_S_T
stat-track-lib
counter.personyze.com

Wenn Sie schon dabei sind

• Excluded from Minify/Combine — ist die JavaScript-Minifizierung an, fügen Sie
  counter.personyze.com auch dort hinzu. Einen Tracker eines Drittanbieters in ein Bundle zu packen, ist ein häufiger Weg,
  ihn unbemerkt zu beschädigen.
• Fügen Sie diese nicht bei Lazy Load oder Remove Unused CSS hinzu. Dort spielen sie keine Rolle und erzeugen nur
  Rauschen.

So prüfen Sie, ob es funktioniert hat

Öffnen Sie die Seite in einem neuen Tab und führen Sie, ohne etwas anzufassen, dies in der Browserkonsole aus:

window._S_T && _S_T.uid

Andere Caching-Plugins benennen diese Einstellungen anders — suchen Sie nach „delay JavaScript“, „defer“, „combine“ oder „minify“ und nehmen Sie dieselben drei Zeichenfolgen aus. Dieselbe Anleitung für jede Plattform steht unter Personyze aktivieren.

Wenn etwas defekt aussieht

• Der Agent zeigt einen Link nach außen statt des Chats. Eine vor 0.27 verbundene Website hat bis zum nächsten
  Konfigurationslauf von Personyze keinen API-Schlüssel. Ein Klick auf Test im WordPress-Widget des Panels behebt das
  sofort.
• Ein neuer Beitrag ist noch nicht in den Empfehlungen. Feeds werden täglich neu gelesen, nicht sofort — normalerweise
  innerhalb von 24 Stunden live. Sync sitemap im Panel erzwingt es sofort.
• Der Starter des Agenten tut nichts. Ein Ganzseiten-Cache, der Seiten für angemeldete Administratoren zwischenspeichert,
  lässt die in die Seite eingebettete Sicherheits-Nonce veralten. Die meisten Caches umgehen angemeldete Nutzer und sind nicht betroffen.
• Nichts wird personalisiert, bis der Besucher die Maus bewegt. Ein Caching-Plugin verzögert die Bibliothek — siehe Caching-Plugins oben.
• Der Button für die Verbindung per Klick fehlt. Die Website läuft über HTTP; siehe „Websites mit HTTP“ oben.
• Kein Produkt-Feed oder -Schalter. WooCommerce ist nicht aktiv.

Referenz

REST-Routen, unter personyze/v1

/config und /content verlangen zusätzlich, dass der Aufrufer zu
personyze.comauflöst, weil sie Einstellungen ändern und Shortcodes ausführen. Die schreibgeschützten Feeds sind nur an die
Capability gebunden; deshalb können Sie und andere Systeme ihre URLs nutzen.

In WordPress gespeicherte Optionen

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

Staging

Der Filter personyze_connect_url legt fest, wohin die Verbindung per Klick ihre Zugangsdaten sendet, für
Nicht-Produktivumgebungen.

Was Sie auf einer WordPress-Website bauen können

Alles, was Personyze auf eine Seite bringen kann, funktioniert hier, mit dem Katalog, den das Plugin liefert. Vier der
häufigsten:

Die vorhandene Seite bearbeiten

Ein Pop-up oder Banner aus einer Vorlage

Empfehlungen aus Ihren eigenen Beiträgen

Oder das Design selbst bauen

Der Canvas Builder setzt ein Pop-up, ein Banner oder einen Inline-Block aus
Elementen zusammen — Überschrift, Bild, Countdown, Formular, Empfehlungsstreifen —, wenn keine Vorlage nah genug ist.

Verwandte Themen

• Hier starten — die anderen Wege, Personyze zu installieren.
• Produkt- / Inhalts-Feeds — was
  Personyze mit dem macht, was das Plugin sendet.
• KI-Chat-Agent und KI-Suche — sie antworten aus diesen
  Feeds, ohne eigenen Indexierungsschritt.
• Personyze-KI-Agent — derselbe Agent, im Panel und aus Claude oder
  ChatGPT.