Wie melde ich Conversions serverseitig?

curl -X POST "$METRUNIO_COLLECTOR/v1/server/events" \
  -H "authorization: Bearer $METRUNIO_SERVER_KEY" \
  -H "content-type: application/json" \
  -d '{
    "site_id": "site_demo_shop",
    "events": [{
      "event_id": "bestellung-12345",
      "event_type": "purchase",
      "occurred_at": "2026-08-12T10:15:00Z",
      "order_id": "12345",
      "value": "149.90",
      "currency": "EUR",
      "consent_state": "granted",
      "consent_purposes": ["analytics", "marketing"]
    }]
  }'

{
  "received": 1,
  "accepted": 1,
  "duplicates": 0,
  "rejected": 0,
  "blocked": 0,
  "results": [{ "eventId": "bestellung-12345", "status": "accepted" }]
}

Zuletzt geprüft am 17.10.2026

• Server-side Tracking
• Conversion API
• Events aus dem Backend senden
• Wie sende ich eine Bestellung oder Anfrage?
• An welche Adresse sende ich Server-Events?
• Welcher Host gehört zur Server Events API?
• Muss die event_id über alle Websites eindeutig sein?

• Wie signiere ich serverseitige Anfragen?

  Wie funktioniert die HMAC-Signatur und der Replay-Schutz?

  Du sendest den Kopf x-metrunio-signature mit Zeitstempel und HMAC-SHA256 über "<Zeitstempel>.<roher Body>", berechnet mit dem Serverschlüssel. Das Zeitfenster beträgt fünf Minuten, und jede Signatur wird genau einmal akzeptiert.

• Kann mein System Conversions per Webhook melden?

  Wann nehme ich den Webhook statt der Server Events API?

  Der Endpunkt POST /v1/webhooks/conversions ist für Systeme gedacht, die von sich aus einen Webhook auslösen, statt einen API-Aufruf zu programmieren. Er verlangt zwingend eine gültige Signatur.

• Warum ist eine Conversion nicht zugeordnet?

  Was bedeutet „nicht zugeordnet“ und wie verbessere ich die Abdeckung?

  „Nicht zugeordnet“ heißt: Das Modell hat zu dieser Conversion keinen Kontakt gefunden, den es berücksichtigt. Entweder liegt keiner im Attributionsfenster und ist über eine gemeinsame Kennung verbunden, oder es sind nur Kontakte einer Art, die das Modell nicht verteilt. Metrunio erfindet dann keinen Kontakt.

• Wie melde ich einen Zielschritt?

  Wie sende ich die Schritte meines Funnels aus Browser oder Backend?

  Im Browser mit metrunio.identify(userId) einmal nach der Anmeldung und dann metrunio.goal('schluessel') je Schritt; aus dem Backend mit POST /v1/server/events und einem Ereignis vom Typ goal mit goal_key und user_id. Beide Wege sind gleichwertig; ein Schritt ohne Kundenkennung wird abgelehnt.

• Wie messe ich über meine eigene Domäne?

  Wie richte ich eine eigene Messdomäne ein, damit Adblocker weniger Daten kosten?

  In der Einrichtung trägst du einen Namen wie gauge.deine-domain.de ein, und Metrunio nennt dir auf einmal drei DNS-Einträge (zwei CNAME und einen TXT). Sobald sie stehen und ein Zertifikat auf deinen Namen ausgestellt ist, geht die Adresse in Betrieb; mit Snippet oder Tag Manager stellst du danach deinen Einbau um, die Shopify-App und die Plugins für Shopware und WordPress stellen sich selbst um. Die Messung läuft dann first-party und wird von Adblockern und dem Trackingschutz der Browser seltener gekürzt.

• Wie zählt Metrunio Folgezahlungen eines Abos?

  Wie kennzeichne ich Abo-Folgezahlungen, und welchem Kanal werden sie zugeordnet?

  Eine Folgezahlung meldest du als Kauf mit der Kennung des Abos (subscription_id) und dem Kennzeichen subscription_renewal; Verlängerungen aus Stripe kennzeichnet Metrunio selbst. Sie zählt im gemessenen Umsatz, steht in den Berichten getrennt und bekommt die Anteile der ersten Bestellung desselben Abos, denn einen eigenen Werbekontakt hat sie nicht. Ohne bekannte erste Bestellung oder ohne Einwilligung bleibt sie mit Grund nicht zugeordnet.