Conversions API (CAPI) (ang. Meta Conversions API) to serwerowy kanał przesyłania zdarzeń konwersji z Twojego serwera (lub kontenera server-side GTM) bezpośrednio do Meta, działający równolegle z Pikselem Meta i niezależny od przeglądarki użytkownika. Dla marketera oznacza to pełniejsze dane o konwersjach w Menedżerze reklam mimo blokad skryptów, wygaszania cookies i ograniczeń iOS (ATT), a co za tym idzie – lepsze uczenie się algorytmu i trafniejszą atrybucję.
Jak działa Conversions API?
Klasyczny Piksel Meta to skrypt JavaScript uruchamiany w przeglądarce. Jeśli użytkownik ma adblock, restrykcyjną przeglądarkę albo odmówił śledzenia w ramach ATT na iOS, zdarzenie w ogóle nie dociera do Meta. CAPI omija ten problem: zdarzenie (np. Purchase, Lead, AddToCart) jest rejestrowane po stronie serwera – w backendzie sklepu, CRM lub w kontenerze server-side GTM – i wysyłane żądaniem HTTP do endpointu Meta wraz z parametrami dopasowania klienta.
- Źródło zdarzenia – serwer sklepu, system płatności, CRM, server-side GTM.
- Parametry dopasowania – e-mail, telefon, imię, kod pocztowy (hashowane SHA-256), plus identyfikatory fbp i fbc, IP i user agent.
- Metadane zdarzenia – event_name, event_time, event_source_url, wartość i waluta.
- event_id – unikalny identyfikator wspólny dla wersji przeglądarkowej i serwerowej tego samego zdarzenia.
Meta rekomenduje tzw. redundant setup: Piksel i CAPI wysyłają te same zdarzenia, a system łączy je w jedno na podstawie deduplikacji. Oficjalną specyfikację znajdziesz w dokumentacji Meta for Developers.
Piksel Meta a Conversions API – porównanie
| Cecha | Piksel Meta | Conversions API |
|---|---|---|
| Miejsce wykonania | Przeglądarka użytkownika | Serwer reklamodawcy / server-side GTM |
| Odporność na adblocki i ATT | Niska | Wysoka |
| Dostęp do danych CRM (offline, LTV) | Brak | Tak |
| Złożoność wdrożenia | Niska | Średnia–wysoka |
| Wymaga deduplikacji | Nie (samodzielnie) | Tak, gdy działa razem z Pikselem |
Jak skonfigurować CAPI i deduplikację?
- Wybierz metodę: integracja natywna (Shopify, WooCommerce, PrestaShop), Conversions API Gateway albo server-side tagging w GTM – najbardziej elastyczna opcja dla własnych sklepów i stron.
- Wygeneruj token dostępu w Menedżerze zdarzeń i podłącz źródło danych do tego samego identyfikatora Piksela.
- Ujednolić nazwy zdarzeń: Purchase w przeglądarce musi być Purchase na serwerze – deduplikacja działa tylko przy identycznym event_name.
- Generuj jeden event_id po stronie strony i przekazuj go do obu kanałów. Meta zachowa pierwsze zdarzenie z daną parą event_name + event_id, drugie odrzuci.
- Przesyłaj jak najwięcej hashowanych danych klienta, aby podnieść wskaźnik Event Match Quality (EMQ).
- Zweryfikuj w narzędziu Test Events, że zdarzenia oznaczone są jako „Deduplicated”, a nie liczone podwójnie.
Kiedy warto wdrażać CAPI, a kiedy nie?
Warto niemal zawsze, gdy prowadzisz kampanie Meta Ads rozliczane z konwersji i zależy Ci na jakości sygnału – zwłaszcza w e-commerce, lead generation i przy dużym udziale ruchu z iOS. W 2026 roku Meta traktuje CAPI jako standard, a nie dodatek. Wdrożenie może nie być priorytetem przy bardzo małych budżetach testowych, gdy strona nie ma żadnych mierzalnych konwersji, albo gdy nie ma zasobów na utrzymanie poprawnej deduplikacji – źle wdrożone CAPI (podwójne zliczanie) jest gorsze niż sam Piksel.
Najczęstsze błędy przy wdrożeniu CAPI
- Brak event_id lub różne identyfikatory w Pikselu i na serwerze – zdublowane konwersje i zawyżony ROAS.
- Rozbieżne nazwy zdarzeń między kanałami (np. „purchase” vs „Purchase”).
- Wysyłanie surowych (niezahashowanych) danych osobowych lub, przeciwnie, brak parametrów dopasowania – niski EMQ.
- Ignorowanie zgód użytkownika – CAPI nie zwalnia z obowiązków wynikających z RODO i nie powinno „obchodzić” odmowy zgody.
- Nieprzekazywanie fbc i fbp, przez co Meta gorzej łączy konwersję z kliknięciem reklamy.
CAPI w praktyce ICBM
W kampaniach Meta Ads wdrażamy CAPI najczęściej przez server-side GTM, bo jeden kontener obsługuje jednocześnie Meta, Google Ads i GA4 oraz pozwala kontrolować, jakie dane opuszczają serwer klienta. Po wdrożeniu zawsze porównujemy liczbę zdarzeń w Menedżerze zdarzeń z danymi zaplecza sklepu – celem jest zbliżony wolumen konwersji i wysoki odsetek zdarzeń oznaczonych jako zdeduplikowane. Poprawnie skonfigurowany kanał serwerowy przekłada się zwykle na stabilniejszą optymalizację kampanii i mniejsze wahania raportowanego kosztu konwersji.
Najczęściej zadawane pytania
Czy CAPI zastępuje Piksel Meta?
Nie. Meta zaleca uruchomienie obu kanałów równolegle. Piksel dostarcza dane o zachowaniu w przeglądarce i identyfikatory fbp/fbc, a CAPI uzupełnia braki powstałe przez blokady i ATT. Warunkiem jest poprawna deduplikacja przez event_id.
Co się stanie, gdy nie wdrożę deduplikacji?
Meta zliczy to samo zdarzenie dwa razy – raz z Piksela, raz z serwera. Raporty pokażą zawyżoną liczbę konwersji i ROAS, a algorytm będzie optymalizował kampanie na zniekształconych danych.
Czy CAPI pozwala śledzić użytkowników, którzy nie wyrazili zgody?
Technicznie kanał serwerowy działa niezależnie od przeglądarki, ale przepisy o ochronie danych obowiązują niezależnie od metody przesyłania. Zdarzenia z danymi osobowymi należy wysyłać wyłącznie w zakresie objętym zgodą użytkownika lub inną podstawą prawną.
