# MIRA FIVE einrichten, gemeinsam mit Ihrer Entwicklung.

> Wer was einrichtet: Projekt, Kaufziel und Google Ads übernehmen Sie, Skript, Einwilligungszeile und bezahlte Bestellung Ihre Entwicklung oder Agentur.

URL: https://mirafive.io/de/einrichtung

Sie klicken sich durch drei Bildschirme. Ihre Entwicklerin oder ihr Coding-Agent fügt ein paar Zeilen in die Website ein. Diese Seite nennt beides der Reihe nach, damit Sie sie weiterschicken können.

Niemand zur Hand? Das Skript allein passt in jede Website, bei der Sie Code in den Kopf der Seite einfügen können.

Sie, im Dashboard

1. Projekt und Website-Quelle anlegen
2. Bezahlte Bestellung als Kaufziel markieren
3. Google Ads verbinden

Ihre Entwicklung, in der Website

1. Skript auf jeder Seite einfügen
2. Antwort des Banners weitergeben
3. Bezahlte Bestellung senden

Die Einrichtung hat sieben Schritte, vier davon ohne Code. Ihre Entwicklung fügt das Skript, die Einwilligungszeile und die bezahlte Bestellung ein. Sie legen Projekt und Quelle an, prüfen gemeinsam, ob Events ankommen, markieren die Bestellung als Kauf und verbinden Google Ads.

## Zuerst: Wie soll erfasst werden?

Jede Website-Quelle hat einen Erfassungsmodus. Er entscheidet, was MIRA FIVE zeigen kann.

### Einwilligungsfrei

Die Voreinstellung. Gezählt als Besuche.

- Keine Cookies, nichts auf dem Gerät gespeichert
- Besuche, Seiten, Kanäle und Kampagnen
- Events und Conversions pro Besuch
- Personen, Käufer und Kosten pro Käufer zeigen „Braucht Einwilligung“

### Vollständig

Hinter Ihrem Consent-Banner. Als Person wiedererkannt.

- Nichts wird gesendet, bevor die Besucherin zustimmt
- Käufer je Kanal und die Person hinter jedem Kauf
- Google-Ads-Kosten pro Käufer
- IDs im localStorage, nie in Cookies

Käufer je Kanal und Kosten pro Käufer brauchen Besucher, die zugestimmt haben. Zeigt Ihre Website schon ein Consent-Banner, wählen Sie „Vollständig“. Eine vollständige Quelle kann Ablehnende zusätzlich ohne Cookies zählen, wenn jede Seite den Modus pro Besucher wählt.

## Sieben Schritte, der Reihe nach.

Die Menünamen sind die aus der App. Jedes Detail für Ihre Entwicklung steht in der Dokumentation.

1. ### Projekt und Website-Quelle anlegen  
Sie  
Registrieren Sie sich, legen Sie ein Projekt an und öffnen Sie **Daten → Quellen → Quelle hinzufügen**. Wählen Sie **Website**, tragen Sie die Adresse der Website unter „Erlaubte Origins“ ein und wählen Sie den Erfassungsmodus. Die Quelle bringt ihren Website-Schlüssel (`mf_…`) im Tab **Einbauen** mit.
2. ### Skript auf jeder Seite einfügen  
Entwicklung  
Zwei Zeilen im Kopf jeder Seite, rund 4 kB. Für eine vollständige Quelle kommt `data-mode="full"` dazu, für eine einwilligungsfreie nicht. Für React, Next.js, Vue, Nuxt, Astro, Laravel und Symfony gibt es eigene Pakete. Oder ein Coding-Agent übernimmt: Im Tab „Einbauen“ steht **Von Ihrem Coding-Agent einbauen lassen**, ein Prompt für Claude Code, Cursor oder Codex mit Schlüssel, erlaubten Origins, allen Schritten und der Prüfung.  
```  
<script>window.mirafive=window.mirafive||function(){(mirafive.q=mirafive.q||[]).push(arguments)}</script>  
<script defer src="https://cdn.mirafive.io/mira.js" data-key="mf_…" data-mode="full"></script>  
```
3. ### Antwort des Banners weitergeben  
Entwicklung  
Nur für eine vollständige Quelle. Gesendet wird erst, wenn das Banner die Antwort weitergibt. `true` heißt nur Statistik, `false` vergisst IDs und Nutzer und leert die Warteschlange, ein Objekt setzt Statistik, Experimente und Targeting einzeln. Meldet sich jemand an, verbindet `identify` die Besuche mit Ihrer eigenen Nutzer-ID, `reset` beim Abmelden. Funktioniert mit Ihrem Consent-Banner; die Dokumentation zeigt ein Beispiel für Cookiebot.  
```  
<script>  
  // Aus Ihrem Consent-Banner aufrufen, sobald die Besucherin antwortet oder ihre Wahl ändert.  
  mirafive('consent', { statistics: agreedToStatistics })  
  // Bei jedem Seitenaufruf, solange jemand angemeldet ist, mit Ihrer eigenen Nutzer-ID (nie einer E-Mail).  
  mirafive('identify', user.id)  
</script>  
```
4. ### Bezahlte Bestellung senden  
Entwicklung  
Der Kauf braucht Umsatz und Währung. Am schnellsten geht es mit einer Zeile auf der Bestellbestätigung. Im vollständigen Modus landet der Kauf dann bei der Person, die bezahlt hat.  
```  
<script>  
  mirafive('track', 'order_paid', { revenue: 328, currency: 'EUR' })  
</script>  
```  
Genauer: vom Server senden. Dort gehen Käufe weder an Werbeblockern noch an geschlossenen Tabs verloren, und ein wiederholter Webhook zählt einmal. Übergeben Sie dieselbe Nutzer-ID, die die Seite an `identify` gibt. SDKs für Node.js, PHP, Laravel und Symfony übernehmen das Senden.  
```  
import { Mira } from '@mirafive/sdk-server'  
const mira = new Mira({ key: process.env.MIRAFIVE_SECRET_KEY })  
await mira.send(  
  [{ name: 'order_paid', userId: order.customerId, properties: { revenue: 328, currency: 'EUR' } }],  
  { idempotencyKey: `order-${order.id}` },  
)  
```
5. ### Prüfen, ob es ankommt  
Gemeinsam  
Öffnen Sie die Website unter ihrer echten Domain, denn localhost sendet standardmäßig nichts, und stimmen Sie bei einer vollständigen Quelle im Banner zu. Ihr Besuch erscheint innerhalb von Sekunden unter **Daten → Live**, und die Einrichtungshilfe des Projekts wechselt auf **Events kommen an**. Die erste echte Bestellung zeigt sich danach unter **Daten → Events**.
6. ### Bestellung als Kauf markieren  
Sie  
Sobald die erste Bestellung angekommen ist, öffnen Sie **Ziele → Neues Ziel**, geben einen Namen ein, wählen das Event `order_paid` und stellen das Ziel auf **Kauf**. Der Umsatz kommt aus der Eigenschaft `revenue` des Events, getrennt nach Währung. Ab dann zählt das Dashboard Käufer.
7. ### Google Ads verbinden  
Sie  
Öffnen Sie **Daten → Quellen → Quelle hinzufügen**, wählen Sie **Google Ads**, melden Sie sich bei Google an und wählen Sie das Werbekonto. Die Kosten kommen täglich, und jede Kampagne zeigt ihre Kosten pro Käufer. Die Klick-ID der automatischen Tag-Kennzeichnung verbindet einen Klick mit seiner Kampagne. Listet Herkunft bezahlte Besuche ohne Kampagne, tragen Sie in Google Ads unter Verwaltung → Kontoeinstellungen → Tracking dieses Suffix der finalen URL ein.  
```  
utm_campaign={campaignid}  
```

## Für Ihre Entwicklung.

Die Fakten, die vor und nach dem Einbau zählen.

Website-Schlüssel

`mf_…`, absichtlich öffentlich: Er kann nur Events senden und die Flags der Quelle lesen, und nur von ihren erlaubten Origins.

Geheimer Schlüssel

Für Server-Events. Aus `MIRAFIVE_SECRET_KEY` gelesen, nur einmal angezeigt, nie im Browser-Code.

Endpunkte

Browser senden an `events.mirafive.io/v1/batch/<Website-Schlüssel>`, Server an `events.mirafive.io/v1/batch` mit dem geheimen Schlüssel.

Content Security Policy

`connect-src https://events.mirafive.io`, für das Skript-Tag zusätzlich `script-src https://cdn.mirafive.io`.

Speicher

Keine Cookies, in keinem Modus. Im vollständigen Modus IDs im localStorage nach der Einwilligung, vorher nichts.

Sendet nichts

Von localhost, solange es nicht erlaubt ist, von Bots und aus Browsern mit Do Not Track oder Global Privacy Control.

Wiederholungen

Jede Batch-ID zählt einmal; ein Idempotenzschlüssel lässt einen wiederholten Webhook einmal zählen.

[Zum Quickstart](https://docs.mirafive.io/quickstart)

## Fragen zur Einrichtung.

### Brauche ich eine Entwicklerin?

Für das Skript allein nicht: Wer Code in den Kopf der Website einfügen kann, kann es einfügen. Einwilligungszeile und bezahlte Bestellung brauchen jemanden, der Templates oder Server-Code der Website bearbeitet, oder einen Coding-Agent mit dem Prompt aus dem Tab „Einbauen“.

### Wie lange dauert das?

Mit dem Quickstart der Dokumentation kommt ein erstes Event in rund fünf Minuten an. Einwilligungszeile und bezahlte Bestellung hängen davon ab, wie Ihre Website gebaut ist; die Schritte oben sind die ganze Liste.

### Gibt es ein Plugin für Shopify, Shopware oder WooCommerce?

Nein. Das Skript kommt in den Kopf des Themes, die Kaufzeile auf die Bestellbestätigung oder in den Server-Code. Bei Shopify führt die Bestellstatusseite keine eigenen Skripte mehr aus; dort kommt die bezahlte Bestellung von einem Server, der den Bestell-Webhook von Shopify empfängt.

### Wie kommt meine Entwicklung an den Schlüssel?

Kopieren Sie ihn aus dem Tab „Einbauen“ der Quelle, oder kopieren Sie den fertigen Prompt. Im Tarif Free hat ein Arbeitsbereich ein Mitglied; mit Pro laden Sie Ihre Entwicklung ins Projekt ein.

### Können wir vor dem Livegang testen?

Ja. Seiten auf localhost senden nichts, solange Sie es nicht mit `data-track-localhost` erlauben, so bleibt die Entwicklung aus Ihren Zahlen. Um eigene Besuche auf der Live-Website herauszuhalten, setzen Sie `window.__mirafive_ignore`, wie in der Dokumentation beschrieben.

## Projekt anlegen, dann diese Seite weiterschicken.

Kostenlos bis 25.000 Events im Monat, ohne Karte. Die ersten Besuche erscheinen live.

[Kostenlos starten](https://app.mirafive.io/register)[An die Entwicklung senden](mailto:?subject=MIRA%20FIVE%20auf%20unserer%20Website%20einrichten&body=Hallo%2C%0A%0Awir%20richten%20MIRA%20FIVE%20ein%2C%20unsere%20Analyse%20f%C3%BCr%20Kan%C3%A4le%20und%20Google%20Ads%2C%20gehostet%20in%20Deutschland.%20K%C3%B6nnten%20Sie%20es%20in%20unsere%20Website%20einbauen%3F%20Die%20Schritte%20stehen%20hier%3A%0A%0Ahttps%3A%2F%2Fmirafive.io%2Fde%2Feinrichtung%0A%0ADen%20Website-Schl%C3%BCssel%20aus%20dem%20Tab%20%E2%80%9EEinbauen%E2%80%9C%20der%20Quelle%20schicke%20ich%20Ihnen%2C%20oder%20den%20fertigen%20Prompt%20f%C3%BCr%20Ihren%20Coding-Agent.%0A%0AVielen%20Dank!)