> ## Documentation Index
> Fetch the complete documentation index at: https://help.scribe-mail.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Conversion-Tracking

> Verfolgen Sie Website-Anmeldungen, Demos und Käufe mit dem Scribe JavaScript SDK und ordnen Sie jede Conversion der E-Mail-Signatur zu, die sie ausgelöst hat.

Conversion-Tracking schließt den Kreis Ihrer E-Mail-Signaturen. Die Signatur-Analytics zeigt Ihnen bereits Views und Klicks. Mit dem Scribe JavaScript SDK erfassen Sie zusätzlich, was danach auf Ihrer eigenen Website passiert — Anmeldungen, gebuchte Demos, Käufe — und verknüpfen jedes Ereignis mit der Signatur, dem Teammitglied und dem Link, der es ausgelöst hat. Das ist der untere Teil des Funnels: Views, dann Klicks, dann Conversions.

In Scribe heißen diese Conversions **Events**. Sie erfassen sie mit wenigen Zeilen JavaScript, und Scribe ordnet sie automatisch über dasselbe Klick-Tracking zu, das auch den Rest Ihrer Analytics speist.

<Note>
  Conversion-Tracking ist in den kostenpflichtigen Tarifen enthalten. Wenn der Tarif Ihres Workspace es nicht umfasst, erfasst das Tracking-Snippet nichts.
</Note>

## So funktioniert es

1. Ein Empfänger klickt auf einen Link in einer Ihrer E-Mail-Signaturen.
2. Scribe leitet ihn auf Ihre Website weiter und fügt der Ziel-URL einen `scribe_click_id`-Parameter hinzu.
3. Das Scribe SDK auf Ihrer Landingpage liest diesen `scribe_click_id`, speichert ihn als First-Party-Daten und hängt ihn an jedes Event an, das Sie erfassen.
4. Wenn der Besucher konvertiert, rufen Sie `scribe.track('signup')` auf. Scribe verknüpft das Event mit dem ursprünglichen Klick.

Das Ergebnis: Sie sehen, welche Signaturen, Teammitglieder und angeklickten Elemente echte Conversions und Umsatz erzeugen — nicht nur Klicks. Die Attribution funktioniert auf Sender-, Signatur- und Element-Ebene, und Scribe ordnet eine Conversion bis zu 30 Tage nach dem Klick dem auslösenden Klick zu.

Wenn ein Ereignis ohne bekannte `scribe_click_id` eintrifft (Direktzugriff, abgelaufener Link oder entfernter Parameter), wird es dennoch erfasst. Es wird nur keinem Klick zugeordnet.

## Bevor Sie beginnen

Sie benötigen drei Dinge:

* **Einen kostenpflichtigen Tarif**, der Conversion-Tracking enthält.
* **Aktiviertes Tracking** für Ihren Workspace. Dies ist dieselbe Einstellung, die die Analysen zu Signaturaufrufen und -klicks steuert. Aktivieren Sie sie erst, wenn Sie über die erforderliche Einwilligung verfügen (siehe [Datenschutz und Einwilligung](#privacy-and-consent)).
* **Ihre Event Tracking ID.** Dies ist eine öffentliche, nicht geheime Kennung für Ihren Workspace. Sie kann sicher in den HTML-Code Ihrer Website eingebettet werden.

<Steps>
  <Step title="Copy your Event Tracking ID">
    Öffnen Sie in Scribe die **Einstellungen**, wechseln Sie zum Tab **Workspace** und kopieren Sie den Wert unter **Event Tracking ID**. Stellen Sie dabei sicher, dass **Tracking** aktiviert ist.
  </Step>

  <Step title="Add the SDK to your site">
    Verwenden Sie das Skript-Snippet für eine einfache Website oder das npm-Paket für eine App oder Single-Page-App. Beide bieten dieselbe `scribe.track(...)`-API.

    **Option A. Skript-Snippet.** Fügen Sie dies auf jeder Seite ein, die Sie tracken möchten, direkt vor dem schließenden `</head>`-Tag. Das Snippet initialisiert sich automatisch aus `data-workspace`, sodass kein `init()`-Aufruf nötig ist.

    ```html theme={null}
    <!-- Scribe conversion tracking -->
    <script src="https://cdn-1.scribe-mail.com/v1/tracking.js"
            data-workspace="YOUR_EVENT_TRACKING_ID" async></script>
    ```

    **Option B. npm oder yarn.** Installieren Sie das Paket und initialisieren Sie es einmal beim App-Start.

    ```bash theme={null}
    npm install @scribemail/js
    # or: yarn add @scribemail/js
    ```

    ```js theme={null}
    import scribe from '@scribemail/js';

    scribe.init({ id: 'YOUR_EVENT_TRACKING_ID' }); // once, at app startup
    ```

    Der Import des Moduls hat keine Nebenwirkungen (er ist sicher für Server-Side-Rendering). Es wird nichts gesendet, bevor Sie `init()` aufrufen.
  </Step>

  <Step title="Record your first conversion">
    Rufen Sie `scribe.track` überall dort auf, wo eine Conversion stattfindet, zum Beispiel in Ihrem Signup-Success-Handler.

    ```js theme={null}
    scribe.track('signup', { value: 99.0, currency: 'USD', plan: 'pro' });
    ```

    Das SDK erfasst automatisch die Scribe-Klickzuordnung aus der Landing-URL, bündelt Ihre Ereignisse und sendet sie zuverlässig — auch wenn der Besucher die Seite verlässt.
  </Step>

  <Step title="Check that it works">
    Lösen Sie das Ereignis auf Ihrer Website aus und öffnen Sie dann **Analytics** in Scribe. Ihre Conversions erscheinen neben Views und Klicks, aufgeschlüsselt nach Signatur, Teammitglied, Kampagne und Land.
  </Step>
</Steps>

## SDK-Referenz

### `scribe.track(name, metadata)`

Zeichnet ein Ereignis auf. `name` ist erforderlich, zum Beispiel `signup`, `demo_booked` oder `purchase`.

```js theme={null}
scribe.track('purchase', {
  value: 149.0,           // optional, monetary value of the conversion
  currency: 'EUR',        // optional, ISO currency code
  event_id: 'order_8821', // optional, your own id, used for idempotency
  plan: 'team',           // any other key becomes an event "property"
  seats: 5
});
```

* `value`, `currency` und `event_id` sind anerkannte Top-Level-Felder.
* **Jeder andere Schlüssel** wird Teil der `properties` des Ereignisses. Halten Sie Properties auf flache skalare Werte beschränkt (Strings, Zahlen, Booleans). Legen Sie keine personenbezogenen Daten wie E-Mail-Adressen oder Telefonnummern in Properties ab: Scribe verwirft Schlüssel, die wie personenbezogene Daten aussehen, automatisch.
* Geben Sie eine eigene `event_id` an, um einen Sendevorgang wiederholsicher zu machen. Dieselbe `event_id`, die zweimal innerhalb von 24 Stunden empfangen wird, wird nur einmal erfasst.

### `scribe.identify(userId, traits)`

Ordnet den Besucher einem Ihrer eigenen Nutzer zu, sodass Sie sehen, welche Signaturen welche Kunden gewinnen. Nützlich für B2B- und Account-based-Szenarien.

```js theme={null}
scribe.identify('user_42', { email: 'ada@example.com', name: 'Ada', plan: 'pro' });
```

Nach einem `identify`-Aufruf sind nachfolgende `track`-Aufrufe an diesen Nutzer gebunden. Rufen Sie beim Logout `scribe.reset()` auf, um die Identität zurückzusetzen.

### `scribe.flush()`

Ereignisse werden automatisch gebündelt und gesendet, spätestens beim Verlassen der Seite. Rufen Sie `flush()` nur auf, wenn Sie das aktuelle Bündel sofort erzwingen müssen.

### Snippet-Attribute

Wenn Sie das Script-Snippet verwenden, konfigurieren Sie es mit `data-*`-Attributen:

| Attribut             | Erforderlich | Beschreibung                                                                               |
| -------------------- | ------------ | ------------------------------------------------------------------------------------------ |
| `data-workspace`     | Ja           | Ihre Event-Tracking-ID.                                                                    |
| `data-consent`       | Nein         | Auf `"denied"` setzen, um First-Party-Speicher zu deaktivieren, bis der Besucher zustimmt. |
| `data-cookie-domain` | Nein         | Setzen Sie Ihre Apex-Domain, um die Identität über Subdomains hinweg zu teilen.            |

### Content Security Policy

Wenn Ihre Website eine Content Security Policy setzt, nehmen Sie die Scribe-Hosts in die Allowlist auf:

```
script-src  https://cdn-1.scribe-mail.com;
connect-src https://t.scribe-mail.com;
```

<Tip>
  Sie möchten ein verlässliches Ereignis aus Ihrem Backend erfassen, etwa eine von Ihrem Server bestätigte Zahlung? Scribe nimmt Ereignisse auch über die API mit einem `events:write`-API-Key entgegen, wodurch Umsatzwerte vertrauenswürdig bleiben und nicht clientseitig übermittelt werden. Details finden Sie in der [API-Referenz](/api-reference/introduction).
</Tip>

## Anwendungsfälle: Conversions in Wachstum verwandeln

Conversion-Tracking macht Ihre E-Mail-Signaturen zu einem messbaren Akquisekanal. So nutzen Teams die Daten in der Praxis — inklusive Einspeisung in bezahltes Remarketing.

### Remarketing-Kampagnen auf Google Ads und Meta Ads schalten

Feuern Sie Ihre Conversion-Pixel der Werbeplattformen an derselben Stelle, an der Sie `scribe.track` aufrufen — so landet eine einzelne Conversion gleichzeitig in Scribe, Google Ads und Meta. Scribe zeigt Ihnen, dass die Conversion aus einer E-Mail-Signatur stammt; Google und Meta nutzen dasselbe Signal für Gebote und Zielgruppen.

```js theme={null}
function onSignupComplete(plan, price) {
  // 1. Attribute the conversion to the email signature that drove it
  scribe.track('signup', { value: price, currency: 'USD', plan });

  // 2. Send the same conversion to your ad platforms for bidding and audiences
  // gtag('event', 'conversion', { send_to: 'AW-XXXXXXXXX/abc', value: price, currency: 'USD' });
  // fbq('track', 'CompleteRegistration', { value: price, currency: 'USD' });
}
```

### Retargeting-Zielgruppen mit hoher Kaufabsicht aufbauen

Personen, die auf Ihre Signatur geklickt und Ihre Website besucht, aber nicht konvertiert haben, sind warme Kontakte. Nutzen Sie Scribe, um signaturgetriebenen Traffic zu bestätigen, und sprechen Sie diese Besucher anschließend mit einem passgenauen Angebot auf Google und Meta erneut an. Da der Traffic aus Ihren eigenen E-Mails stammt, konvertieren diese Zielgruppen in der Regel besser als kalte Neukundenansprache.

### Lookalike- und ähnliche Zielgruppen aus Ihren Convertern aufbauen

Ihre beste Seed-Zielgruppe sind Personen, die bereits über einen vertrauenswürdigen Kanal konvertiert haben. Ziehen Sie die Besucher heraus, die über Signaturen gewonnen wurden (Filter nach Signatur, Teammitglied oder Kampagne), laden Sie sie als Custom Audience in Meta oder als Customer-Match-Liste in Google Ads hoch und bilden Sie daraus Lookalike- oder ähnliche Zielgruppen auf Basis dieses hochwertigen Seeds.

### Bestandskunden von Akquise-Ausgaben ausschließen

Zahlen Sie nicht länger dafür, Personen zu gewinnen, die sich bereits registriert oder gekauft haben. Exportieren Sie Ihre Converter und fügen Sie sie als Ausschluss- oder Suppression-Liste zu Ihren Prospecting-Kampagnen hinzu, damit das Budget in neue Interessenten fließt.

### Auf Umsatz optimieren, nicht nur auf Klicks

Übergeben Sie mit jeder Conversion einen echten `value` und `currency`. Mit angehängtem Umsatz können Sie in Google und Meta auf wertbasiertes Bidding umstellen, und in Scribe lassen sich Signaturen, Teammitglieder und Kampagnen nach dem generierten Umsatz statt nur nach Klicks bewerten.

### Den Kanal belegen und Budget umverteilen

Mit Conversion-Tracking vergleichen Sie den durch E-Mail-Signaturen erzielten Umsatz mit Ihren Paid-Kanälen in denselben Kennzahlen. Wenn eine Signaturkampagne eine bezahlte übertrifft, haben Sie die Zahlen, um Budget dorthin zu verschieben, wo es wirkt.

## Einen KI-Agenten mit der Einrichtung beauftragen

Sie müssen das nicht von Hand verkabeln. Wenn Sie einen KI-Coding-Assistenten nutzen (etwa Claude Code, Cursor oder einen ähnlichen Agenten in Ihrem Editor), übergeben Sie ihm einen Prompt wie den folgenden, mit Ihrer eigenen Event Tracking ID und den für Sie relevanten Conversions:

```text theme={null}
Install the Scribe conversion tracking SDK on my website.

- If this is an app or single-page app, add the @scribemail/js package and call
  scribe.init({ id: 'YOUR_EVENT_TRACKING_ID' }) once at startup. If it is a plain
  HTML site, add the https://cdn-1.scribe-mail.com/v1/tracking.js script with
  data-workspace="YOUR_EVENT_TRACKING_ID" before </head> instead.
- Call scribe.track('signup', { value, currency }) from my signup success handler
  and scribe.track('purchase', { value, currency }) from my checkout confirmation.
- If I have logged-in users, call scribe.identify(userId, { email, plan }) after login.
- Add https://cdn-1.scribe-mail.com and https://t.scribe-mail.com to my Content
  Security Policy if I have one.
```

Sobald Conversions fließen, kann ein mit dem [Scribe MCP-Server](/de/ai-agents/connect) verbundener Agent die Ergebnisse für Sie auslesen und erläutern. Fragen Sie ihn zum Beispiel: „Welche Signaturen und Teammitglieder haben diesen Monat die meisten Conversions und den meisten Umsatz gebracht?“ oder „Liste die Besucher auf, die meine Signaturen diese Woche gewonnen haben.“ Was Ihr Assistent alles abrufen kann, zeigen [Scribe für KI-Agenten](/de/ai-agents) und der [Scribe-Analytics-Skill](/de/ai-agents/skills).

## Datenschutz und Einwilligung

Conversion-Tracking ist so gebaut, dass Ihre Besucher und Ihre Pflichten respektiert werden:

* **IP-Adressen werden anonymisiert.** Scribe hasht die IP vor dem Speichern. Rohe IPs werden niemals aufbewahrt.
* **Keine personenbezogenen Daten in Properties.** Schlüssel, die wie personenbezogene Daten aussehen (E-Mail, Telefon, Passwort, Tokens, Kartennummern und Ähnliches), werden automatisch aus Event-Properties entfernt. Verwenden Sie `identify`, wenn Sie einen Nutzer bewusst zuordnen möchten.
* **Speicherung nur mit Einwilligung.** Setzen Sie `data-consent="denied"` (Snippet) oder `consent: false` (npm `init`), damit das SDK die Klick-Kennung erst speichert, wenn Ihre Besucher einwilligen.
* **Einwilligung vor Aktivierung des Trackings einholen.** Die Tracking-Einstellung im Workspace trägt dieselbe Verantwortung wie jedes andere Analytics-Pixel. Stellen Sie sicher, dass Sie die in Ihrer Region erforderliche Einwilligung haben, bevor Sie sie aktivieren.

## Verwandte Artikel

* [Analytics-Überblick](/de/analytics-overview): Views, Klicks, Reichweite und CTR in Ihrem Workspace.
* [Analytics-Dashboard](/de/analytics-dashboard): Conversions neben Views und Klicks in jedem Tab lesen.
* [Signatur-Analytics](/de/signature-analytics): Performance einer einzelnen Signatur.
* [Marketingkampagnen](/de/marketing-overview): Bannerkampagnen in Signaturen ausspielen und messen.
* [Scribe für KI-Agenten](/de/ai-agents): Einen Assistenten Tracking einrichten und Conversions auswerten lassen.