Serverseitige Personalisierung

Personyze wird normalerweise als JavaScript-Snippet installiert: Es lädt im Browser des Besuchers, entscheidet, was angezeigt wird, und rendert es in der Seite. Für die meisten Websites ist das die richtige Wahl.

Dieselbe Entscheidungs-Engine antwortet aber auch über HTTP, sodass Ihr eigener Server fragen kann: „Was soll dieser Besucher sehen?“, und die Antwort selbst rendert. Im Browser lädt nichts, und die Seite kommt bereits personalisiert an.

Ist das etwas für Sie?

Nutzen Sie serverseitige Personalisierung, wenn:

Sie Seiten auf dem Server rendern und das kurze Aufblitzen der Standardinhalte vermeiden möchten, bevor die Personalisierung greift. Eine serverseitig gerenderte Variante ist einfach die Seite — es gibt nichts auszutauschen und nichts zu verstecken.
Sie etwas Unsichtbares per A/B-Test prüfen möchten. Einen anderen Ranking-Algorithmus, einen anderen Preis, eine andere API-Antwort. Es gibt kein Element auf der Seite, das sich ändern ließe; ein visuelles Tool hat also nichts, womit es arbeiten könnte.
Es keinen Browser gibt. Eine native App, ein Kiosk, eine Set-Top-Box, eine E-Mail-Pipeline, ein Support-Tool. Alles, was eine HTTPS-Anfrage stellen kann, lässt sich personalisieren.
Das Snippet blockiert wird. Werbeblocker, strenge Content-Security-Policies und Unternehmens-Proxys stoppen Skripte von Drittanbietern. Ein serverseitiger Aufruf ist Ihr Server, der mit unserem spricht.

Bleiben Sie beim Browser-Snippet, wenn Sie sichtbare Seitenelemente auf einer gewöhnlichen Website personalisieren und Kampagnen im visuellen Editor bauen möchten, ohne einen Entwickler einzubinden. Sie können auch beides tun: Serverseitige Aufrufe und Browsersitzungen teilen sich ein Besucherprofil und eine A/B-Zuordnung, solange beide die Person auf dieselbe Weise identifizieren.

So funktioniert es

Ein einziger HTTPS-Endpunkt erledigt alles. Sie teilen Personyze mit, was der Besucher gerade getan hat, und es sagt Ihnen, was als Nächstes passieren soll:

Ihr Server ruft Personyze auf, wenn er gleich etwas rendert — eine Seite, eine Produktliste, eine API-Antwort.
Personyze antwortet mit Aktions-IDs: den Kampagnen, die gerade auf diesen Besucher passen, und dem, was er sehen soll.
Ihr Code entscheidet, was jede ID bedeutet. Aktion 88 kann „das Banner für kostenlosen Versand anzeigen“ oder „Ranking-Algorithmus B verwenden“ bedeuten. Sie ordnen IDs in Ihrem eigenen Code einem Verhalten zu oder lesen die fertigen Inhalte aus der Antwort.
Sie teilen Personyze mit, was Sie getan haben. Das macht Berichte und A/B-Ergebnisse erst aussagekräftig.

Alles, was Sie bereits im Panel konfigurieren, gilt weiterhin: Zielgruppen, Targeting-Regeln, Zeitplanung, A/B-Aufteilungen und die Berichte.

Einen A/B-Test durchführen

Richten Sie den Test im Panel genau so ein wie einen Test auf der Website — eine A/B-Test-Kampagne, eine Aktion pro Variante und Ihre Gewinnerkriterien. Für einen rein serverseitigen Test brauchen die Aktionen überhaupt keinen Inhalt: Die ID allein sagt Ihrem Code, welchen Zweig er nehmen soll.

Dann in Ihrem Code: Rufen Sie Personyze am Entscheidungspunkt auf, verzweigen Sie nach der zurückgegebenen Aktions-ID und melden Sie das Ergebnis.

Personyze teilt Besucher den Varianten zu — Sie dürfen das nicht tun. Personyze hält die Zuordnung und behält jeden Besucher über Besuche und Geräte hinweg in derselben Variante, solange Sie ihn einheitlich identifizieren. Teilt Ihr Code den Traffic zusätzlich auf, sind sich beide Systeme uneinig, wer in welcher Variante ist, und die Ergebnisse verlieren jede Aussagekraft.

Zwei Dinge, die oft übersehen werden — beide sollten Sie vor dem Start prüfen:

Melden Sie, dass Sie die Variante gerendert haben. Eine Aktion, die Sie nie melden, sieht aus, als wäre sie nie gelaufen. Ihre Variante verliert den Test nicht — sie scheint überhaupt keinen Traffic gehabt zu haben, und der Test kann nie abgeschlossen werden.
Melden Sie das Ergebnis in der Form, die Ihr Gewinnerkriterium misst. Ein Test, der nach Käufen bewertet wird, reagiert nicht auf gemeldete Klicks. Passen Sie das Signal an das gewählte Kriterium an, sonst sieht die Variante so aus, als hätte sie nichts bewirkt.

Die Ergebnisse erscheinen im Panel genau wie bei Tests auf der Website — Signifikanz, Verbesserung gegenüber der Kontrollgruppe und der Gewinner — und lassen sich auch programmatisch abrufen, wenn Sie sie in Ihrem eigenen Dashboard haben möchten.

Offizielle Bibliotheken

Sie können den Endpunkt direkt mit jedem HTTP-Client aufrufen. Für die gängigen Stacks gibt es Bibliotheken, die sich um die Details kümmern, die man leicht falsch macht — die Sitzung halten, schnell in ein Timeout laufen und nie zulassen, dass ein Personalisierungsaufruf die Seite lahmlegt, die er personalisiert:

Node.js / TypeScript — npm install @personyze/node, mit Helfern für Express und Next.js.
PHP — composer require personyze/personyze.
Python — pip install personyze, mit Helfern für Django und Flask.

Jede davon ist ein dünner Wrapper um denselben Endpunkt; nichts wird vor Ihnen verborgen, und Sie können jederzeit auf reines HTTP umsteigen.

Performance und Sicherheit

Ein Personalisierungsaufruf liegt im Pfad eines Seiten-Renderings; die Bibliotheken nutzen daher standardmäßig ein Timeout von 1 Sekunde und scheitern offen: Ist Personyze langsam oder nicht erreichbar, erhält Ihr Code eine leere Antwort und rendert seinen Standard. Ihre Seite wartet nie auf uns und bricht nie wegen uns.

Der Aufruf wird mit einem API-Schlüssel über HTTPS authentifiziert. Behalten Sie ihn auf Ihrem Server — er hat vollen Zugriff auf Ihr Konto, anders als das Tracker-Snippet, das bewusst öffentlich ist.

Was Sie für den Einstieg brauchen

Einen API-Schlüssel. Im Panel: Einstellungen → Integrationen → Vollwertige API.
Eine stabile Besucher-ID. Ihre eigene Nutzer-ID, eine Geräte-ID, ein Hash — alles, was Sie für dieselbe Person beim nächsten Mal reproduzieren können. Dadurch bleibt jemand über Besuche hinweg in derselben A/B-Variante.
Einen Ort für die Sitzung. Personyze gibt mit jeder Antwort einen Sitzungswert zurück; übergeben Sie ihn beim nächsten Aufruf wieder. Wo Sie bereits Sitzungszustand speichern, ist der richtige Ort.

Nächste Schritte

Die vollständige technische Dokumentation — Anfrage- und Antwortformate, das Befehlsvokabular, das A/B-Rezept und ein ausgearbeitetes Beispiel — finden Sie im Entwicklerleitfaden: Serverseitige Personalisierung und A/B-Tests.

Wenn Sie nicht sicher sind, ob serverseitig für Ihren Fall richtig ist, wenden Sie sich an den Support und beschreiben Sie, was Sie personalisieren möchten; oft ist die Antwort kurz.