Zum Hauptinhalt springen
Kostenlos3 MinutenEinsteiger

Ghost-Integration

Zenovay Analytics zu Ihrer Ghost-Publikation über Settings → Code Injection → Site Header hinzufügen. Funktioniert auf jedem Ghost-Plan einschließlich selbst gehosteter Instanzen.

ghostcmsblogintegrationtracking-script
Zuletzt aktualisiert:

Fügen Sie Zenovay in zwei Minuten zu jeder Ghost-Publikation hinzu. Code Injection ist auf jedem Ghost-Plan verfügbar, einschließlich selbst gehostetem Ghost CMS — kein Upgrade erforderlich.

Code Injection ist auf allen Ghost-Plänen verfügbar, einschließlich selbst gehostetem Ghost CMS. Benutzerdefinierte Themes benötigen den {{ghost_head}}-Helper in default.hbs (die meisten Themes enthalten ihn bereits).

Schnellstart

  1. Kopieren Sie Ihr Tracking-Snippet aus dem Zenovay Dashboard.
  2. Öffnen Sie in Ihrem Ghost-Admin Settings → Code injection → Site Header.
  3. Fügen Sie das Snippet ein.
  4. Klicken Sie auf Save.

Installation

Site Header-Injection (empfohlen)

  1. Melden Sie sich in Ihrem Ghost-Admin an (üblicherweise https://your-site.com/ghost/).
  2. Klicken Sie auf Settings (Zahnrad-Symbol).
  3. Scrollen Sie zu Site → Code injection.
  4. Fügen Sie dieses Snippet in das Feld Site Header ein:
<script defer data-tracking-code="YOUR_TRACKING_CODE" src="https://api.zenovay.com/z.js"></script>
  1. Klicken Sie auf Save.

Beitrags-/Seitenspezifische Injection

Für Tracking nur eines bestimmten Beitrags:

  1. Öffnen Sie den Beitrag im Editor.
  2. Klicken Sie auf das Zahnrad-Symbol (Einstellungen) oben rechts.
  3. Erweitern Sie Code injection.
  4. Fügen Sie das Snippet in Post Header ein.
  5. Aktualisieren Sie den Beitrag.

Fügen Sie es nicht sowohl seitenweit als auch pro Beitrag ein — es kommt zur doppelten Zählung.

Installation überprüfen

  1. Öffnen Sie Ihre Ghost-Website in einem Inkognito-Fenster.
  2. Zeigen Sie den Quelltext an und suchen Sie nach <script defer data-tracking-code=...> im <head>.
  3. Prüfen Sie die Zenovay Echtzeit-Ansicht — Ihr Besuch erscheint innerhalb von ~30 Sekunden.

Ghost-Mitglieder identifizieren

Ghost stellt das aktuelle Mitglied über /members/api/member/ bereit. Identifizieren Sie auf jeder Seite:

<script>
  fetch('/members/api/member/', { credentials: 'include' })
    .then(r => r.ok ? r.json() : null)
    .then(member => {
      if (member && window.zenovay) {
        window.zenovay('identify', member.uuid, {
          email: member.email,
          name: member.name,
          plan: member.subscriptions?.[0]?.plan?.nickname,
        });
      }
    })
    .catch(() => {});
</script>

Newsletter-Anmeldungen verfolgen

Ghost-Anmeldeformulare senden ein Standard-submit-Ereignis aus:

<script>
  document.addEventListener('DOMContentLoaded', () => {
    document.addEventListener('submit', (e) => {
      const form = e.target;
      if (form?.matches('[data-members-form]')) {
        window.zenovay?.('track', 'signup', {
          form_type: form.dataset.membersForm || 'signup',
        });
      }
    }, true);
  });
</script>

Klicks auf bezahlte Abonnements verfolgen

Ghost rendert Portal-Schaltflächen mit data-portal-Attributen:

<script>
  document.addEventListener('click', (e) => {
    const target = e.target.closest('[data-portal]');
    if (target && window.zenovay) {
      window.zenovay('track', 'portal_opened', {
        action: target.dataset.portal,
      });
    }
  }, true);
</script>

Für präzise Umsatzzuordnung bei bezahlten Mitgliedschaften verwenden Sie die Stripe-Webhook-Integration von Ghost und senden Sie Stripe-Ereignisse über serverseitiges Tracking an Zenovay.

Arbeiten mit benutzerdefinierten Ghost-Themes

Code Injection wird über den {{ghost_head}}-Handlebars-Helper gerendert. Wenn Sie ein benutzerdefiniertes Theme verwenden, stellen Sie sicher, dass default.hbs Folgendes enthält:

{{ghost_head}}

…innerhalb des <head>, vor </head>. Die meisten Ghost-Themes von Drittanbietern (Casper, Source, Edition usw.) enthalten dies standardmäßig.

Fehlerbehebung

Keine Daten, benutzerdefiniertes Theme. Prüfen Sie, ob {{ghost_head}} in Ihrer default.hbs vorhanden ist. Ohne es hat Code Injection keinen Platz zum Rendern.

Keine Daten bei /amp/-URLs. Wenn Sie die Ghost AMP-Integration aktiviert haben, gilt Code Injection nicht für AMP-Varianten (AMP entfernt beliebige Skripte). Deaktivieren Sie entweder AMP oder akzeptieren Sie, dass AMP-Traffic nicht verfolgt wird.

Doppelte Seitenaufrufe. Snippet sowohl in Site Header als auch in beitragsspezifischer Code Injection eingefügt. Wählen Sie einen Bereich.

Mitglieder werden nie identifiziert. /members/api/member/ gibt 404 bei älteren Ghost-Versionen (< 4.x) zurück. Upgraden Sie Ihre Ghost-Installation.

Plan-Voraussetzungen

Ghost-EditionCode InjectionEigene Themes
Ghost(Pro) Starter❌ (nur Casper)
Ghost(Pro) Creator
Ghost(Pro) Team / Business
Selbst gehostetes Ghost CMS

Datenschutz

Für Cookie-freies Tracking fügen Sie data-cookieless="true" hinzu:

<script defer
        data-tracking-code="YOUR_TRACKING_CODE"
        data-cookieless="true"
        src="https://api.zenovay.com/z.js"></script>

Ghosts eigene Mitgliederanalysen verwenden ohnehin First-Party-Cookies, daher ist die Kombination von Zenovay im Cookie-freien Modus ein gängiges Muster.

Nächste Schritte

War dieser Artikel hilfreich?