KlientometrKlientometrDocumentation
DokumentacjaRozszerzenie Chrome
Integracje

Rozszerzenie Chrome

MV3 0.8.0 RC

Rozszerzenie wyświetla realny przychód, zakupy, ROAS i CAC bezpośrednio przy danych kampanii w Meta Ads Managerze.

Instalacja i autoryzacja

  1. 1
    Wygeneruj token rozszerzenia

    W panelu otwórz Ustawienia → Klucze API i utwórz osobny token z prefiksem kme_.

  2. 2
    Zainstaluj rozszerzenie

    Użyj linku unlisted Chrome Web Store albo załaduj katalog chrome-mv3 jako unpacked dla lokalnego RC.

  3. 3
    Wklej token w popupie

    Popup jest jedynym miejscem autoryzacji rozszerzenia.

  4. 4
    Wybierz workspace i konto

    Zapisz domyślny workspace oraz konto Meta, którego dane mają być pokazane.

  5. 5
    Otwórz Ads Manager

    Drawer i inline badges pojawią się na obsługiwanych widokach kampanii, adsetów i reklam.

Co pokazuje overlay

Rozszerzenie pobiera agregaty dla aktualnego poziomu campaign, adset lub ad. Zwraca m.in. spend, real purchases, real revenue, net revenue, refunds, ROAS, new customers, CAC oraz metryki Meta do porównania.

Brak wartości syntetycznych

Overlay nie generuje mocków. Gdy API nie zwraca wiarygodnego dopasowania, rozszerzenie pokazuje stan no_data, needs_sync lub partial zamiast wymyślonego wyniku.

Klientometr Pixel Helper

Po otwarciu popupu na stronie sklepu helper sprawdza aktywność Pixela, wersję pluginu, domenę oraz ostatnie eventy z event_id i statusem dostawy do Meta Pixel. Odczyt wymaga jawnego kliknięcia rozszerzenia i uprawnienia activeTab.

Bezpieczeństwo

  • Produkcja ma dostęp tylko do adsmanager.facebook.com i api.klientometr.pl.
  • Token jest przechowywany w chrome.storage.local.
  • Pixel Helper nie czyta globalnej historii przeglądania.
  • Stan diagnostyczny nie zawiera kluczy ani danych klienta.
  • Dopasowanie używa najpierw identyfikatora Meta; nazwa jest ścisłym fallbackiem.

Ograniczenia wersji RC

Meta regularnie zmienia DOM Ads Managera. Heurystyki inline badges wymagają jeszcze końcowego strojenia na aktywnym interfejsie Meta. Najpierw potwierdź spójność danych w panelu Klientometru, a dopiero później oceniaj overlay.

DalejAPI
Rozszerzenie Chrome