API i MCP · S2S

Konwersje, które potwierdza
backend.

Beacony w przeglądarce mówią Ci, co wydarzyło się na stronie. POST /s2s z tokenem HMAC mówi Observerowi, co wydarzyło się w Twoim backendzie: opłacona faktura, aktywowane konto, zwrot. Cele pozostają uczciwe, bo obie połówki należą do Ciebie.

Jak to działa

Jedno wywołanie z Twojego backendu.

Twój serwer wysyła konwersję na ścieżkę /s2s collectora z tokenem HMAC witryny — ten sam collector, który przyjmuje beacony z przeglądarki, za tą samą listą dozwolonych originów. Żaden pośrednik nie siedzi pomiędzy, bo cały pipeline działa na Twoim sprzęcie.

Wolisz klucz ze scope'em zamiast tokena witryny? Publiczne API odsłania ten sam pipeline: POST /api/v1/events ze scope'em write:events jest przekazywany ścieżką s2s collectora.

zapisz konwersję
curl -X POST https://sa.yourdomain.com/s2s \
  -H "X-Observer-Token: <site-token>" \
  -d '{ "goal_id": "purchase",
       "session": "91be…40",
       "value": 129.00 }'

Identyfikatory celów pokrywają się z celami Twojego dashboardu — konwersja ląduje w lejku i we współczynniku konwersji, który już obserwujesz, z widocznymi mianownikami.

Kiedy tego używać

Wszystko, czego przeglądarka nie widzi.

Tracker mierzy, co dzieje się na stronie. Twój backend wie, co naprawdę stało się z biznesem. Zdarzenia S2S łączą jedno z drugim.

Konwersje z backendu

Opłacona faktura, aktywowane konto, zwrot — momenty, w których przychód naprawdę powstaje, potwierdzane przez system zapisu, a nie stronę podziękowania.

Zdarzenia subskrypcyjne

Odnowienia, zmiany planu i rezygnacje zapisywane na te same identyfikatory celów, które liczy Twój dashboard — lejek prowadzi jedną księgę.

Zdarzenia offline i z pipeline'ów

Konwersje zamykane poza przeglądarką — zapis z call center, import wsadowy, pipeline integracji — odtwarzane do tego samego 24-godzinnego okna zdarzeń.

Dlaczego pozostaje uczciwe

Obie połówki są Twoje.

Trackowanie konwersji zwykle pęka w połowie: jeden dostawca liczy klik, drugi liczy sprzedaż, a liczby nigdy się nie spinają. Tutaj połówka przeglądarkowa i połówka backendowa płyną przez ten sam collector do tych samych celów — ze współczynnikami konwersji z widocznymi mianownikami, nie procentem znikąd.

Identyfikatory celów pokrywają się z dashboardem

Cele są z góry zdefiniowane — stronowe, zdarzeniowe, czasowe, głębokość scrolla — a payload s2s nazywa ten sam cel, który liczy Twój lejek.

Żadnej tożsamości w pakiecie

Zdarzenie przypina się do zanonimizowanej sesji w oknie 24 godzin. Nie ma profilu użytkownika do wzbogacenia, bo żaden nie istnieje.

Prawdziwe konwersje.
Żadnego pośrednika.

Zdarzenia server-to-server są w każdym poziomie — jeden token HMAC per witryna.