Entwicklerressourcen: REST-API, Vorlagensprache und SDKs

Personyze bietet eine REST-API zur programmatischen Verwaltung Ihres Kontos, eine Vorlagensprache zum Schreiben von Aktions-HTML und eine Reihe von SDKs für native mobile Apps und die Integration mit Tag-Managern. Diese Seite ist der Einstiegspunkt — kurze Überblicke plus Links zur vollständigen Referenzdokumentation.

REST-API

Mit der REST-API von Personyze können Anwendungen von Drittanbietern Daten in Ihrem Konto lesen und ändern: Nutzer und Nutzerlisten verwalten, mit Produkt- und Artikelkatalogen arbeiten, Platzhalter und Aktionen steuern, Live-Operationen auf Online-Nutzern ausführen, tägliche Berichtszusammenfassungen abfragen und mehr. Sie nutzt Standard-HTTP, nimmt JSON an und gibt JSON zurück und unterstützt die vier Standardverben (GET, POST, PUT, DELETE).

Kurzes Beispiel

Den Nutzer mit der internen ID abrufen 42:

curl 'https://api:YOUR_API_KEY@app.personyze.com/rest/users/where/internal_id=42'

Der allgemeine Aufbau jeder Anfrage:

https://api:<API_KEY>@app.personyze.com/rest/<object>[/<modifier>/<value>...]

Vollständige REST-API-Referenz (4 Artikel)

📖 Überblick & SchnellstartAufbau von Anfragen, HTTP-Methoden, Antwortcodes, Konventionen wie id vs. internal_id. Lesen →

🔑 AuthentifizierungIhren API-Schlüssel erhalten, ihn per Header oder URL senden, Fehlercodes, Muster für mehrere Konten. curl-, Python- und JS-Beispiele. Lesen →

🧩 PfadparameterDie Syntax where / columns / order_by / limit mit allen Operatoren, UND/ODER-Verknüpfung und Regeln für indexierte Spalten. Lesen →

📚 ObjektreferenzSeiten für alle 18 Endpunkte — Nutzer, Produkte, Artikel, Aktionen, Platzhalter, Interaktionen, Ereignisse, Sitzungen, Zusammenfassungen. Lesen →

Vorlagensprache

Personyze-Aktionen (Banner, Popups, Empfehlungs-Widgets, E-Mails) werden in einer Vorlagensprache geschrieben, die größtenteils aus einfachem HTML und CSS besteht, mit Direktiven für bearbeitbare Parameter, Schleifen über Personyze-Tabellen (Produkte, Artikel), Bedingungen und speziellen Klassennamen, die gewöhnliche Elemente in Personyze-fähige Widgets verwandeln.

📝 Vorlagensprache — Referenz für Aktions-HTMLVollständige Syntaxreferenz: ${args} -Variablen, Nutzer- & Sitzungsvariablen, Funktionen, ${foreach} -Tabellenschleifen, Bedingungen, spezielle Klassen mit dem Präfix $(zum Beispiel$responsive, $btn, $popup, $cformusw.), Formularverarbeitung und die ${menu} -Direktiven, die den visuellen Editor aufbauen. Dazu die GitHub-Bibliothek mit 12 sofort nutzbaren Beispielvorlagen. Lesen →

SDKs & Tools auf GitHub

Während REST-API und Vorlagensprache nun vollständig im Wiki dokumentiert sind, liegt der gesamte Open-Source-Code von Personyze weiterhin auf GitHub unter github.com/personyze:

Native mobile SDKs

📱 Android SDK (Java)Vollständiges Personyze-Tracking und Personalisierung für Android-Apps. Repo → · Demo-App →

🍎 iOS SDK (Swift)Native iOS-Integration mit demselben Funktionsumfang wie das Android SDK. Repo → · Demo-App →

Beide SDKs stehen unter der MIT-Lizenz. Die Demo-Apps sind lauffähige Referenzen, die den gesamten Ablauf von der Einrichtung bis zur Personalisierung zeigen. Eine geführte Anleitung finden Sie unter Produktempfehlungen in mobilen Apps.

Web-Tools

🏷 Google Tag Manager-VorlageDer Personyze-Tracking-Code als importierbare GTM-Vorlage. Fügen Sie ihn Ihrem Container hinzu, statt das Snippet von Hand einzubauen. Repo →

📑 Quellcode der VorlagenspracheQuelltext der Referenz zur Vorlagensprache (oben) plus 12 vollständig kommentierte Beispielvorlagen: Popups, Formulare, Timer, Empfehlungen, E-Mails, Social Proof. Repo →

Kombinieren Sie die GTM-Vorlage mit der Anleitung zur Einrichtung des Google Tag Manager für den vollständigen Integrationsablauf.

Einrichtung nach Website-Typ — Tracking, Feeds & Integrationen — wählen Sie Ihren Ausgangspunkt je nach Art Ihrer Website.
Tracking von Produktinteraktionen — Ereignisse, die auf Webseiten ausgelöst werden.
Einrichtung des Produkt- / Content-Feeds — die Katalogseite von API-Integrationen.
Leitfaden für JavaScript-Aktionen — zum Schreiben eigener Personyze-Aktionen in Code.