Meta Ads dla sklepu PrestaShop - piksel, Conversions API i katalog produktów

Łukasz Palej
Łukasz Palej
Technical Implementation Expert
Meta Ads dla sklepu PrestaShop - piksel, Conversions API i katalog produktów

Żeby prowadzić Meta Ads dla sklepu PrestaShop, potrzebujesz trzech elementów: piksela Meta, który mierzy zdarzenia w przeglądarce, Conversions API, które wysyła te same zdarzenia z serwera, i katalogu produktów, z którego powstają reklamy katalogowe. W PrestaShop najprościej wdrożyć je oficjalnym modułem PrestaShop Social with Facebook & Instagram albo modułem firmy trzeciej, a przy niestandardowych potrzebach przez Google Tag Manager i własną integrację serwerową. Kluczowe jest, żeby zdarzenia z przeglądarki i serwera się nie dublowały, a identyfikatory produktów w zdarzeniach zgadzały się z katalogiem.
W tym wpisie pokazujemy, jak wybrać sposób wdrożenia piksela Facebook w PrestaShop 9, jakie zdarzenia zakupowe są potrzebne, jak działa deduplikacja z Conversions API, jak przygotować katalog do reklam dynamicznych i jak sprawdzić, czy wszystko działa. Opieramy się na dokumentacji Meta dla deweloperów, materiałach PrestaShop o module i na kodzie modułu w repozytorium PrestaShopCorp na GitHubie.
[#wazne] W skrócie: Meta Ads dla PrestaShop wymaga piksela, Conversions API i katalogu produktów. Oficjalny moduł PrestaShop Social with Facebook & Instagram według materiałów PrestaShop konfiguruje piksel, obsługuje Conversions API i synchronizuje katalog, ale przed instalacją sprawdź jego zgodność z PrestaShop 9 i warunki abonamentu. Zdarzenia z przeglądarki i serwera łączy wspólny identyfikator zdarzenia. W Vinson wdrażamy sklepy na PrestaShop, a jako Meta Business Partner prowadzimy też kampanie Meta Ads.
Piksel Meta, Conversions API i katalog - po co sklepowi PrestaShop?
Piksel Meta to kod JavaScript w sklepie, który rejestruje działania klientów, np. wyświetlenie produktu, dodanie do koszyka i zakup, i przekazuje je do Meta. Conversions API (CAPI) to interfejs, przez który serwer sklepu wysyła te same zdarzenia bezpośrednio do Meta, bez udziału przeglądarki. Katalog produktów to lista towarów w Menedżerze sprzedaży Meta, z której system buduje reklamy katalogowe, czyli dawne reklamy dynamiczne, pokazujące klientom produkty, które oglądali, lub podobne.
Wszystkie trzy elementy działają razem. Piksel i CAPI dostarczają sygnały o tym, kto co oglądał i kupił, a katalog mówi, jaki produkt kryje się pod identyfikatorem w zdarzeniu. Jeśli identyfikatory w zdarzeniach nie pasują do katalogu, reklama nie pokaże właściwego produktu, a raporty nie połączą sprzedaży z kampanią. Z kolei bez wartości i waluty w zdarzeniu zakupu nie policzysz zwrotu z wydatków na reklamę, a system nie odróżni klienta, który kupił za kilkadziesiąt złotych, od tego, który zostawił w sklepie kilka tysięcy. Różnice między pikselem a CAPI i zasady wdrożenia po stronie serwera opisujemy w tekście Conversions API dla Meta w sklepie online - po co i jak wdrożyć.
Jakie zdarzenia mierzyć w sklepie PrestaShop?
Do kampanii sprzedażowych i reklam katalogowych potrzebujesz co najmniej czterech zdarzeń standardowych Meta. Każde powinno nieść identyfikator produktu, wartość i walutę:
ViewContent - wyświetlenie karty produktu.
AddToCart - dodanie produktu do koszyka.
InitiateCheckout - rozpoczęcie składania zamówienia.
Purchase - złożone zamówienie, z łączną wartością i listą produktów.
Co przygotować po stronie Meta przed wdrożeniem?
Moduł w sklepie to tylko połowa konfiguracji. Zanim go zainstalujesz, uporządkuj konta po stronie Meta, bo przy połączeniu moduł poprosi o wybór zasobów, a błędny wybór trudno później odkręcić:
portfolio biznesowe w Meta Business Suite, którego właścicielem jest firma, a nie prywatne konto pracownika,
konto reklamowe z ustawioną walutą i strefą czasową zgodną ze sklepem,
piksel, w Menedżerze zdarzeń widoczny jako zbiór danych, przypisany do portfolio,
zweryfikowana domena sklepu w ustawieniach firmy,
katalog produktów albo decyzja, że utworzy go moduł.
Jeśli w sklepie działał już kiedyś piksel, np. wklejony ręcznie w kod motywu, usuń go przed instalacją modułu. Dwa piksele lub ten sam piksel wstawiony dwa razy to najprostsza droga do podwójnie liczonych zdarzeń.
Jak wdrożyć piksel Facebook w PrestaShop - moduł czy własna integracja?
PrestaShop rozwija oficjalny moduł PrestaShop Social with Facebook & Instagram (nazwa techniczna ps_facebook). Według centrum pomocy PrestaShop konfiguracja polega na połączeniu konta Facebook w ustawieniach modułu, wyborze strony i konta reklamowego, ustawieniu piksela i synchronizacji katalogu, a blog PrestaShop opisuje obsługę Conversions API przez moduł. Moduł wymaga abonamentu - aktualne warunki sprawdź u producenta. README w repozytorium mówi o zgodności z PrestaShop 1.7 i nowszymi, dlatego przed instalacją sprawdź na stronie modułu, czy obsługuje Twoją wersję PrestaShop 9.
Drugą drogą są moduły firm trzecich do piksela i CAPI, dostępne na PrestaShop Addons i u niezależnych producentów, a trzecią - wdrożenie przez Google Tag Manager z warstwą danych i osobną integracją serwerową. Porównanie pokazuje diagram:
[#chart:prs25a]
Na co uważać przy wyborze modułu do piksela?
Moduł do piksela działa na każdej stronie sklepu, więc wpływa na szybkość i na wszystkie ścieżki zakupowe. Przed zakupem lub instalacją sprawdź u producenta, czy moduł obsługuje Conversions API z deduplikacją, czy wysyła zdarzenia dla kombinacji z właściwym identyfikatorem, czy współpracuje z Twoim banerem zgód i czy działa z Twoim motywem, w tym z Hummingbird, który od PrestaShop 9.1 jest domyślny w nowych instalacjach. Zapytaj też, jak moduł zachowuje się przy płatnościach z przekierowaniem do operatora, bo strona potwierdzenia zamówienia to miejsce, w którym zdarzenie zakupu najczęściej ginie.
Żeby prowadzić Meta Ads dla sklepu PrestaShop, potrzebujesz trzech elementów: piksela Meta, który mierzy zdarzenia w przeglądarce, Conversions API, które wysyła te same zdarzenia z serwera, i katalogu produktów, z którego powstają reklamy katalogowe. W PrestaShop najprościej wdrożyć je oficjalnym modułem PrestaShop Social with Facebook & Instagram albo modułem firmy trzeciej, a przy niestandardowych potrzebach przez Google Tag Manager i własną integrację serwerową. Kluczowe jest, żeby zdarzenia z przeglądarki i serwera się nie dublowały, a identyfikatory produktów w zdarzeniach zgadzały się z katalogiem.
W tym wpisie pokazujemy, jak wybrać sposób wdrożenia piksela Facebook w PrestaShop 9, jakie zdarzenia zakupowe są potrzebne, jak działa deduplikacja z Conversions API, jak przygotować katalog do reklam dynamicznych i jak sprawdzić, czy wszystko działa. Opieramy się na dokumentacji Meta dla deweloperów, materiałach PrestaShop o module i na kodzie modułu w repozytorium PrestaShopCorp na GitHubie.
[#wazne] W skrócie: Meta Ads dla PrestaShop wymaga piksela, Conversions API i katalogu produktów. Oficjalny moduł PrestaShop Social with Facebook & Instagram według materiałów PrestaShop konfiguruje piksel, obsługuje Conversions API i synchronizuje katalog, ale przed instalacją sprawdź jego zgodność z PrestaShop 9 i warunki abonamentu. Zdarzenia z przeglądarki i serwera łączy wspólny identyfikator zdarzenia. W Vinson wdrażamy sklepy na PrestaShop, a jako Meta Business Partner prowadzimy też kampanie Meta Ads.
Piksel Meta, Conversions API i katalog - po co sklepowi PrestaShop?
Piksel Meta to kod JavaScript w sklepie, który rejestruje działania klientów, np. wyświetlenie produktu, dodanie do koszyka i zakup, i przekazuje je do Meta. Conversions API (CAPI) to interfejs, przez który serwer sklepu wysyła te same zdarzenia bezpośrednio do Meta, bez udziału przeglądarki. Katalog produktów to lista towarów w Menedżerze sprzedaży Meta, z której system buduje reklamy katalogowe, czyli dawne reklamy dynamiczne, pokazujące klientom produkty, które oglądali, lub podobne.
Wszystkie trzy elementy działają razem. Piksel i CAPI dostarczają sygnały o tym, kto co oglądał i kupił, a katalog mówi, jaki produkt kryje się pod identyfikatorem w zdarzeniu. Jeśli identyfikatory w zdarzeniach nie pasują do katalogu, reklama nie pokaże właściwego produktu, a raporty nie połączą sprzedaży z kampanią. Z kolei bez wartości i waluty w zdarzeniu zakupu nie policzysz zwrotu z wydatków na reklamę, a system nie odróżni klienta, który kupił za kilkadziesiąt złotych, od tego, który zostawił w sklepie kilka tysięcy. Różnice między pikselem a CAPI i zasady wdrożenia po stronie serwera opisujemy w tekście Conversions API dla Meta w sklepie online - po co i jak wdrożyć.
Jakie zdarzenia mierzyć w sklepie PrestaShop?
Do kampanii sprzedażowych i reklam katalogowych potrzebujesz co najmniej czterech zdarzeń standardowych Meta. Każde powinno nieść identyfikator produktu, wartość i walutę:
ViewContent - wyświetlenie karty produktu.
AddToCart - dodanie produktu do koszyka.
InitiateCheckout - rozpoczęcie składania zamówienia.
Purchase - złożone zamówienie, z łączną wartością i listą produktów.
Co przygotować po stronie Meta przed wdrożeniem?
Moduł w sklepie to tylko połowa konfiguracji. Zanim go zainstalujesz, uporządkuj konta po stronie Meta, bo przy połączeniu moduł poprosi o wybór zasobów, a błędny wybór trudno później odkręcić:
portfolio biznesowe w Meta Business Suite, którego właścicielem jest firma, a nie prywatne konto pracownika,
konto reklamowe z ustawioną walutą i strefą czasową zgodną ze sklepem,
piksel, w Menedżerze zdarzeń widoczny jako zbiór danych, przypisany do portfolio,
zweryfikowana domena sklepu w ustawieniach firmy,
katalog produktów albo decyzja, że utworzy go moduł.
Jeśli w sklepie działał już kiedyś piksel, np. wklejony ręcznie w kod motywu, usuń go przed instalacją modułu. Dwa piksele lub ten sam piksel wstawiony dwa razy to najprostsza droga do podwójnie liczonych zdarzeń.
Jak wdrożyć piksel Facebook w PrestaShop - moduł czy własna integracja?
PrestaShop rozwija oficjalny moduł PrestaShop Social with Facebook & Instagram (nazwa techniczna ps_facebook). Według centrum pomocy PrestaShop konfiguracja polega na połączeniu konta Facebook w ustawieniach modułu, wyborze strony i konta reklamowego, ustawieniu piksela i synchronizacji katalogu, a blog PrestaShop opisuje obsługę Conversions API przez moduł. Moduł wymaga abonamentu - aktualne warunki sprawdź u producenta. README w repozytorium mówi o zgodności z PrestaShop 1.7 i nowszymi, dlatego przed instalacją sprawdź na stronie modułu, czy obsługuje Twoją wersję PrestaShop 9.
Drugą drogą są moduły firm trzecich do piksela i CAPI, dostępne na PrestaShop Addons i u niezależnych producentów, a trzecią - wdrożenie przez Google Tag Manager z warstwą danych i osobną integracją serwerową. Porównanie pokazuje diagram:
[#chart:prs25a]
Na co uważać przy wyborze modułu do piksela?
Moduł do piksela działa na każdej stronie sklepu, więc wpływa na szybkość i na wszystkie ścieżki zakupowe. Przed zakupem lub instalacją sprawdź u producenta, czy moduł obsługuje Conversions API z deduplikacją, czy wysyła zdarzenia dla kombinacji z właściwym identyfikatorem, czy współpracuje z Twoim banerem zgód i czy działa z Twoim motywem, w tym z Hummingbird, który od PrestaShop 9.1 jest domyślny w nowych instalacjach. Zapytaj też, jak moduł zachowuje się przy płatnościach z przekierowaniem do operatora, bo strona potwierdzenia zamówienia to miejsce, w którym zdarzenie zakupu najczęściej ginie.
- Przegląd sklepu, konfiguracji i integracji
- Płatności, wysyłki i połączenie z marketplace’ami
- Plan rozwoju sprzedaży krok po kroku
Konsultację poprowadzi Łukasz Palej, Technical Implementation ExpertConversions API i deduplikacja zdarzeń w PrestaShop
Meta zaleca konfigurację redundantną: te same zdarzenia wysyła piksel i Conversions API. Żeby zakup nie został policzony dwa razy, Meta musi rozpoznać duplikat. Według dokumentacji Meta dla deweloperów zalecana metoda to wspólny identyfikator zdarzenia: wartość eventID w pikselu musi być taka sama jak event_id w zdarzeniu serwerowym, a nazwa zdarzenia w obu kanałach identyczna. Duplikaty są odrzucane, jeśli kolejne zdarzenie z tym samym identyfikatorem przyjdzie w ciągu 48 godzin od pierwszego.
W praktyce oznacza to, że sklep generuje unikalny identyfikator dla każdego zdarzenia, np. dla zakupu na podstawie numeru zamówienia, i przekazuje go zarówno do kodu piksela, jak i do zapytania serwerowego. Dobre moduły robią to same. Przy własnym wdrożeniu przez Google Tag Manager to najczęstsze miejsce błędów: piksel dostaje jeden identyfikator, serwer inny i zakupy liczą się podwójnie.
Zdarzenie serwerowe musi też wiedzieć, skąd przyszedł klient. Dlatego integracja przekazuje razem z nim adres strony, na której zaszło zdarzenie, informację, że konwersja nastąpiła w witrynie, oraz dane pozwalające połączyć je z użytkownikiem. W module te ustawienia są zwykle gotowe, a przy własnej integracji warto oprzeć się na dokumentacji Meta dla deweloperów i przetestować każde zdarzenie osobno, zamiast włączać wszystkie naraz.
Jakość dopasowania zdarzeń
Meta łączy zdarzenie z użytkownikiem na podstawie danych klienta przesłanych razem ze zdarzeniem, np. zaszyfrowanego adresu e-mail i telefonu, identyfikatorów z plików cookie Meta czy adresu IP. W Menedżerze zdarzeń przy zdarzeniach serwerowych zobaczysz ocenę jakości dopasowania. Im więcej poprawnych parametrów, tym lepiej Meta przypisuje zakupy do kampanii i tym lepiej optymalizuje reklamy. W PrestaShop dane do zdarzenia zakupu są dostępne po złożeniu zamówienia, więc dobre wdrożenie CAPI przekazuje je przy zdarzeniu Purchase. Przekazuj je jednak tylko w zakresie, na który pozwalają zgody klienta i polityka prywatności.
[#uwaga] Piksel i Conversions API przetwarzają dane osobowe klientów, a część z nich, np. adres e-mail, jest wysyłana w postaci zaszyfrowanej funkcją skrótu. Zdarzenia marketingowe uruchamiaj zgodnie ze zgodami z banera cookies. Zakres zgód i treść polityki prywatności ustal z prawnikiem. O technicznej stronie zgód piszemy w tekście Pixel Meta i Consent Mode v2 - wdrożenie zgodne z RODO w sklepie.
Katalog produktów z PrestaShop do reklam katalogowych
Katalog w Meta zasilasz synchronizacją z modułu albo plikiem feedu, który moduł eksportu generuje pod stałym adresem. Według materiałów PrestaShop oficjalny moduł synchronizuje zmiany w katalogu automatycznie, codziennie. Niezależnie od drogi katalog potrzebuje danych z formularza produktu w PrestaShop:
| Pole katalogu Meta | Źródło w PrestaShop | Na co uważać |
|---|---|---|
| id | indeks lub ID produktu i kombinacji | ten sam identyfikator co w zdarzeniach piksela |
| title, description | nazwa i opis z zakładki opisu | zwykły tekst, bez kodu HTML i wielkich liter |
| availability | stan i zachowanie przy braku towaru | aktualizacja przy każdej zmianie stanu |
| condition | stan produktu w zakładce szczegółów | nowy, używany lub odnowiony |
| price | cena z regułą podatkową | ta sama waluta co w zdarzeniach |
| link, image_link | adres karty i zdjęcie okładki | zdjęcie dobrej jakości, bez napisów |
| brand | marka w zakładce opisu | uzupełniona w całym katalogu |
Najważniejsza zasada to jeden schemat identyfikatorów. Jeśli katalog używa indeksu kombinacji, piksel i CAPI też muszą wysyłać indeks kombinacji jako identyfikator produktu w zdarzeniu. Mieszanie ID produktu w zdarzeniach z indeksem w katalogu to najczęstsza przyczyna niskiego dopasowania. Wymagania techniczne pliku dla katalogu Meta, takie jak limity znaków i format ceny, zebraliśmy we wpisie Feed produktowy dla Meta Ads i katalogu Facebook - wymagania techniczne.
Kombinacje w katalogu Meta
Produkty z kombinacjami, np. odzież w rozmiarach i kolorach, eksportuj jako osobne pozycje katalogu z własnym identyfikatorem, ceną i stanem, połączone wspólnym identyfikatorem grupy. Dzięki temu reklama pokaże wariant, który klient oglądał, a nie domyślną kombinację. Każda kombinacja powinna mieć unikalny indeks w PrestaShop. Puste lub powtórzone indeksy wariantów sprawiają, że katalog odrzuca część pozycji albo łączy różne rozmiary w jeden produkt.
Kampanie Meta Ads, które korzystają z katalogu
Gdy zdarzenia i katalog działają, możesz uruchomić kampanie sprzedażowe z optymalizacją pod zakup i reklamy katalogowe Advantage+, które Meta wcześniej nazywała reklamami dynamicznymi. Reklamy katalogowe pokazują osobom, które oglądały produkty w sklepie, te same lub podobne produkty, a mogą też docierać do nowych odbiorców zainteresowanych podobnym asortymentem. Do dobrego działania potrzebują aktualnego katalogu: produkt wyprzedany w PrestaShop, który w katalogu nadal ma status dostępny, to wydany budżet i rozczarowany klient. Dlatego częstotliwość synchronizacji katalogu warto dopasować do tempa zmian stanów w sklepie, a produkty bez zdjęć lub z pustymi opisami wykluczyć z zestawów produktów używanych w reklamach.
Jak sprawdzić, czy zdarzenia Meta w PrestaShop działają?
Po wdrożeniu przejdź ścieżkę klienta w sklepie i obserwuj zdarzenia w Menedżerze zdarzeń Meta, w narzędziu testowania zdarzeń. Każde zdarzenie powinno pojawić się raz z przeglądarki i raz z serwera, z tym samym identyfikatorem, a po deduplikacji liczyć się jako jedno. Sprawdź, czy wartości i waluta zgadzają się z koszykiem, a identyfikatory produktów - z katalogiem. Przykładowe proporcje zdarzeń na ścieżce zakupowej pokazuje diagram:
[#chart:prs25b]
Jeśli liczby w Menedżerze zdarzeń wyraźnie odbiegają od zamówień w PrestaShop, szukaj przyczyny w kilku typowych miejscach:
[#chart:prs25c]
Zdarzenia sprawdzaj nie tylko po wdrożeniu, ale też po zmianach w sklepie. Nowy motyw, w PrestaShop 9.1 domyślnie Hummingbird, inny proces zamówienia albo moduł płatności z osobną stroną potwierdzenia mogą sprawić, że zdarzenie zakupu przestanie się wysyłać. Po aktualizacji sklepu złóż zamówienie testowe i sprawdź je w Menedżerze zdarzeń, zanim uruchomisz większy budżet.
Raz w tygodniu porównaj liczbę zdarzeń Purchase w Menedżerze zdarzeń z liczbą zamówień w PrestaShop za ten sam okres. Pełnej zgodności nie będzie, bo część klientów nie wyraża zgody na pliki cookie marketingowe, ale nagła zmiana proporcji zwykle oznacza błąd techniczny, a nie zmianę zachowania klientów. Zapisuj te porównania w prostym arkuszu, żeby po kilku tygodniach znać typową proporcję dla swojego sklepu i szybciej zauważyć odchylenie.
[#checklista] Meta Ads w PrestaShop przed startem kampanii: moduł lub wdrożenie zgodne z PrestaShop 9, piksel i Conversions API włączone, zdarzenia ViewContent, AddToCart, InitiateCheckout i Purchase z wartością i walutą, wspólny identyfikator zdarzenia w obu kanałach, katalog z tym samym schematem identyfikatorów, kombinacje jako osobne pozycje, zdarzenia zgodne z banerem zgód, test w Menedżerze zdarzeń, zamówienie testowe po każdej aktualizacji.
Jak Vinson pomaga z Meta Ads dla sklepu PrestaShop
W Vinson wdrażamy, rozwijamy i utrzymujemy sklepy na PrestaShop, a jako Meta Business Partner prowadzimy kampanie reklamowe. Przy Meta Ads łączymy obie strony:
dobieramy moduł lub sposób wdrożenia piksela i Conversions API,
ustawiamy zdarzenia zakupowe, deduplikację i zgodność z banerem zgód,
przygotowujemy katalog produktów z kombinacjami i spójnymi identyfikatorami,
sprawdzamy zdarzenia po aktualizacjach sklepu i prowadzimy kampanie.
Szczegóły współpracy znajdziesz na stronie sklep na PrestaShop z Vinson.
Najczęściej zadawane pytania
Jak dodać piksel Facebook do PrestaShop?
Najprościej zainstalować moduł do piksela Meta, np. oficjalny PrestaShop Social with Facebook & Instagram, połączyć konto Facebook i wybrać piksel w ustawieniach modułu. Alternatywą jest moduł firmy trzeciej albo Google Tag Manager z warstwą danych. Przed instalacją sprawdź zgodność modułu z PrestaShop 9.
Czy w PrestaShop potrzebuję Conversions API, skoro mam piksel?
Meta zaleca używanie obu jednocześnie. Piksel działa w przeglądarce i bywa blokowany, a Conversions API wysyła zdarzenia z serwera. Warunkiem jest deduplikacja przez wspólny identyfikator zdarzenia i taką samą nazwę zdarzenia w obu kanałach.
Dlaczego Meta liczy zakupy z PrestaShop podwójnie?
Najczęściej piksel i Conversions API wysyłają zakup z różnymi identyfikatorami zdarzenia albo jeden z kanałów nie wysyła identyfikatora wcale. Sprawdź w Menedżerze zdarzeń, czy zdarzenie Purchase z przeglądarki i z serwera ma ten sam identyfikator i tę samą nazwę.
Jak połączyć katalog produktów PrestaShop z Meta?
Przez synchronizację w module, np. oficjalnym module PrestaShop, albo przez plik feedu generowany przez moduł eksportu i dodany jako źródło danych katalogu. Identyfikatory produktów w katalogu muszą być takie same jak w zdarzeniach piksela i Conversions API.
Czy oficjalny moduł Meta dla PrestaShop jest darmowy?
Według centrum pomocy PrestaShop moduł PrestaShop Social with Facebook & Instagram wymaga abonamentu. Aktualną cenę i warunki sprawdź u producenta, a koszt porównaj z modułami firm trzecich i wdrożeniem przez Google Tag Manager.
Dobrze wdrożony piksel, Conversions API i katalog to podstawa skutecznych kampanii Meta Ads dla sklepu PrestaShop. Jeśli chcesz uporządkować pomiar albo przygotować sklep do reklam katalogowych, sprawdź wdrożenie sklepu na PrestaShop z Vinson - zaczniemy od przeglądu zdarzeń w Twoim sklepie.
Conversions API i deduplikacja zdarzeń w PrestaShop
Meta zaleca konfigurację redundantną: te same zdarzenia wysyła piksel i Conversions API. Żeby zakup nie został policzony dwa razy, Meta musi rozpoznać duplikat. Według dokumentacji Meta dla deweloperów zalecana metoda to wspólny identyfikator zdarzenia: wartość eventID w pikselu musi być taka sama jak event_id w zdarzeniu serwerowym, a nazwa zdarzenia w obu kanałach identyczna. Duplikaty są odrzucane, jeśli kolejne zdarzenie z tym samym identyfikatorem przyjdzie w ciągu 48 godzin od pierwszego.
W praktyce oznacza to, że sklep generuje unikalny identyfikator dla każdego zdarzenia, np. dla zakupu na podstawie numeru zamówienia, i przekazuje go zarówno do kodu piksela, jak i do zapytania serwerowego. Dobre moduły robią to same. Przy własnym wdrożeniu przez Google Tag Manager to najczęstsze miejsce błędów: piksel dostaje jeden identyfikator, serwer inny i zakupy liczą się podwójnie.
Zdarzenie serwerowe musi też wiedzieć, skąd przyszedł klient. Dlatego integracja przekazuje razem z nim adres strony, na której zaszło zdarzenie, informację, że konwersja nastąpiła w witrynie, oraz dane pozwalające połączyć je z użytkownikiem. W module te ustawienia są zwykle gotowe, a przy własnej integracji warto oprzeć się na dokumentacji Meta dla deweloperów i przetestować każde zdarzenie osobno, zamiast włączać wszystkie naraz.
Jakość dopasowania zdarzeń
Meta łączy zdarzenie z użytkownikiem na podstawie danych klienta przesłanych razem ze zdarzeniem, np. zaszyfrowanego adresu e-mail i telefonu, identyfikatorów z plików cookie Meta czy adresu IP. W Menedżerze zdarzeń przy zdarzeniach serwerowych zobaczysz ocenę jakości dopasowania. Im więcej poprawnych parametrów, tym lepiej Meta przypisuje zakupy do kampanii i tym lepiej optymalizuje reklamy. W PrestaShop dane do zdarzenia zakupu są dostępne po złożeniu zamówienia, więc dobre wdrożenie CAPI przekazuje je przy zdarzeniu Purchase. Przekazuj je jednak tylko w zakresie, na który pozwalają zgody klienta i polityka prywatności.
[#uwaga] Piksel i Conversions API przetwarzają dane osobowe klientów, a część z nich, np. adres e-mail, jest wysyłana w postaci zaszyfrowanej funkcją skrótu. Zdarzenia marketingowe uruchamiaj zgodnie ze zgodami z banera cookies. Zakres zgód i treść polityki prywatności ustal z prawnikiem. O technicznej stronie zgód piszemy w tekście Pixel Meta i Consent Mode v2 - wdrożenie zgodne z RODO w sklepie.
Katalog produktów z PrestaShop do reklam katalogowych
Katalog w Meta zasilasz synchronizacją z modułu albo plikiem feedu, który moduł eksportu generuje pod stałym adresem. Według materiałów PrestaShop oficjalny moduł synchronizuje zmiany w katalogu automatycznie, codziennie. Niezależnie od drogi katalog potrzebuje danych z formularza produktu w PrestaShop:
| Pole katalogu Meta | Źródło w PrestaShop | Na co uważać |
|---|---|---|
| id | indeks lub ID produktu i kombinacji | ten sam identyfikator co w zdarzeniach piksela |
| title, description | nazwa i opis z zakładki opisu | zwykły tekst, bez kodu HTML i wielkich liter |
| availability | stan i zachowanie przy braku towaru | aktualizacja przy każdej zmianie stanu |
| condition | stan produktu w zakładce szczegółów | nowy, używany lub odnowiony |
| price | cena z regułą podatkową | ta sama waluta co w zdarzeniach |
| link, image_link | adres karty i zdjęcie okładki | zdjęcie dobrej jakości, bez napisów |
| brand | marka w zakładce opisu | uzupełniona w całym katalogu |
Najważniejsza zasada to jeden schemat identyfikatorów. Jeśli katalog używa indeksu kombinacji, piksel i CAPI też muszą wysyłać indeks kombinacji jako identyfikator produktu w zdarzeniu. Mieszanie ID produktu w zdarzeniach z indeksem w katalogu to najczęstsza przyczyna niskiego dopasowania. Wymagania techniczne pliku dla katalogu Meta, takie jak limity znaków i format ceny, zebraliśmy we wpisie Feed produktowy dla Meta Ads i katalogu Facebook - wymagania techniczne.
Kombinacje w katalogu Meta
Produkty z kombinacjami, np. odzież w rozmiarach i kolorach, eksportuj jako osobne pozycje katalogu z własnym identyfikatorem, ceną i stanem, połączone wspólnym identyfikatorem grupy. Dzięki temu reklama pokaże wariant, który klient oglądał, a nie domyślną kombinację. Każda kombinacja powinna mieć unikalny indeks w PrestaShop. Puste lub powtórzone indeksy wariantów sprawiają, że katalog odrzuca część pozycji albo łączy różne rozmiary w jeden produkt.
Kampanie Meta Ads, które korzystają z katalogu
Gdy zdarzenia i katalog działają, możesz uruchomić kampanie sprzedażowe z optymalizacją pod zakup i reklamy katalogowe Advantage+, które Meta wcześniej nazywała reklamami dynamicznymi. Reklamy katalogowe pokazują osobom, które oglądały produkty w sklepie, te same lub podobne produkty, a mogą też docierać do nowych odbiorców zainteresowanych podobnym asortymentem. Do dobrego działania potrzebują aktualnego katalogu: produkt wyprzedany w PrestaShop, który w katalogu nadal ma status dostępny, to wydany budżet i rozczarowany klient. Dlatego częstotliwość synchronizacji katalogu warto dopasować do tempa zmian stanów w sklepie, a produkty bez zdjęć lub z pustymi opisami wykluczyć z zestawów produktów używanych w reklamach.
Jak sprawdzić, czy zdarzenia Meta w PrestaShop działają?
Po wdrożeniu przejdź ścieżkę klienta w sklepie i obserwuj zdarzenia w Menedżerze zdarzeń Meta, w narzędziu testowania zdarzeń. Każde zdarzenie powinno pojawić się raz z przeglądarki i raz z serwera, z tym samym identyfikatorem, a po deduplikacji liczyć się jako jedno. Sprawdź, czy wartości i waluta zgadzają się z koszykiem, a identyfikatory produktów - z katalogiem. Przykładowe proporcje zdarzeń na ścieżce zakupowej pokazuje diagram:
[#chart:prs25b]
Jeśli liczby w Menedżerze zdarzeń wyraźnie odbiegają od zamówień w PrestaShop, szukaj przyczyny w kilku typowych miejscach:
[#chart:prs25c]
Zdarzenia sprawdzaj nie tylko po wdrożeniu, ale też po zmianach w sklepie. Nowy motyw, w PrestaShop 9.1 domyślnie Hummingbird, inny proces zamówienia albo moduł płatności z osobną stroną potwierdzenia mogą sprawić, że zdarzenie zakupu przestanie się wysyłać. Po aktualizacji sklepu złóż zamówienie testowe i sprawdź je w Menedżerze zdarzeń, zanim uruchomisz większy budżet.
Raz w tygodniu porównaj liczbę zdarzeń Purchase w Menedżerze zdarzeń z liczbą zamówień w PrestaShop za ten sam okres. Pełnej zgodności nie będzie, bo część klientów nie wyraża zgody na pliki cookie marketingowe, ale nagła zmiana proporcji zwykle oznacza błąd techniczny, a nie zmianę zachowania klientów. Zapisuj te porównania w prostym arkuszu, żeby po kilku tygodniach znać typową proporcję dla swojego sklepu i szybciej zauważyć odchylenie.
[#checklista] Meta Ads w PrestaShop przed startem kampanii: moduł lub wdrożenie zgodne z PrestaShop 9, piksel i Conversions API włączone, zdarzenia ViewContent, AddToCart, InitiateCheckout i Purchase z wartością i walutą, wspólny identyfikator zdarzenia w obu kanałach, katalog z tym samym schematem identyfikatorów, kombinacje jako osobne pozycje, zdarzenia zgodne z banerem zgód, test w Menedżerze zdarzeń, zamówienie testowe po każdej aktualizacji.
Jak Vinson pomaga z Meta Ads dla sklepu PrestaShop
W Vinson wdrażamy, rozwijamy i utrzymujemy sklepy na PrestaShop, a jako Meta Business Partner prowadzimy kampanie reklamowe. Przy Meta Ads łączymy obie strony:
dobieramy moduł lub sposób wdrożenia piksela i Conversions API,
ustawiamy zdarzenia zakupowe, deduplikację i zgodność z banerem zgód,
przygotowujemy katalog produktów z kombinacjami i spójnymi identyfikatorami,
sprawdzamy zdarzenia po aktualizacjach sklepu i prowadzimy kampanie.
Szczegóły współpracy znajdziesz na stronie sklep na PrestaShop z Vinson.
Najczęściej zadawane pytania
Jak dodać piksel Facebook do PrestaShop?
Najprościej zainstalować moduł do piksela Meta, np. oficjalny PrestaShop Social with Facebook & Instagram, połączyć konto Facebook i wybrać piksel w ustawieniach modułu. Alternatywą jest moduł firmy trzeciej albo Google Tag Manager z warstwą danych. Przed instalacją sprawdź zgodność modułu z PrestaShop 9.
Czy w PrestaShop potrzebuję Conversions API, skoro mam piksel?
Meta zaleca używanie obu jednocześnie. Piksel działa w przeglądarce i bywa blokowany, a Conversions API wysyła zdarzenia z serwera. Warunkiem jest deduplikacja przez wspólny identyfikator zdarzenia i taką samą nazwę zdarzenia w obu kanałach.
Dlaczego Meta liczy zakupy z PrestaShop podwójnie?
Najczęściej piksel i Conversions API wysyłają zakup z różnymi identyfikatorami zdarzenia albo jeden z kanałów nie wysyła identyfikatora wcale. Sprawdź w Menedżerze zdarzeń, czy zdarzenie Purchase z przeglądarki i z serwera ma ten sam identyfikator i tę samą nazwę.
Jak połączyć katalog produktów PrestaShop z Meta?
Przez synchronizację w module, np. oficjalnym module PrestaShop, albo przez plik feedu generowany przez moduł eksportu i dodany jako źródło danych katalogu. Identyfikatory produktów w katalogu muszą być takie same jak w zdarzeniach piksela i Conversions API.
Czy oficjalny moduł Meta dla PrestaShop jest darmowy?
Według centrum pomocy PrestaShop moduł PrestaShop Social with Facebook & Instagram wymaga abonamentu. Aktualną cenę i warunki sprawdź u producenta, a koszt porównaj z modułami firm trzecich i wdrożeniem przez Google Tag Manager.
Dobrze wdrożony piksel, Conversions API i katalog to podstawa skutecznych kampanii Meta Ads dla sklepu PrestaShop. Jeśli chcesz uporządkować pomiar albo przygotować sklep do reklam katalogowych, sprawdź wdrożenie sklepu na PrestaShop z Vinson - zaczniemy od przeglądu zdarzeń w Twoim sklepie.


Łukasz Palej
Technical Implementation Expert
Wdraża integracje i rozwiązania IT dla e-commerce: sklepy, feedy produktowe, przepływ danych między systemami.
Wdraża integracje i rozwiązania IT dla e-commerce: sklepy, feedy produktowe, przepływ danych między systemami.
Sklep na PrestaShop z Vinson
Łukasz i nasz zespół pomogą Ci wdrożyć to na Twoim koncie - bez zobowiązań.
- Analiza Twojego konta i obecnych działań
- Konkretny plan poprawek do wdrożenia
- Bezpłatna konsultacja – bez zobowiązań

Przeczytaj także
Więcej porad z naszej bazy wiedzy - przesuń, aby zobaczyć kolejne artykuły.
Masz pytania? Chętnie porozmawiamy!
Masz pytania? Chętnie porozmawiamy!
Odpowiadamy w ciągu 24 godzin w dni robocze. Pierwsza rozmowa jest bezpłatna i do niczego nie zobowiązuje.
Masz pytania? Chętnie porozmawiamy!
Odpowiadamy w ciągu 24 godzin w dni robocze. Pierwsza rozmowa jest bezpłatna i do niczego nie zobowiązuje.

Bartłomiej Stokłosa
CEO & Founder
"Jeżeli czegoś nie da się zrobić, potrzebny jest ktoś, kto o tym nie wie - przyjdzie i to zrobi."

Bartłomiej Stokłosa
CEO & Founder
"Jeżeli czegoś nie da się zrobić, potrzebny jest ktoś, kto o tym nie wie - przyjdzie i to zrobi."
Wybierz dogodny termin w kalendarzu - bez wymiany maili w tę i z powrotem.
Napisz do nas
Opisz krótko, czego potrzebujesz - oddzwonimy lub odpiszemy w ciągu 24 godzin w dni robocze.
Na zapytanie odpowie Łukasz Palej, Technical Implementation ExpertNapisz do nas
Opisz krótko, czego potrzebujesz - oddzwonimy lub odpiszemy w ciągu 24 godzin w dni robocze.
Na zapytanie odpowie Łukasz Palej, Technical Implementation Expert