MIRA FIVE einrichten, gemeinsam mit Ihrer Entwicklung.

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.

1. 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. 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.

   Das Skript im Kopf der Seite: eine Warteschlange, dann ein verzögert geladenes Skript-Tag, das mira.js von cdn.mirafive.io mit dem Website-Schlüssel und data-mode="full" lädt.

   layout.html

   1<script>window.mirafive=window.mirafive||function(){(mirafive.q=mirafive.q||[]).push(arguments)}</script>2<script defer src="https://cdn.mirafive.io/mira.js" data-key="mf_…" data-mode="full"></script>

3. 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.

   Zwei Aufrufe: mirafive consent mit der Statistik-Antwort der Besucherin aus dem Consent-Banner und mirafive identify mit der ID der angemeldeten Person.

   consent.html

   1<script>2  // Aus Ihrem Consent-Banner aufrufen, sobald die Besucherin antwortet oder ihre Wahl ändert.3  mirafive('consent', { statistics: agreedToStatistics })4​5  // Bei jedem Seitenaufruf, solange jemand angemeldet ist, mit Ihrer eigenen Nutzer-ID (nie einer E-Mail).6  mirafive('identify', user.id)7</script>

4. 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.

   Auf der Bestellbestätigung: mirafive track order_paid mit Umsatz 328 und Währung EUR.

   bestellbestaetigung.html

   1<script>2  mirafive('track', 'order_paid', { revenue: 328, currency: 'EUR' })3</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.

   Vom Server mit @mirafive/sdk-server: order_paid mit der Kunden-ID als Nutzer-ID, Umsatz 328 in EUR und der Bestellnummer als Idempotenzschlüssel.

   checkout.ts

   1import { Mira } from '@mirafive/sdk-server'2​3const mira = new Mira({ key: process.env.MIRAFIVE_SECRET_KEY })4​5await mira.send(6  [{ name: 'order_paid', userId: order.customerId, properties: { revenue: 328, currency: 'EUR' } }],7  { idempotencyKey: `order-${order.id}` },8)

5. 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. 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. 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.

   Das Suffix der finalen URL für Google Ads: utm_campaign gleich dem Platzhalter für die Kampagnen-ID.

   Suffix der finalen URL

   utm_campaign={campaignid}

Zum Quickstart