Zdarzenia serwerowe

Zamówienia, zwroty i inne zdarzenia z Twojego backendu mogą trafiać do Pandus z serwera, jak w GA4 Measurement Protocol. Bloker w przeglądarce ich nie zgubi.

Endpoint

POST https://pandus.online/api/v1/sites/{site}/events
Authorization: Bearer YOUR_TOKEN
Content-Type: application/json

Utwórz token w API i webhooki. Użyj tokena z uprawnieniem write albo tokena tylko do tego celu: „Tylko wysyła zdarzenia z Twojego serwera”. Pełny opis jest w dokumentacji API.

Treść żądania

{
  "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 }]
      }
    }
  ]
}

Do 25 zdarzeń na żądanie. Odpowiedź to 202 z liczbą przyjętych zdarzeń; pojawiają się w raportach w ciągu minuty. Wartości przypominające e-mail, telefon lub numer karty są odrzucane. Zdarzenia serwerowe liczą się do miesięcznego limitu zdarzeń planu.

Przykład z 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"}}]}'

Zgoda

Wysyłaj client_id tylko dla odwiedzających, którzy zgodzili się na analitykę; bez niego zdarzenie jest liczone, ale nie łączy się z wizytą.

Odczyt liczb

Raporty analityki są dostępne przez GET /api/v1/sites/{site}/analytics/{report}: zobacz Analityka.