Czym jest Meta Pixel App?
Meta Pixel App to mikro aplikacja Witly wbudowana w skrypt witly.js. Działa obok innych mikro aplikacji: wyszukiwarki AI, Google Analytics, rekomendacji produktowych i newslettera.
Jej zadanie: automatycznie wysyłać standardowe eventy e-commerce do Meta Pixel (dawniej Facebook Pixel). Bez ręcznego tagowania, bez dodatkowych wtyczek.
fbevents.js z Twoim Pixel ID i hookuje się do natywnych API platformy (Shoper, PrestaShop, WooCommerce). Każda akcja klienta jest mapowana na odpowiedni event Meta Pixel. Opcjonalnie, event Purchase jest wysyłany również server-side przez Conversions API.7 eventów, które zbieramy automatycznie
Poniżej pełna lista eventów wysyłanych do Meta Pixel. Pokrywają cały funnel: od przeglądania produktów po zakup.
| Event Meta Pixel | Kiedy | Parametry |
|---|---|---|
PageView | Każde załadowanie strony | Automatyczny |
ViewContent | Strona produktu | content_ids, content_name, value, currency |
ViewContent | Strona kategorii / wyników wyszukiwania | content_type: product_group |
AddToCart | Zmiana zawartości koszyka | content_ids, contents, value, currency |
InitiateCheckout | Strona checkoutu | value, currency, num_items |
Purchase | Strona potwierdzenia zamówienia | value, currency, order_id + event_id (deduplikacja) |
Search | Wpisanie frazy w wyszukiwarkę | search_string |
Conversions API (CAPI) i iOS 14+
Od zmian prywatności Apple w iOS 14.5, Meta Pixel client-side traci część danych. Użytkownicy mogą zablokować tracking przez ustawienia prywatności lub ad blockery. Conversions API rozwiązuje ten problem wysyłając eventy bezpośrednio z serwera.
Witly wysyła event Purchase server-side przez CAPI po każdym zamówieniu. Dane użytkownika (email, IP, user agent) są hashowane SHA256 przed wysłaniem — zgodnie z wymaganiami Meta.
Deduplikacja eventów
Gdy Pixel i CAPI wysyłają ten sam event, Meta musi wiedzieć, że to jedna konwersja, nie dwie. Witly generuje deterministyczny event_id w formacie meta_{"{order_id}"}_{"{session_id}"} — identyczny po stronie klienta i serwera.
Meta automatycznie deduplikuje eventy z tym samym event_id i event_name w oknie 48 godzin.
Konfiguracja krok po kroku
Wpisz Pixel ID
W panelu Witly przejdź do Mikro aplikacje i znajdź sekcję Meta Pixel + Conversions API. Wpisz swój Pixel ID (15-16 cyfr). Znajdziesz go w Events Manager → Data Sources → Pixel → Settings.
Opcjonalnie: skonfiguruj CAPI
Włącz switch "CAPI aktywne" i wklej Access Token wygenerowany w Events Manager → Pixel → Settings → Conversions API. Możesz też dodać Test Event Code do weryfikacji w zakładce Test Events.
Włącz i przetestuj
Zacznij od trybu Preview — otwórz sklep z ?enable_witly_preview=1. W Events Manager → Test Events sprawdź, czy eventy się pojawiają. Gdy wszystko działa — przełącz na tryb publiczny.
Cookie consent i prywatność
Meta Pixel wymaga zgody na cookies marketingowe. Witly automatycznie sprawdza kategorię marketing w systemie cookie consent. Pixel ładuje się dopiero po wyrażeniu zgody — zgodnie z RODO i dyrektywą ePrivacy.
Conversions API (server-side) nie wymaga cookies, ale Witly i tak czeka na client-side event, żeby zachować spójność danych i deduplikację.
Zacznij optymalizować kampanie Meta Ads
Wpisz Pixel ID, opcjonalnie skonfiguruj CAPI i włącz aplikację. Witly zaczyna zbierać eventy od następnej wizyty klienta. Lepszy Event Match Quality to lepsze Custom Audiences, niższy CPA i skuteczniejsze kampanie.
Masz pytania? Skontaktuj się z nami — pomożemy skonfigurować tracking pod Twój sklep.