61 — Popup-Widget für Tenant-Sites
Aktualisiert am 1. Juni 2026
61 — Popup-Widget für Tenant-Sites
Das Popup-Widget ist ein einfaches JavaScript-Snippet, das auf der Tenant-eigenen Webseite läuft und Besucher zum Affiliate-Programm einlädt.
Was tut es?
Auf der Tenant-Webseite erscheint zu einem konfigurierbaren Trigger (Zeit / Scroll / Exit-Intent) ein Popup mit Tenant-Branding, das den Besucher zum Programm einlädt. Klick führt zu <tenant>.partnerdesk.io/recruit oder direkt zum Self-Signup.
Einbinden
<script src="https://<tenant>.partnerdesk.io/partnerdesk-widget.js" async></script>
Eine Zeile — fertig. Konfiguration im Admin-Portal.
Trigger-Modi
| Modus | Wann wird Popup gezeigt |
|---|---|
delay |
N Sekunden nach Seitenaufruf |
scroll |
Bei X % Scroll-Tiefe |
exit-intent |
Bei Mauszeiger Richtung Browser-Tab (Verlassen-Intent) |
Konfiguration
Admin → „Werbemittel" → „Popup-Widget":
| Feld | Funktion |
|---|---|
| Enabled | Master-Switch |
| Headline | z. B. „Werde Partner und verdiene 25 % Provision" |
| Subline | Erläuterungstext |
| CTA-Text | Button-Beschriftung |
| Trigger-Mode | delay / scroll / exit-intent |
| Delay-Sekunden (bei delay) | z. B. 10 s |
| Scroll-Percent (bei scroll) | z. B. 50 % |
| Cooldown-Days | Wie viele Tage nach Klick-Weg keine erneute Anzeige (Default 7) |
Cooldown via LocalStorage
Pro Tenant speichert das Widget einen LocalStorage-Eintrag, wann es zuletzt angezeigt wurde. Innerhalb des Cooldowns wird es nicht erneut gezeigt. So nervt es Besucher nicht.
Tracking
Pro Widget zählt PartnerDesk:
- Impressions (Popup wurde angezeigt).
- Klicks (CTA wurde geklickt).
Beacons werden an /api/widget/{slug}/popup/event gesendet.
Style-Isolation
Das Widget nutzt Inline-Styles (kein externes CSS). Damit gibt es keinen Konflikt mit der Host-Site-CSS — der Tenant kann das Widget einbinden, ohne Style-Anpassungen vornehmen zu müssen.
Optional via Shadow DOM, falls die Host-Site sehr CSS-aggressiv ist.
Datenschutz
- Kein Cookie wird gesetzt (nur LocalStorage für Cooldown).
- Beacons sind anonym.
- Wenn der Tenant einen DSGVO-Consent-Mechanismus hat: das Widget kann hinter dem Consent-Check eingebunden werden — Tenant entscheidet selbst.
Beispiel-Setup
Auf mein-shop.de möchte der Tenant das Widget zeigen:
- PartnerDesk-Admin → Widget konfigurieren mit Texten + Trigger
exit-intent+ Cooldown 7 Tage. - Mein-shop.de:
<script src="https://meinshop.partnerdesk.io/partnerdesk-widget.js" async></script>ans Ende des Body’s. - Besucher kommt, schaut sich um, bewegt Maus Richtung Tab → Popup erscheint: „Werde Affiliate, verdiene 20 % auf jeden Sale".
- Klick → Redirect zu Recruit-Page oder Self-Signup.
Verwandte Kapitel
- 60 — Marketing-Site (eigene Apex)
- 63 — Lead-Affiliate-Programm (Viral-Loop)
- …/134-recruitment-page.md (Recruit-Page-Backend)
Technische Tiefen-Doku: ../097-popup-widget.md