KlientometrKlientometrDocumentation
DokumentacjaArchitektura
Architektura

Jak działa Klientometr

Klientometr zbiera sygnały first-party, łączy je z prawdą zamówień WooCommerce i kosztami Meta, a następnie raportuje tylko dane przetworzone i zdeduplikowane.

Cztery powierzchnie produktu

SklepWooCommerce

Plugin, sesje, zdarzenia, zakupy i zwroty.

RdzeńDjango

Ingest, kanonizacja, tożsamość, atrybucja i sync.

OperatorNext.js

Onboarding, diagnostyka, raporty i ustawienia.

In-platformChrome MV3

Realny przychód i ROAS w Meta Ads Managerze.

Przepływ danych

  1. 1
    RawEvent

    Każdy poprawnie uwierzytelniony sygnał trafia do niezmiennego dziennika wejściowego.

  2. 2
    Normalizacja i deduplikacja

    Pipeline buduje klucz deduplikacji, łączy zdarzenia browser/server/store i odrzuca powtórzenia.

  3. 3
    CanonicalEvent

    Powstaje kanoniczna prawda o zakupie, zwrocie lub zmianie statusu zamówienia.

  4. 4
    Identity i touchpointy

    visitor_id, session_id, customer_id, UTMy, fbclid, fbc i fbp wiążą ścieżkę użytkownika.

  5. 5
    AttributionResult

    Wybrany model przypisuje przychód do kanału i encji reklamowej.

  6. 6
    ReportingRollupDaily

    Panel i rozszerzenie odczytują gotowe agregaty dzienne zamiast liczyć z raw eventów.

Flow · przepływ-danych.txtKod
WooCommerce / browser / Meta
  → RawEvent
  → CanonicalEvent
  → AttributionResult
  → ReportingRollupDaily
  → Dashboard / Chrome Extension

Hierarchia źródeł prawdy

PriorytetWarstwaRola
1Store truthZamówienia, statusy i zwroty z WooCommerce
2Canonical eventsZdeduplikowana prawda zdarzeniowa
3Reporting rollupsGotowe metryki w wybranym okresie
4DashboardPrezentacja i diagnostyka danych
5Chrome extensionNakładka na widok Meta Ads Managera

Stan aktualnego MVP

Zbudowane są: domena multi-tenant, ingest, kanoniczne zakupy i zwroty, modele atrybucji, agregaty raportowe, Meta OAuth i synchronizacja, panel v2, plugin WooCommerce oraz rozszerzenie Chrome.

i
Dokumentacja żywego produktu

Opisujemy stan aktywnego kodu Klientometru. Funkcje oznaczone jako MVP lub RC wymagają jeszcze walidacji na realnym sklepie przed uznaniem ich za w pełni produkcyjne.

DalejWooCommerce
Jak działa Klientometr