Серверные события

Заказы, возвраты и другие события, которые происходят на вашем бэкенде, могут приходить в 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": 89.9,
        "currency": "EUR",
        "items": [{ "item_id": "kettle-1", "item_name": "Kettle", "price": 89.9, "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":89.9,"currency":"EUR"}}]}'

Согласие

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

Чтение цифр

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