API konwersji Meta (Facebook) w sklepie Shoper — konfiguracja krok po kroku (2026)

Adrian Zblewski · Founder GrowCommerce · Platynowy Partner Shoper

Piksel Meta w przeglądarce nie widzi wszystkiego. Blokery reklam, ustawienia prywatności i brak zgody na pliki cookie zatrzymują część zdarzeń, zanim dotrą do Meta. API konwersji (Conversions API, CAPI) wysyła zdarzenia, w tym zakup, bezpośrednio z serwera sklepu, więc reklamy na Facebooku i Instagramie dostają pełniejsze dane do optymalizacji i raportów.

W tym poradniku pokazujemy krok po kroku, jak włączyć API konwersji w sklepie Shoper, jak uniknąć podwójnego liczenia zakupów i jak sprawdzić, czy wszystko działa. Szerszy obraz pomiaru znajdziesz w przewodniku „Mierzenie konwersji w GA4 w sklepie Shoper”.

Czym jest API konwersji i czym różni się od piksela

Piksel to fragment kodu, który działa w przeglądarce klienta i wysyła zdarzenia, takie jak wyświetlenie produktu, dodanie do koszyka czy zakup. API konwersji wysyła te same informacje drogą serwer–serwer. Meta zaleca używanie obu kanałów razem: piksel zbiera zdarzenia z przeglądarki, a API konwersji uzupełnia to, co przeglądarka zgubiła.

Co musisz mieć przed konfiguracją

• Konto reklamowe Meta i dostęp do Menedżera zdarzeń (Events Manager).
• Zestaw danych (piksel) przypisany do konta reklamowego.
• Dostęp administratora do panelu sklepu Shoper.
• Ustawioną zgodę na pliki cookie w sklepie, zgodnie z polityką prywatności.

Krok 1: skopiuj identyfikator piksela

W Menedżerze reklam przejdź do Menedżera zdarzeń i wybierz zestaw danych (piksel), którego używasz dla sklepu. Identyfikator piksela to ciąg cyfr widoczny przy nazwie zestawu danych. Skopiuj go.

Krok 2: wygeneruj token dostępu

W tym samym zestawie danych otwórz zakładkę ustawień i znajdź sekcję API konwersji. Wybierz opcję wygenerowania tokenu dostępu. Token to długi ciąg znaków, który pozwala sklepowi wysyłać zdarzenia w imieniu Twojego piksela. Traktuj go jak hasło: nie wysyłaj go mailem i nie wklejaj w publiczne miejsca.

Krok 3: włącz integrację w panelu Shoper

W panelu sklepu przejdź do Aplikacje i integracje → Wbudowane integracje (w starszym widoku panelu: Dodatki i integracje → Inne integracje) i wybierz integrację Facebook for Shoper. Otwórz konfigurację, wklej identyfikator piksela i token dostępu, a następnie zapisz ustawienia.

Integracja obsługuje i piksel, i API konwersji. To ważne: jeśli wcześniej wkleiłeś kod piksela ręcznie do szablonu albo używasz innej aplikacji, która dodaje piksel, usuń dodatkowy kod. Dwa piksele w sklepie to najprostsza droga do podwójnie liczonych zakupów. Integracja działa w szablonach RWD i Storefront. Śledzenie możesz w każdej chwili wyłączyć w konfiguracji bez usuwania tokenu.

Krok 4: sprawdź zdarzenia w Menedżerze zdarzeń

Złóż zamówienie testowe (na przykład z płatnością przy odbiorze, którą potem anulujesz). W Menedżerze zdarzeń otwórz zestaw danych i sprawdź, czy zakup pojawia się z dwóch źródeł: przeglądarki i serwera. Narzędzie do testowania zdarzeń pokazuje zdarzenia na bieżąco, a w przeglądzie zestawu danych zobaczysz informację o deduplikacji.

Deduplikacja: jak nie liczyć zakupu dwa razy

Skoro ten sam zakup przychodzi z piksela i z serwera, Meta musi wiedzieć, że to jedno zdarzenie. Według dokumentacji Meta łączy zdarzenia, które mają tę samą nazwę zdarzenia i ten sam identyfikator zdarzenia (event_id po stronie serwera, eventID po stronie piksela), jeśli dotrą w ciągu 48 godzin. Integracja w sklepie ustawia to za Ciebie. Problem pojawia się wtedy, gdy obok integracji działa drugi piksel, który wysyła zakup bez identyfikatora.

Jakość dopasowania zdarzeń

W Menedżerze zdarzeń przy zdarzeniach z serwera zobaczysz ocenę jakości dopasowania (Event Match Quality) w skali do 10. Pokazuje ona, jak dobrze Meta może przypisać zdarzenie do konta użytkownika na podstawie przesłanych danych klienta. Im wyższa ocena, tym lepiej reklamy mogą się optymalizować. Meta podpowiada przy ocenie, których danych brakuje.

Pamiętaj o zgodach. To, jakie dane trafiają do Meta i kiedy, musi wynikać z Twojej polityki prywatności i zgód klientów na pliki cookie. Jak wykorzystać zebrane dane w kampaniach, opisujemy w poradniku „Remarketing w sklepie Shoper: Meta i Google”.

Najczęstsze problemy

Przy okazji sprawdź, jak sklep wygląda po udostępnieniu linku na Facebooku — zobacz „Zmiana obrazu udostępniania na Facebooku”.

Reklamy to nie jedyne źródło przychodu do zmierzenia

API konwersji poprawia pomiar reklam Meta. Część zamówień przychodzi jednak z maili, a ich przychód warto widzieć osobno. GrowMail przypisuje przychód do każdej kampanii i scenariusza, więc porównasz, co dają reklamy, a co e-mail. Jeśli używasz wideo produktowego, GrowVideo przekazuje zdarzenia do GA4 i pikseli reklamowych. Raporty sprzedaży w panelu opisujemy w artykule „Własne raporty w Shoperze”.

Najczęstsze pytania

Czym API konwersji różni się od piksela Meta?

Piksel działa w przeglądarce klienta, a API konwersji wysyła te same informacje drogą serwer–serwer. Meta zaleca używanie obu kanałów razem: API konwersji uzupełnia to, co przeglądarka zgubiła.

Gdzie w Shoperze włączyć API konwersji?

W Aplikacje i integracje → Wbudowane integracje wybierz Facebook for Shoper, wklej identyfikator piksela i token dostępu, a następnie zapisz ustawienia.

Jak uniknąć podwójnego liczenia zakupów?

Meta łączy zdarzenia z tą samą nazwą i tym samym identyfikatorem zdarzenia, jeśli dotrą w ciągu 48 godzin, a integracja w sklepie ustawia to za Ciebie. Usuń piksel wklejony ręcznie do szablonu albo dodawany przez inną aplikację.

Jak sprawdzić, czy API konwersji działa?

Złóż zamówienie testowe i w Menedżerze zdarzeń sprawdź, czy zakup pojawia się z dwóch źródeł: przeglądarki i serwera.

Jak traktować token dostępu do API konwersji?

Jak hasło: nie wysyłaj go mailem i nie wklejaj w publiczne miejsca.

Checklista: API konwersji Meta w sklepie Shoper

• Mam dostęp do Menedżera zdarzeń i zestawu danych (piksela) sklepu.
• Identyfikator piksela skopiowany bez spacji.
• Token dostępu wygenerowany i przechowywany bezpiecznie.
• Integracja Facebook for Shoper skonfigurowana i zapisana.
• Usunięty ręcznie wklejony kod piksela i piksele z innych aplikacji.
• Zamówienie testowe widoczne z przeglądarki i z serwera.
• Deduplikacja działa: jeden zakup, nie dwa.
• Sprawdzona ocena jakości dopasowania zdarzeń.
• Polityka prywatności i zgody na cookies opisują przekazywanie danych do Meta.

Adrian ZblewskiFounder GrowCommerce — Platynowy Partner ShoperFounder GrowCommerce — Platynowego Partnera Shoper z 8-letnim doświadczeniem i ponad 1020 wdrożeniami. GrowCommerce tworzy szablony rodziny Modern (Modern 3.0 Storefront), aplikacje GrowX i GrowMail — e-mail marketing dla Shopera.Wszystkie wpisy autora