Beaconry installieren und aktivieren

Fünfzehn Minuten vom Klick auf "Kaufen" bis zur ersten Conversion im Meta Events Manager. Kein GTM, kein Stape, kein FTP.

1. Lizenz kaufen

Wähle einen Tier auf der Preisseite. Polar wickelt den Checkout als Merchant of Record ab (MwSt. für EU-Käufer wird automatisch erhoben). Innerhalb einer Minute nach Bezahlung erhältst du zwei E-Mails:

• Polar-Quittung mit deinem Lizenzschlüssel.
• Direkter Download-Link zur aktuellsten beaconry.zip.

Dein Lizenzschlüssel sieht aus wie polar_li_*. Kopier ihn dir. Die .zip enthält immer die neueste Version, du musst sie für Updates nicht erneut herunterladen.

2. System-Voraussetzungen prüfen

• WordPress 6.4 oder neuer.
• PHP 8.3 oder neuer (Beaconry nutzt moderne Type-Hints und Enums).
• HTTPS auf der WordPress-Site (Server-Side-CAPI-Requests müssen von einem TLS-Endpoint stammen).
• Ausgehende HTTPS-Verbindung erlaubt zu graph.facebook.com, business-api.tiktok.com, googleads.googleapis.com, api.linkedin.com und www.google-analytics.com (Beaconry ruft nur die Plattformen auf, die du tatsächlich konfigurierst).

Die meisten Managed-WordPress-Hoster lassen ausgehende HTTPS-Verbindungen standardmäßig zu. Wenn du in einem streng gefilterten VPC betreibst, lass die Plattform-Endpoints freischalten, die du nutzen willst.

3. Plugin installieren

WordPress-Admin → Plugins → Hinzufügen → Plugin hochladen. beaconry.zip auswählen, klick Plugin aktivieren.

Du hast jetzt ein neues Top-Level-Admin-Menü "Beaconry" mit fünf Tabs: Dashboard, Tracking, Forms, Advanced, Logs.

4. Lizenz aktivieren

Geh auf Beaconry → Dashboard. Die oberste Karte fragt nach dem Lizenzschlüssel. Füge den polar_li_*-Key aus der Polar-Quittung ein und klick Aktivieren.

Beaconry ruft die Polar-API einmal auf, validiert den Key, cached das Ergebnis und schaltet das Dashboard von "Inaktiv" auf "Aktiv". Aktivierung erfolgt pro Site, nicht pro WordPress-Netzwerk. Dein Tier (Solo / Studio / Agency) bestimmt, wie viele Produktiv-Sites derselbe Key aktivieren kann.

Power-User: Wenn du den Key aus der Datenbank raushalten willst, definiere BCNR_LICENSE_KEY in wp-config.php. Die Konstante übersteuert, was in wp_options liegt.

5. Den ersten Kanal verbinden

Der Tracking-Tab listet alle fünf Kanäle mit einem Status-Pill pro Kanal. Wähl den, auf dem du gerade am meisten Werbebudget investierst. Standardreihenfolge im UI ist Meta, TikTok, Google Ads, LinkedIn, GA4, du kannst sie aber in beliebiger Reihenfolge unabhängig konfigurieren.

Jeder Kanal hat seine eigene Setup-Anleitung:

• Meta, Pixel + Conversions API
• TikTok, Pixel + Events API
• Google Ads, Conversion-Tracking + CAPI
• LinkedIn, Insight Tag + Conversions API
• GA4, Measurement Protocol

6. Test-Event versenden

Jeder Kanal hat einen Test-Event senden-Button auf dem Tracking-Tab. Klick ihn nach dem Speichern der Credentials. Der Button feuert ein synchrones ViewContent (oder das Plattform-Äquivalent) und meldet die Plattform-Antwort inline.

HTTP 200 mit code: 0 (oder dem Plattform-spezifischen Erfolg) heißt: Credentials passen. HTTP 4xx heißt: ein Credential ist falsch. Der Logs-Tab speichert die letzten 200 Dispatches mit vollem Request- und Response-Payload.

7. Hybrid-Modus entscheiden

Jeder Kanal hat einen "Hybrid-Modus"-Toggle. Server-side allein deckt 100 Prozent der zustimmenden Besucher ab (kein Adblocker kann /wp-json/ blocken). Hybrid lädt zusätzlich den Browser-Pixel der Plattform, damit First-Party-Cookies (fbp, _ttp, li_fat_id) verfügbar werden. Beaconry dedupliziert Browser- und Server-Events über dieselbe stabile event_id.

Empfehlung: Hybrid-Modus ausgeschaltet lassen, bis du First-Party-Cookies wirklich für Match-Rate brauchst. Server-side-Pipeline ist die sicherere Default-Option und liefert weniger Bytes an den Besucher.

Was als Nächstes

Sobald ein Kanal aktiv ist, feuert jede WooCommerce-Bestellung, jeder Kadence-Form-Lead und jede Fluent-Forms-Submission automatisch durch Beaconry. Lies die Server-Side-Dispatch-Doku, um den vollen Event-Fluss zu verstehen, oder spring direkt in die Setup-Guides oben.