Pandus SDK Dokumentation
Server-Ereignisse
Käufe, Erstattungen und andere Backend-Ereignisse über die REST-API an das Pandus SDK senden: Endpunkt, Token, Nutzlast, Limits und Verknüpfung mit einem Besuch.
Aktualisiert:
Bestellungen, Erstattungen und andere Ereignisse aus Ihrem Backend können von Ihrem Server an Pandus gehen, wie beim GA4 Measurement Protocol. Ein Blocker im Browser kann sie nicht verschlucken.
Endpunkt
POST https://pandus.online/api/v1/sites/{site}/events
Authorization: Bearer YOUR_TOKEN
Content-Type: application/json
Erstellen Sie das Token unter API und Webhooks. Nutzen Sie ein Token mit write oder eines nur für diesen Zweck: „Sendet nur Ereignisse von Ihrem Server“. Die vollständige Referenz steht in der API-Dokumentation.
Nutzlast
{
"events": [
{
"name": "purchase",
"client_id": "k3j9x0a1b2c3d4e5f6g7",
"page": "/checkout/thank-you",
"params": {
"transaction_id": "A-1042",
"value": 89.9,
"currency": "EUR",
"items": [{ "item_id": "kettle-1", "item_name": "Kettle", "price": 89.9, "quantity": 1 }]
}
}
]
}
| Feld | Hinweise |
|---|---|
name |
Pflicht, dieselben Regeln wie im Browser |
params |
Bis 25 Parameter; items für E-Commerce |
client_id |
Aus dem Cookie _pandus_id, wenn der Besucher zugestimmt hat: verbindet das Ereignis mit seinem Besuch |
session_id |
Optional |
user_id |
Nur als SHA-256-Hash |
timestamp_ms |
Optional; innerhalb der letzten 72 Stunden, sonst die Ankunftszeit |
page |
Ein Pfad oder eine URL Ihrer Website |
Bis zu 25 Ereignisse pro Anfrage. Die Antwort ist 202 mit der Zahl angenommener Ereignisse; sie erscheinen innerhalb einer Minute in den Berichten. Werte, die wie E-Mail, Telefon- oder Kartennummer aussehen, werden verworfen. Server-Ereignisse zählen zum monatlichen Ereigniskontingent des Tarifs.
Beispiel mit curl
curl -X POST https://pandus.online/api/v1/sites/SITE_ID/events \
-H "Authorization: Bearer YOUR_TOKEN" \
-H "Content-Type: application/json" \
-d '{"events":[{"name":"refund","params":{"transaction_id":"A-1042","value":89.9,"currency":"EUR"}}]}'
Einwilligung
Senden Sie client_id nur für Besucher, die der Analyse zugestimmt haben; ohne sie wird das Ereignis gezählt, aber keinem Besuch zugeordnet.
Die Zahlen lesen
Die Analyseberichte stehen über GET /api/v1/sites/{site}/analytics/{report} bereit: siehe Analyse.
Das Pandus SDK und der Scanner sind automatische Prüfungen, kein vollständiges Audit und keine Rechtsberatung. Das SDK verändert nichts an Ihrer Website und stellt nicht fest, welche Besucher assistive Technologien nutzen.