Серверні події

Замовлення, повернення та інші події, що стаються на вашому бекенді, можуть надходити в Pandus із сервера, як у GA4 Measurement Protocol. Блокувальник у браузері їх не загубить.

Ендпоінт

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

Створіть токен у API та вебхуки. Використовуйте токен із write або окремий лише для цього: «Лише надсилає події з вашого сервера». Повний опис — у документації API.

Тіло запиту

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

До 25 подій за запит. Відповідь — 202 із кількістю прийнятих подій; у звітах вони з’являються протягом хвилини. Значення, схожі на e-mail, телефон чи номер картки, відкидаються. Серверні події рахуються в місячний ліміт подій тарифу.

Приклад із 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":1890,"currency":"UAH"}}]}'

Згода

Надсилайте client_id лише для відвідувачів, які погодилися на аналітику; без нього подія рахується, але не прив’язується до візиту.

Читання цифр

Звіти аналітики доступні через GET /api/v1/sites/{site}/analytics/{report}: див. Аналітика.