Serverové události

Objednávky, vrácení a další události z vašeho backendu mohou do Pandus chodit ze serveru, jako u GA4 Measurement Protocol. Blokovač v prohlížeči je neztratí.

Endpoint

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

Token vytvořte v API a webhooky. Použijte token s write nebo token jen pro tento účel: „Jen posílá události z vašeho serveru“. Úplný popis je v dokumentaci API.

Obsah požadavku

{
  "events": [
    {
      "name": "purchase",
      "client_id": "k3j9x0a1b2c3d4e5f6g7",
      "page": "/checkout/thank-you",
      "params": {
        "transaction_id": "A-1042",
        "value": 2190,
        "currency": "CZK",
        "items": [{ "item_id": "kettle-1", "item_name": "Kettle", "price": 2190, "quantity": 1 }]
      }
    }
  ]
}

Až 25 událostí na požadavek. Odpověď je 202 s počtem přijatých událostí; v přehledech se objeví do minuty. Hodnoty, které vypadají jako e-mail, telefon nebo číslo karty, se zahodí. Serverové události se počítají do měsíčního limitu událostí tarifu.

Příklad s 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":2190,"currency":"CZK"}}]}'

Souhlas

Posílejte client_id jen u návštěvníků, kteří souhlasili s analytikou; bez něj se událost započítá, ale nepropojí s návštěvou.

Čtení čísel

Analytické přehledy jsou dostupné přes GET /api/v1/sites/{site}/analytics/{report}: viz Analytika.