W skrócie
Cytuj to hasło
Zaznacz przypis i skopiuj: CAPI. W: Słownik pojęć e-commerce, Pro1.pl. https://pro1.pl/slownik/capi (sprawdzono 23 września 2026).
CAPI (Conversions API) to interfejs Meta do przesyłania zdarzeń, np. zakupów, prosto z serwera sklepu, z pominięciem przeglądarki; uzupełnia Piksel Meta.
- #Consent Mode i cookies
Na tej stronie (5)
Zdarzenia (wyświetlenie produktu, dodanie do koszyka, zakup, lead) wychodzą bezpośrednio z serwera sklepu albo z serwera tagowania do Meta, więc omijają przeglądarkę. Piksel Meta wysyła te same zdarzenia z przeglądarki i jest podatny na blokowanie skryptów, ograniczenia Safari (ITP) i ATT w iOS; CAPI działa obok niego, nie zamiast.
Zanim to zrozumiesz
- Piksel Meta: Piksel Meta to fragment kodu na stronie sklepu, który wysyła do Meta zdarzenia z przeglądarki, np.
- ATT: ATT (App Tracking Transparency, zgoda na śledzenie w iOS) to mechanizm Apple wymagający zgody na śledzenie między aplikacjami, co ogranicza pomiar reklam.
Jak się tego używa
Standardowe wdrożenie to piksel i CAPI równolegle: każde zdarzenie ma nazwę i identyfikator (event_id), a Meta usuwa duplikaty, gdy ten sam identyfikator przyjdzie obiema drogami. Zdarzenia z serwera niosą parametry dopasowania (zahaszowany e-mail, telefon, identyfikator kliknięcia fbclid, adres IP), których jakość Events Manager ocenia jako EMQ. Źródłem może być wtyczka platformy sklepowej albo kontener server-side GTM.
Dlaczego warto to znać
Bez CAPI część zakupów nie dociera do Meta, algorytm optymalizuje na niepełnych danych, a raportowany koszt konwersji jest zawyżony. CAPI nie „odzyskuje" danych zablokowanych przez ATT ani nie zastępuje zgody użytkownika: zdarzenia bez zgody nie powinny być wysyłane, a Meta wymaga przekazania jej statusu.
Na co uważać
CAPI to nie drugi piksel: bez deduplikacji te same zakupy liczą się dwa razy i wyniki wyglądają lepiej, niż są. Zdarzenia z serwera bez identyfikatora kliknięcia i danych klienta dopasowują się słabo (niskie EMQ) i nie poprawiają optymalizacji. Przesłanie wartości zamówienia przez CAPI nie oznacza jeszcze optymalizacji pod zysk: system optymalizuje pod przekazaną wartość, więc marżę trzeba w nią wliczyć samemu.
Przykład
Klient kupuje, piksel wysyła zdarzenie Purchase z event_id 4711 i wartością 250 zł, serwer sklepu wysyła to samo zdarzenie z event_id 4711 po potwierdzeniu płatności. Meta liczy jeden zakup. Jeśli piksel został zablokowany, dociera tylko wersja serwerowa i zakup nadal jest policzony. Gdy wtyczka nadaje różne identyfikatory obu ścieżkom, panel pokaże dwa zakupy i koszt konwersji spadnie o połowę bez zmiany sprzedaży.
Co z tym zrobić w sklepie
W Menedżerze zdarzeń warto sprawdzić, czy zakup dociera dwiema drogami, z Piksela i z serwera, i czy oba mają ten sam identyfikator zdarzenia, bo inaczej Meta policzy go podwójnie. Drugi wskaźnik to jakość dopasowania zdarzeń: niska oznacza, że serwer wysyła zakup bez danych klienta. Co to zmienia w fazie uczenia się, wyjaśnia pytanie o fazę uczenia się w Meta, a od czego zacząć, gdy kampania nie sprzedaje, pytanie o reklamę, która nie sprzedaje.
W panelu: API konwersji (panel Meta Ads, sprawdzono 24.09.2026)
Zobacz też
Piksel Meta
Piksel Meta to fragment kodu na stronie sklepu, który wysyła do Meta zdarzenia z przeglądarki, np.
Deduplikacja zdarzeń
Deduplikacja zdarzeń to mechanizm, dzięki któremu Meta liczy raz zdarzenie wysłane dwiema drogami, z Piksela i z CAPI, jeśli ma ten sam identyfikator.
EMQ
EMQ (jakość dopasowania zdarzeń) to ocena Meta, jak dobrze dane dołączone do zdarzenia z CAPI pozwalają przypisać je do konta użytkownika.
ATT
ATT (App Tracking Transparency, zgoda na śledzenie w iOS) to mechanizm Apple wymagający zgody na śledzenie między aplikacjami, co ogranicza pomiar reklam.
Server-side tagging
Server-side tagging (tagowanie po stronie serwera) to pomiar, w którym zdarzenia trafiają najpierw na serwer sklepu, a dopiero stamtąd do narzędzi.