Integracje

Tracking i zdarzenia

Zdarzenia trafiają do niezmiennego RawEvent, a dopiero asynchroniczny pipeline buduje kanoniczne zakupy, tożsamość, atrybucję i agregaty raportowe.

Katalog zdarzeń

Zdarzenie	Źródło	Zastosowanie
`session_started`	Browser	Początek sesji first-party
`page_view`	Browser	Odsłona i kontekst landing page
`view_content`	Browser	Wyświetlenie produktu
`add_to_cart`	Browser	Dodanie do koszyka
`initiate_checkout`	Browser	Rozpoczęcie checkoutu
`add_payment_info`	Browser/server	Etap płatności
`purchase`	Woo/server	Prawda o zakupie
`refund`	Woo/server	Zwrot pełny lub częściowy
`order_updated`	Woo/server	Zmiana statusu
`identify`	Browser/server	Powiązanie klienta z sesją

Tożsamość i marketing

Najważniejsze pola to visitor_id, session_id,customer_id, zahaszowane SHA-256 dane kontaktowe, UTMy,fbclid, fbc, fbp, landing URL i referrer. Dane klientów nie powinny trafiać do payloadu w postaci jawnej.

First-party i zgoda

Plugin przechowuje lekkie identyfikatory w cookies oraz respektuje stan zgody. Uruchomienie trackingu powinno być zgodne z konfiguracją CMP i polityką prywatności sklepu.

Przykładowy payload ingest

JSON · purchase.jsonKod

{
  "workspace_id": "WORKSPACE_UUID",
  "store_id": "STORE_UUID",
  "source": "woocommerce_plugin",
  "source_event_type": "server",
  "event_name": "purchase",
  "event_id": "woo-order-1042",
  "occurred_at": "2026-07-21T10:15:00Z",
  "schema_version": "1.0",
  "environment": "prod",
  "identity": {
    "visitor_id": "kv_…",
    "session_id": "ks_…",
    "email_hash_sha256": "…",
    "fbc": "fb.1.…",
    "fbp": "fb.1.…"
  },
  "marketing": {
    "utm_source": "facebook",
    "utm_campaign": "summer_sale",
    "fbclid": "…"
  },
  "commerce": {
    "order_id": "1042",
    "total": "249.00",
    "currency": "PLN"
  },
  "context": {},
  "technical": {}
}

Deduplikacja i priorytety

Stabilny event_id i order_id pozwalają bezpiecznie ponowić wysyłkę. Odpowiedź 202 zawiera flagęduplicate oraz wyliczony dedup_key.

Priorytet	Źródło zakupu
1	store_webhook
2	woocommerce_plugin
3	browser_event
4	manual_import

Dwa punkty przyjmowania danych

POSThttps://t.klientometr.pl/api/v1/events/ingest

Kanoniczny ingest pluginu WooCommerce i integracji workspace.

POSThttps://t.klientometr.pl/api/events/event

Publiczny collector lekkich zdarzeń używany przez uniwersalny tracker.

GEThttps://t.klientometr.pl/api/events/event.gif

Wariant pixel/GIF dla środowisk, w których wysyłka JSON nie jest dostępna.

DalejMeta Ads ›