Installation
Wie sende ich Warenkorb, Neukunden und Marge aus meinem Shop?
Beim Kaufabschluss nehmen tracker.conversion(…) und die Server Events API zusätzlich newCustomer, die Aufteilung des Bestellwerts (netValue, taxValue, shippingValue, discountValue, costOfGoods) und die Warenkorbzeilen (items) entgegen. Alle Felder sind freiwillig; ohne sie misst Metrunio wie bisher. Mit ihnen entstehen Neukundenkosten, Deckungsbeitrag und Auswertungen je Produkt.
Wie übergebe ich Bestellpositionen, den Nettowert, den Wareneinsatz und ob es ein Neukunde war?
Eine Bestellung über 200 Euro sagt für sich genommen wenig. Ob sie von einem Neukunden kam und wie viel davon nach dem Wareneinsatz übrig bleibt, entscheidet darüber, ob die Werbung sie wert war. Beides weiß dein Shop, Metrunio nicht. Deshalb kannst du es mitsenden.
Aus dem Browser
metrunio.conversion({
orderId: '12345',
value: 238.00, // was der Kunde zahlt
currency: 'EUR',
newCustomer: true, // erste Bestellung dieses Kunden?
netValue: 200.00, // Warenwert ohne Steuer und Versand
taxValue: 38.00,
shippingValue: 0,
costOfGoods: 80.00, // Wareneinsatz
items: [
{ productRef: 'SESSEL-01', sku: 'SESSEL-01-BLAU', name: 'Sessel Nordlicht',
quantity: 1, unitPrice: 200.00, unitCost: 80.00, lineValue: 200.00 },
],
});Hinweis
Leitet dein Shop zum Bezahlen auf eine fremde Seite um, melde den Kauf serverseitig über die Server Events API, mit denselben Feldern und derselben Bestellnummer. Dann meldest du ihn nur dort und nicht zusätzlich aus dem Browser.
Was aus welchem Feld entsteht
| Feld | Was du dafür bekommst |
|---|---|
| newCustomer | Neukundenkosten: was ein neuer Kunde gekostet hat, statt nur, was ein Auftrag gekostet hat |
| netValue und costOfGoods | Deckungsbeitrag: Die Kampagne wird an dem gemessen, was übrig bleibt, nicht am Umsatz |
| taxValue, shippingValue | ROAS ohne Umsatzsteuer und Versand im Zähler |
| items | Auswertung nach Produkt, Kategorie und Marke |
Vier Regeln, die du kennen solltest
- Melde jeden Kauf mit seiner Bestellnummer. Dann zählt er einmal je Website, auch wenn Browser und Server ihn melden. Wert und Währung kommen vom Server, sobald er meldet; unter „Datenstatus“ steht ORDER_ALREADY_COUNTED oder, bei abweichendem Wert, ORDER_VALUE_FROM_SERVER. Ohne Bestellnummer erkennt Metrunio Doppel nur an der event_id, und die gilt je Weg: Das Tracking-Skript vergibt seine selbst, und selbst dieselbe event_id aus Browser und Server sind zwei Meldungen. Derselbe Kauf auf beiden Wegen zählt dann zweimal.
- Ein Wareneinsatz (costOfGoods) ohne Nettowert (netValue) wird abgewiesen. Ein Deckungsbeitrag auf den Bruttowert würde die Umsatzsteuer als Marge zählen. Die Meldung erscheint sofort in der Browser-Konsole.
- Metrunio rechnet in den Warenkorbzeilen nichts aus. Fehlt lineValue, bleibt es leer: Zwei Stück zu 25 Euro sind nicht zwangsläufig 50 Euro, und dein Rabatt ist deine Rechnung.
- Sage nichts zu newCustomer, leitet Metrunio die Antwort aus den eigenen Messungen ab und weist sie als solche aus („gemessen“ statt „aus dem Shop“). Das ist die schwächere Aussage, weil wir die Zeit vor der ersten Messung nicht kennen.
Erstattungen
Sende eine Erstattung mit derselben Bestellnummer, mindert sie den Wert der Bestellung. Nenne dabei auch netValue und costOfGoods des erstatteten Teils, dann stimmt der Deckungsbeitrag weiter. Bei einer vollständigen Erstattung genügt der Betrag: Dann ist alles zurück. Bei einer Teilerstattung ohne diese Angaben rechnet Metrunio den Anteil nicht hoch: Die Bestellung wird von Deckungsbeitragssummen ausgenommen und dort mit Anzahl ausgewiesen.
Wie Metrunio eine Erstattung ihrem Kauf zuordnet, wie lange sie auf einen Kauf wartet, der noch fehlt, und woran du siehst, dass sie verbucht ist, steht im Artikel „Wie kommen Erstattungen in Metrunio an?“.
Hinweis
Alle Felder sind freiwillig. Ein Shop, der nur Bestellnummer und Betrag sendet, misst genauso zuverlässig wie bisher. Ihm fehlen nur die Auswertungen, die auf diesen Angaben beruhen.
Zuletzt geprüft am 17.10.2026
Ebenfalls gefragt
- Warenkorbdaten an Metrunio senden
- Bestellpositionen tracken
- Neukunde oder Bestandskunde messen
- Deckungsbeitrag statt Umsatz
- ROAS auf Marge rechnen
- Wareneinsatz übergeben
- Produktebene auswerten
Weiterführende Artikel
- Wo baue ich das Tracking in meinem Shopsystem ein?
Wie installiere ich Metrunio in WordPress, Shopify, Shopware oder Webflow?
Für Shopify, Shopware 6 und WordPress mit WooCommerce gibt es eine Erweiterung, die Besuche, Einwilligung und Bestellungen zugleich misst. Die übrigen Systeme haben eine Stelle für eigenen Head-Code; die Tabelle nennt den Weg je System. Ohne Erweiterung empfehlen wir für Kaufabschlüsse zusätzlich die Server Events API, weil sie unabhängig vom Browser funktioniert.
- Wie richte ich Metrunio in WordPress und WooCommerce ein?
Wie installiere und verbinde ich das Metrunio-Plugin für WordPress?
Du installierst das Plugin „Metrunio“ in WordPress, klickst unter „Einstellungen → Metrunio“ auf „Mit Metrunio verbinden“ und bestätigst im Portal die Website. Danach misst das Plugin die Besuche und übernimmt die Einwilligung aus deinem Consent-Werkzeug. Mit WooCommerce meldet es zusätzlich Bestellungen, Stornos und Erstattungen direkt vom Server.
- Wie melde ich Conversions serverseitig?
Wie sende ich Events aus meinem Shop, CRM oder Backend?
Über POST /v1/server/events an den Collector, mit dem Serverschlüssel im Authorization-Header. Die Adresse und den fertigen Aufruf für deine Website zeigt das Portal unter „Einrichtung“ im Reiter „Server Events API“. Der Aufruf ist unabhängig vom Browser und damit robust gegenüber Adblockern und kurzlebigen Cookies.
- Wie kommen Erstattungen in Metrunio an?
Wie melde ich eine Erstattung, und woran sehe ich, dass sie verbucht ist?
Dein Shop-Server meldet eine Erstattung über die Server Events API als
refund, mit derselben Bestellnummer, Umgebung und Währung wie der Kauf. Metrunio mindert damit den Wert dieser Bestellung. Findet es 24 Stunden lang keinen passenden Kauf, verbucht es die Erstattung nicht und löscht sie. Unter „Datenstatus“ zählt der Befund REFUND_WITHOUT_PURCHASE dann je Website und Tag, wie viele es waren, ohne Bestellnummer. - Was kostet mich ein Neukunde, und was bleibt übrig?
Wie sehe ich Neukundenkosten und Deckungsbeitrag, und welche Produkte hat eine Kampagne verkauft?
Der Bereich „Handel & Produkte“ im Portal zeigt Neukundenkosten, Deckungsbeitrags-ROAS, durchschnittlichen Bestellwert, Wiederkaufrate und einen Produktbericht. Die Kampagnenwahl filtert nur den Produktbericht: Die Kennzahlen darüber gelten immer für alle Kampagnen. Sie erscheinen, sobald dein Shop die passenden Angaben mitsendet; ohne sie bleibt die jeweilige Kennzahl leer. Den Deckungsbeitrags-ROAS je Kanal und je Kampagne zeigen die Übersicht und die Seite „Attribution“.
- Was macht Metrunio bewusst nicht?
Welche Funktionen fehlen und warum?
Kein Fingerprinting, kein Marketing Mix Modeling, kein Adserver und kein eigenes Consent-Management. Der Umfang ist schmal gehalten: messen, verknüpfen, zuordnen; was daneben gebraucht wird, macht ein Werkzeug, das dafür gebaut ist. Hochgerechnete Zahlen gibt es nicht, und jede Zahl sagt, woher sie kommt, etwa gemessen oder zugeordnet.