Kampagnen

1. Wofuer ist diese Funktion

Die Kampagnen-Seite ist die zentrale Verwaltungsoberflaeche fuer Marketing-Automatisierungen in Octoserv. Sie organisiert Groundhogg-Flows (Funnels) in uebersichtliche Kampagnenkategorien und bietet direkten Zugriff auf verwandte Marketing-Werkzeuge wie Tags, Lead Scoring, Superlinks und Ersetzungsregeln.

Die Seite ist ueber den Navigationspunkt "Kampagnen" in der Sidebar erreichbar (/octo/campaigns) und vereint zwei Hauptfunktionen: die Verwaltung von Flows innerhalb von Kampagnenkategorien (linke Seite, 70%) und den Schnellzugriff auf Marketing-Funktionen (rechte Seite, 30%). Kampagnen dienen dabei als logische Gruppierung fuer zusammengehoerige Flows -- beispielsweise koennen alle Flows zur Leadgewinnung in einer Kampagne "Leadgewinnung" zusammengefasst werden, waehrend Opt-In-Flows in einer Kampagne "Optin" organisiert werden.

Zusaetzlich bietet das Kampagnen-Modul ein Schalter-System (Campaign Controls), mit dem einzelne Marketing-Tags pro Kontakt gezielt ein- oder ausgeschaltet werden koennen. Dieses System wird in der Kontakt-Detailansicht angezeigt und ermoeglicht es Mitarbeitern, Kontakte individuell in Kampagnen aufzunehmen oder davon auszuschliessen.

2. Ziel und Vorteil

• Strukturierte Organisation: Flows werden in benannte Kampagnenkategorien eingeordnet, anstatt in einer unsortierten Liste dargestellt zu werden. Das schafft Ueberblick, auch bei vielen Automatisierungen.
• Ampelsystem: Jeder Flow zeigt ueber eine farbige Statusanzeige (gruen = aktiv, rot = inaktiv) sofort seinen aktuellen Zustand an. Der Benutzer erkennt auf einen Blick, welche Automatisierungen laufen und welche pausiert sind.
• Integrierter Editor: Flows koennen direkt aus der Kampagnen-Uebersicht heraus bearbeitet werden, ohne in das Groundhogg-Backend wechseln zu muessen. Der Groundhogg-Flow-Editor oeffnet sich in einem eingebetteten iFrame mit angepasstem Octoserv-Design.
• Zentraler Funktionszugriff: Tags, Lead Scoring, Superlinks, Ersetzungsregeln und Unterschriften sind als Schnellzugriffe ueber die rechte Seitenleiste erreichbar. Jede Funktion oeffnet sich in einem eigenen iFrame-Modal.
• Sichtbarkeitssteuerung: Administratoren koennen einzelne Kampagnen und Flows als "oeffentlich" oder "versteckt" markieren, um die Ansicht fuer verschiedene Benutzer zu steuern.
• Kontakt-bezogene Steuerung: Ueber Campaign Controls koennen Mitarbeiter Marketing-Tags fuer einzelne Kontakte aktivieren oder deaktivieren, ohne die zugrunde liegenden Flows verstehen zu muessen.

3. Detaillierte Funktionsbeschreibung

3.1 Seitenlayout

Die Kampagnen-Seite verwendet ein 70/30-Raster-Layout:

• Linke Spalte (70%): Baumstruktur der Kampagnenkategorien mit ihren zugeordneten Flows.
• Rechte Spalte (30%): Funktions-Buttons fuer Tags, Lead Score, Superlinks, Ersetzungsregeln und (bei verfuegbarem Contracts-Plugin) Unterschriften.

Das Layout ist responsiv: Ab einer Bildschirmbreite von 768px oder weniger werden beide Spalten untereinander gestapelt.

3.2 Kampagnenkategorien-Baum

Der Kategorienbaum wird beim Laden der Seite per AJAX (octo_load_campaigns_flows) aus der Datenbank geladen und dynamisch im DOM gerendert.

Aufbau einer Kategorie:

Auf-/Zuklappen: Ein Klick auf den Kategorie-Header klappt die Flow-Liste ein oder aus. Der Zustand wird durch CSS-Klassen (collapsed) gesteuert.

3.3 Flow-Elemente

Jeder Flow innerhalb einer Kategorie zeigt folgende Informationen:

3.4 Kampagne erstellen

Ueber den Button "Kategorie erstellen" im Kartenheader oeffnet sich ein modales Dialogfenster.

Formularfelder:

Nach dem Absenden wird die Kampagne per AJAX (octo_create_campaign) in der Groundhogg-Campaigns-Tabelle (wp_gh_campaigns) angelegt. Der Kategorienbaum wird anschliessend automatisch neu geladen.

3.5 Flow erstellen

Ueber den Plus-Button in einer Kategorie wird ein Dialogfenster geoeffnet, in dem der Benutzer einen Titel fuer den neuen Flow eingibt (z.B. "Facebook Leads").

Ablauf:

1. Benutzer gibt den Flow-Titel ein.
2. Per AJAX (octo_create_flow) wird ein neuer Groundhogg-Funnel mit Status "inactive" erstellt.
3. Der Flow wird ueber die Tabelle wp_gh_object_relationships und das Funnel-Meta (campaign_id) mit der Kampagne verknuepft.
4. Der Flow-Editor oeffnet sich automatisch in einem iFrame-Modal.

3.6 Flow bearbeiten (iFrame-Editor)

Der Groundhogg-Flow-Editor wird in einem bildschirmfuellenden Modal (96% Breite, 92% Hoehe) angezeigt. Das WordPress-Admin-Interface (Sidebar, Adminbar, Footer) wird per CSS im iFrame ausgeblendet und durch ein Octoserv-Design ersetzt.

Steuerung:

• Schliessen: Ueber den "Schliessen"-Button, die Escape-Taste oder einen Klick auf den dunklen Overlay-Hintergrund.
• Aktualisierung: Nach dem Schliessen wird der Kategorienbaum automatisch neu geladen, um Aenderungen (z.B. neuer Status) widerzuspiegeln.
• Ladeanzeige: Waehrend der iFrame laedt, wird ein Spinner angezeigt. Der iFrame-Inhalt wird erst sichtbar, nachdem das CSS injiziert wurde (verhindert ein kurzes Aufblitzen des Standard-Designs).

3.7 Flow loeschen

Nach einer Sicherheitsabfrage per Browser-Dialog wird der Flow ueber die Groundhogg-API geloescht. Dabei werden auch die zugehoerigen Eintraege in der Beziehungstabelle (wp_gh_object_relationships) und den Flow-Metadaten (wp_gh_funnelmeta) bereinigt.

3.8 Sichtbarkeitssteuerung

Administratoren (mit der Berechtigung octo_user_can_view_admin_flows) sehen pro Kampagne und pro Flow eine "Oeffentlich"-Checkbox.

Nicht-oeffentliche Elemente werden fuer Benutzer ohne Admin-Berechtigung ausgeblendet.

3.9 Funktions-Buttons (rechte Spalte)

Die rechte Spalte bietet Schnellzugriffe auf verwandte Marketing-Funktionen:

Alle iFrame-Modale verwenden dasselbe Octoserv-Design mit ausgeblendeter WordPress-Admin-Oberflaeche.

3.10 Tags-Verwaltung

Das Tags-Modal ist eine eigene Komponente (nicht iFrame-basiert) mit folgenden Funktionen:

• Tag erstellen: Neues Tag ueber ein Eingabefeld anlegen. Duplikatpruefung (case-insensitive) ist eingebaut.
• Tag bearbeiten: Ueber den Bearbeiten-Button erscheint ein Eingabeprompt zum Umbenennen.
• Tag loeschen: Nach Bestaetigung wird das Tag und alle zugehoerigen Tag-Beziehungen geloescht.
• Tag-Liste: Zeigt alle vorhandenen Tags alphabetisch sortiert an.

3.11 Campaign Controls (Schalter-System)

Campaign Controls sind ein separates Teilsystem, das in der Kontakt-Detailansicht angezeigt wird. Jeder Schalter ist einem Groundhogg-Tag zugeordnet.

Funktionsweise:

1. Ein Administrator erstellt einen Schalter mit Label und zugeordnetem Tag.
2. Der Schalter wird bestimmten Benutzern zugewiesen (oder allen sichtbar gemacht).
3. In der Kontakt-Detailansicht erscheint der Schalter als Toggle-Switch.
4. Wird der Schalter aktiviert, wird das zugeordnete Tag auf den Kontakt angewendet.
5. Wird der Schalter deaktiviert, wird das Tag vom Kontakt entfernt.

Sicherheitsmechanismen:

• Rate-Limiting: Maximal ein Toggle pro 2 Sekunden (pro Benutzer/Kontakt/Schalter).
• Automatisches Polling: Der Zustand der Schalter wird alle 15 Sekunden vom Server abgefragt.
• Rollback: Bei einem Server-Fehler wird der Schalter-Zustand im UI zurueckgesetzt.
• Journal-Logging: Jede Schalteraenderung wird im Aktivitaetsprotokoll protokolliert.

4. Benutzerdokumentation / Anwendung

4.1 Kampagnen-Uebersicht aufrufen

1. In der Sidebar auf "Kampagnen" klicken.
2. Die Seite zeigt links den Kategorienbaum und rechts die Funktions-Buttons.
3. Falls noch keine Kampagnen existieren, erscheint der Hinweis "Keine Kampagnen vorhanden."

4.2 Neue Kampagne erstellen

1. Auf den Button "Kategorie erstellen" oben rechts in der Kategorien-Karte klicken.
2. Im Dialog einen Namen eingeben (Pflichtfeld) und optional eine Beschreibung.
3. Auf "Erstellen" klicken.
4. Die neue Kampagne erscheint im Kategorienbaum.

4.3 Neuen Flow in einer Kampagne erstellen

1. Den Plus-Button neben dem Kampagnennamen klicken.
2. Einen Flow-Titel eingeben (z.B. "Facebook Leads").
3. Auf "Erstellen" klicken.
4. Der Flow wird erstellt und der Groundhogg-Flow-Editor oeffnet sich automatisch.
5. Im Editor Trigger, Aktionen und Bedingungen fuer den Flow konfigurieren.
6. Nach Fertigstellung das Modal ueber "Schliessen" oder die Escape-Taste schliessen.

4.4 Bestehenden Flow bearbeiten

1. Auf den Namen des Flows im Kategorienbaum klicken oder den "Bearbeiten"-Button verwenden.
2. Der Flow-Editor oeffnet sich im iFrame-Modal.
3. Aenderungen vornehmen und im Groundhogg-Editor speichern.
4. Das Modal schliessen -- der Kategorienbaum aktualisiert sich automatisch.

4.5 Flow loeschen

1. Den "Loeschen"-Button (rotes X) neben dem Flow klicken.
2. Die Sicherheitsabfrage mit "OK" bestaetigen.
3. Der Flow wird unwiderruflich geloescht.

4.6 Tags verwalten

1. Auf den Button "Tags" in der rechten Spalte klicken.
2. Im Tags-Modal koennen bestehende Tags bearbeitet oder geloescht werden.
3. Ueber das Eingabefeld am oberen Rand koennen neue Tags erstellt werden.
4. Das Modal ueber "Schliessen" oder die Escape-Taste verlassen.

4.7 Lead Score, Superlinks und Ersetzungsregeln nutzen

1. Den entsprechenden Button in der rechten Spalte klicken.
2. Die Groundhogg-Verwaltungsoberflaeche oeffnet sich im iFrame-Modal.
3. Aenderungen vornehmen und ueber die Groundhogg-Oberflaeche speichern.
4. Das Modal schliessen.

4.8 Sichtbarkeit steuern (nur Administratoren)

1. Die "Oeffentlich"-Checkbox neben einer Kampagne oder einem Flow verwenden.
2. Aktivierte Checkbox: Element ist fuer alle berechtigten Benutzer sichtbar.
3. Deaktivierte Checkbox: Element ist nur fuer Administratoren sichtbar.

5. Anwendungsbeispiele

Beispiel 1: Marketing-Kampagne "Leadgewinnung" einrichten

Ein Unternehmen moechte seine Leadgewinnung ueber verschiedene Kanaele (Facebook, Webseite, Empfehlungen) systematisch abbilden.

Vorgehen:

1. Eine neue Kampagne "Leadgewinnung" erstellen.
2. Drei Flows erstellen: "Facebook Leads", "Webseiten-Formular", "Empfehlungsprogramm".
3. Jeden Flow im Editor mit den passenden Triggern und E-Mail-Sequenzen konfigurieren.
4. Die Kampagne auf "Oeffentlich" stellen, damit alle Mitarbeiter den Status sehen koennen.
5. Ueber das Ampelsystem den Status jedes Kanals im Ueberblick behalten.

Beispiel 2: Kontaktspezifische Newsletter-Steuerung mit Campaign Controls

Ein Vertriebsmitarbeiter moechte steuern, ob ein bestimmter Kontakt den monatlichen Newsletter erhaelt.

Vorgehen:

1. Der Administrator erstellt einen Schalter "Monatlicher Newsletter" mit dem zugehoerigen Tag "newsletter-monatlich".
2. Der Schalter wird dem Vertriebsmitarbeiter zugewiesen.
3. Der Vertriebsmitarbeiter oeffnet die Kontakt-Detailansicht eines Kontakts.
4. Im Bereich "Kampagnen" schaltet er den Toggle "Monatlicher Newsletter" ein.
5. Das Tag "newsletter-monatlich" wird automatisch auf den Kontakt angewendet.
6. Der Kontakt wird ab sofort in den Newsletter-Flow einbezogen.

Beispiel 3: Tag-Verwaltung fuer eine neue Produkt-Kampagne

Vor dem Start einer neuen Produktkampagne muessen die benoetigten Tags angelegt werden.

Vorgehen:

1. Auf der Kampagnen-Seite den Button "Tags" klicken.
2. Folgende Tags anlegen: "Interesse Produkt X", "Produkt X Demo", "Produkt X Kunde".
3. Das Tags-Modal schliessen.
4. Eine neue Kampagne "Produkt X Launch" erstellen.
5. Flows erstellen, die die neuen Tags als Trigger und Aktionen verwenden.
6. Die Flows nacheinander aktivieren und ueber das Ampelsystem den Fortschritt ueberwachen.