<p><strong>FastTony Pixel</strong> to skrypt śledząc, który integruje się z witryną podobnie do piksela Facebooka. Aby działał prawidłowo i nie kolidował z innymi narzędziami, <strong>musi zostać dodany bezpośrednio w sekcji <code><;head></code> strony</strong> (na każdej podstronie). <strong>Unikamy instalacji przez Google Tag Manager (GTM)</strong> – bezpośrednie osadzenie kodu w <code><;head></code> zapewni szybsze i niezawodne działanie, eliminując opóźnienia i konflikty skryptów​. Poniżej znajdziesz szczegółowe instrukcje instalacji na najpopularniejszych platformach oraz konfiguracji zdarzeń e-commerce.</p>
<p>Kod do osadzenia (przykład):</p>
<pre class=”wp-block-code”><code><;!– FastTony Pixel Code –>;
<;script src=”https://pixel.fasttony.com/761170ef2aad4a08a5189ebf753b5d2a” async defer>;<;/script>;
<;!– End FastTony Pixel Code –>;
</code></pre>
<p>Umieść powyższy fragment <strong>bezpośrednio w sekcji <code><;head>;</code></strong> każdej strony serwisu (zgodnie z instrukcjami dla danej platformy). Atrybuty <code>async defer</code> powodują, że skrypt ładuje się asynchronicznie i nie blokuje renderowania strony.</p>
<h2 class=”wp-block-heading” id=”h-wordpress”><strong>WordPress</strong></h2>
<p>Na WordPressie możesz dodać kod do sekcji <code><;head>;</code> na dwa sposoby: za pomocą wtyczki lub ręcznie w plikach motywu. Wtyczka jest prostsza i pozwala zachować kod przy aktualizacji motywu.</p>
<p><strong>Metoda 1: Wtyczka (np. Insert Headers and Footers / Head &; Footer Code)</strong></p>
<ol class=”wp-block-list”><!– wp:list-item –>
<li><strong>Zainstaluj i włącz wtyczkę do wstawiania kodu w nagłówek</strong> (np. <em>Head, Footer and Post Injections</em> albo <em>Insert Headers and Footers</em>). W panelu WP przejdź do <strong>Wtyczki >; Dodaj nową</strong>, wyszukaj wybraną wtyczkę i zainstaluj ją.</li>
<!– /wp:list-item –>

<!– wp:list-item –>
<li><strong>Wstaw kod FastTony Pixel w nagłówku</strong>: Po aktywacji wtyczki przejdź do jej ustawień (np. <strong>Ustawienia >; Header and Footer</strong>). W sekcji konfiguracji nagłówka znajdziesz pole, które zostanie wstrzyknięte na każdej stronie w obręb <code><;head>;</code>. Wklej tam pełny kod FastTony Pixel i zapisz zmiany​. (Większość wtyczek oferuje pole <em>”Code to add on every page (before <;/head>;)”</em> – użyj właśnie tego pola​).</li>
<!– /wp:list-item –>

<!– wp:list-item –>
<li><strong>Sprawdź, czy kod pojawił się na stronie</strong> (np. wyświetl źródło strony lub użyj narzędzia do weryfikacji – opis w sekcji <strong>Weryfikacja instalacji</strong> poniżej).</li>
<!– /wp:list-item –></ol>
<p><strong>Metoda 2: Ręcznie w plikach motywu</strong> (dla zaawansowanych lub gdy nie możesz użyć wtyczki):</p>
<ol class=”wp-block-list”><!– wp:list-item –>
<li><strong>Użyj motywu potomnego</strong>: Jeśli modyfikujesz pliki motywu, najlepiej utwórz motyw dziecko, by zmiany nie zniknęły po aktualizacji motywu​.</li>
<!– /wp:list-item –>

<!– wp:list-item –>
<li><strong>Edytuj plik nagłówka</strong>: W edytorze plików znajdź plik odpowiedzialny za nagłówek HTML. Zazwyczaj jest to <code>header.php</code> lub w motywach blokowych odpowiednia sekcja HTML. Otwórz ten plik i <strong>tuż przed zamknięciem znacznika <code><;/head>;</code></strong> wklej kod FastTony Pixel​. Zapisz zmiany.</li>
<!– /wp:list-item –>

<!– wp:list-item –>
<li><strong>Odśwież cache</strong> (jeśli korzystasz z cache) i upewnij się, że kod jest w źródle strony.</li>
<!– /wp:list-item –></ol>
<blockquote class=”wp-block-quote”><!– wp:paragraph –>
<p><strong>Uwaga:</strong> Nie instalujemy FastTony Pixel przez Google Tag Manager na WordPressie – umieszczamy kod <strong>bezpośrednio</strong> w nagłówku. Dzięki temu będzie on ładował się najszybciej jak to możliwe i bez potencjalnych opóźnień spowodowanych przez GTM.</p>
<!– /wp:paragraph –></blockquote>
<h2 class=”wp-block-heading” id=”h-woocommerce-wordpress”>WooCommerce (WordPress)</h2>
<p>WooCommerce to wtyczka e-commerce na WordPressie, więc instalacja podstawowego kodu FastTony Pixel odbywa się tak samo jak wyżej (przez wtyczkę do nagłówków lub ręcznie w header.php). <strong>Dodatkowo należy skonfigurować śledzenie zdarzeń e-commerce</strong>, aby Pixel przekazywał wymagane informacje o produktach do Facebooka.</p>
<p><strong>Instalacja kodu podstawowego:</strong> Dodaj skrypt FastTony Pixel do sekcji <code><;head>;</code> strony zgodnie z powyższą instrukcją dla WordPress. Kod będzie wówczas ładowany na wszystkich podstronach (w tym stronach produktów, koszyka, finalizacji zamówienia itp.).</p>
<p><strong>Konfiguracja śledzenia zdarzeń w WooCommerce:</strong> Standardowy kod pikselowy po instalacji śledzi jedynie wyświetlenia stron (PageView). W sklepie internetowym musisz wysyłać także zdarzenia produktów, takie jak:</p>
<ul class=”wp-block-list”><!– wp:list-item –>
<li><strong>ViewContent (oglądanie produktu)</strong> – gdy użytkownik wejdzie na stronę szczegółów produktu,</li>
<!– /wp:list-item –>

<!– wp:list-item –>
<li><strong>AddToCart (dodanie do koszyka)</strong> – po kliknięciu przycisku dodaj do koszyka,</li>
<!– /wp:list-item –>

<!– wp:list-item –>
<li><strong>InitiateCheckout (rozpoczęcie realizacji zakupu)</strong> – gdy klient przechodzi do kasy,</li>
<!– /wp:list-item –>

<!– wp:list-item –>
<li><strong>Purchase (zakup)</strong> – na stronie potwierdzenia zamówienia (po zakupie).</li>
<!– /wp:list-item –></ul>
<p>Najprostszym sposobem jest skorzystanie z wtyczki wspierającej Pixel w WooCommerce, która automatycznie wyśle te zdarzenia. Przykładowo, wtyczka <strong>PixelYourSite</strong> pozwala podać ID piksela i automatycznie rejestruje zdarzenia e-commerce (oglądanie produktu, dodanie do koszyka, zakup itp.)​. Pamiętaj jednak, by <strong>nie dublować instalacji piksela</strong> – jeśli używasz wtyczki typu PixelYourSite, <strong>nie dodawaj już ręcznie skryptu w <code><;head>;</code></strong>, tylko skonfiguruj piksel w ramach tej wtyczki (podając ID). Alternatywnie, jeśli pozostajesz przy ręcznym kodzie FastTony w <code><;head>;</code>, możesz wyłączyć w wtyczce dodawanie kodu podstawowego, a użyć jej jedynie do wysyłania zdarzeń (o ile to możliwe).</p>
<p>Jeżeli nie korzystasz z dodatkowej wtyczki, możesz <strong>ręcznie osadzić kody zdarzeń</strong> w odpowiednich miejscach WooCommerce:</p>
<ul class=”wp-block-list”><!– wp:list-item –>
<li><strong>Oglądanie produktu (ViewContent):</strong> edytuj szablon strony produktu (<code>single-product.php</code> lub odpowiedni hook) i dodaj tam skrypt wywołujący zdarzenie <code>ViewContent</code> z parametrami produktu (ID, nazwa, cena itp.).</li>
<!– /wp:list-item –>

<!– wp:list-item –>
<li><strong>Dodanie do koszyka (AddToCart):</strong> wywołaj zdarzenie w momencie kliknięcia przycisku “Dodaj do koszyka” – np. poprzez JavaScript nasłuchujący na ten klik (można dodać fragment JS w stopce strony produktów/kategorii, który wywoła <code>fbq(’track’, 'AddToCart’, {…})</code> po dodaniu).</li>
<!– /wp:list-item –>

<!– wp:list-item –>
<li><strong>Zakup (Purchase):</strong> w szablonie strony zamówienia (np. <code>thankyou.php</code>) dodaj skrypt wywołujący <code>Purchase</code> wraz z parametrami transakcji (wartość, waluta, ID zamówienia, lista kupionych produktów). WooCommerce udostępnia zmienne z danymi zamówienia, które można wpleść w kod JS.</li>
<!– /wp:list-item –></ul>
<p>Konfiguracja ręczna zdarzeń wymaga znajomości mechanizmów WooCommerce – jeśli nie czujesz się pewnie, skorzystaj z gotowej wtyczki do Pixel/Facebook Ads dla WooCommerce, która zrobi to za Ciebie. Kluczowe jest, by <strong>Pixel wysyłał pełen zakres zdarzeń e-commerce z odpowiednimi parametrami (np. identyfikatory produktów)</strong>. Te identyfikatory muszą pokrywać się z identyfikatorami w Twoim katalogu produktów (product feed), aby Facebook mógł prawidłowo dopasowywać zdarzenia do produktów w reklamach dynamicznych.</p>
<h2 class=”wp-block-heading” id=”h-iai-shop-idosell”>IAI-Shop (IdoSell)</h2>
<p>Platforma IAI (obecnie <strong>IdoSell</strong>) umożliwia integrację kodów w sekcji <code><;head>;</code> poprzez swoje opcje administracyjne. <strong>Nie ograniczaj się do podania samego ID piksela</strong> w panelu IAI – zamiast tego wstaw pełny kod FastTony Pixel, aby mieć pełną kontrolę nad zdarzeniami.</p>
<p>Aby dodać kod do <code><;head>;</code> w IdoSell:</p>
<ol class=”wp-block-list”><!– wp:list-item –>
<li><strong>Zaloguj się do panelu IdoSell</strong> (administracja sklepu).</li>
<!– /wp:list-item –>

<!– wp:list-item –>
<li><strong>Przejdź do sekcji Moderacja >; Dodatki HTML i JavaScript</strong>. W IdoSell skrypty dodaje się jako tzw. “dodatki HTML/JS”. Jeśli nie masz utworzonej własnej kampanii dodatków, najpierw wybierz opcję <em>Dodaj kampanię</em> (kampania może grupować kilka skryptów)​. Następnie w ramach kampanii dodaj nowy dodatek.</li>
<!– /wp:list-item –>

<!– wp:list-item –>
<li><strong>Dodaj nowy dodatek HTML:</strong> Wybierz <em>Nowy dodatek</em> i wypełnij pola: wpisz nazwę (np. “FastTony Pixel”), ustaw <em>Aktywny: Tak</em> i <em>Pokazuj: Normalna i mobilna wersja strony</em>​. Jako <em>Typ dodatku</em> wybierz <strong>HTML</strong> i w polu edycji HTML wklej <strong>pełny kod skryptu FastTony Pixel</strong>​.</li>
<!– /wp:list-item –>

<!– wp:list-item –>
<li><strong>Wybierz miejsce wyświetlania:</strong> Ustaw <em>Wyświetlaj w:</em> <strong>sekcja head</strong> (nagłówek strony) oraz <em>Wyświetlaj na podstronach:</em> <strong>Wszystkich</strong> (aby kod był obecny na każdej podstronie sklepu)​.</li>
<!– /wp:list-item –>

<!– wp:list-item –>
<li>Zapisz dodatek i <strong>wyczyść cache</strong> sklepu, jeśli jest włączony. Od tego momentu skrypt będzie automatycznie dodawany do <code><;head>;</code> każdej strony sklepu.</li>
<!– /wp:list-item –></ol>
<p>IdoSell posiada własną integrację Meta Pixel (Facebook Pixel) poprzez podanie ID, która domyślnie śledzi standardowe zdarzenia e-commerce (PageView, ViewContent, AddToCart, Purchase itp.). Jeśli jednak korzystasz z własnego kodu FastTony Pixel zamiast wbudowanej integracji, <strong>musisz zadbać o wysyłanie zdarzeń samodzielnie</strong>. </p>
<p>Dwie opcje to:</p>
<ul class=”wp-block-list”><!– wp:list-item –>
<li><strong>Korzystać równolegle z integracji IdoSell (ID piksela)</strong> – <em>niezalecane</em>, bo dubluje kod. Lepiej wybrać jedną metodę.</li>
<!– /wp:list-item –>

<!– wp:list-item –>
<li><strong>Dodać własne skrypty zdarzeń</strong> podobnie jak w WooCommerce: np. w ramach dodatków HTML/JS utwórz osobne skrypty wywołujące zdarzenia <strong>Purchase</strong> na stronie potwierdzenia zamówienia (można skorzystać z zmiennych IdoSell, np. placeholderów <code>{order_id}</code> itp. w kodzie – panel IAI pozwala wstawiać dynamiczne wartości w dodatkach), a <strong>ViewContent/AddToCart</strong> na stronach produktów i koszyka. IAI oferuje mechanizm modułu CPA, który pozwala uruchamiać kod dla konkretnych stron (np. tylko na “Thank you page”) – możesz z niego skorzystać do osadzenia kodu zakupu jeśli nie chcesz tworzyć własnej logiki rozpoznawania strony zamówienia​.<a href=”https://www.idosell.com/pl/blog/modul-cpa-1235323453#:~:text=,tryb%20prosty” target=”_blank” rel=”noreferrer noopener”></a></li>
<!– /wp:list-item –></ul>
<p>Dwie opcjePo poprawnej instalacji i konfiguracji, FastTony Pixel będzie zbierał dane o zachowaniu klientów w sklepie IdoSell. Upewnij się w Menedżerze zdarzeń Facebooka, że zdarzenia (zwłaszcza <strong>ViewContent</strong>, <strong>AddToCart</strong>, <strong>Purchase</strong>) są odnotowywane dla Twojego piksela. </p>
<h2 class=”wp-block-heading” id=”h-shoplo”>Shoplo</h2>
<p>W platformie <strong>Shoplo</strong> (starsza platforma e-commerce) dodawanie niestandardowych skryptów odbywa się przez panel administracyjny, w sekcji ustawień śledzenia.</p>
<p><strong>Jak dodać FastTony Pixel w Shoplo:</strong></p>
<ol class=”wp-block-list”><!– wp:list-item –>
<li><strong>Zaloguj się do panelu Shoplo</strong> i przejdź do ustawień sklepu.</li>
<!– /wp:list-item –>

<!– wp:list-item –>
<li><strong>Wybierz zakładkę “Konwersja i Śledzenie”</strong> – w tej sekcji możesz wklejać własne kody śledzące. (W menu bocznym Shoplo należy znaleźć odpowiednią pozycję, np. “Konwersja i śledzenie” zgodnie z instrukcją platformy​).</li>
<!– /wp:list-item –>

<!– wp:list-item –>
<li><strong>Dodaj kod w sekcji HEAD:</strong> Odnajdź pole opisane jako <strong>“Dodatkowy kod w sekcji head”</strong> strony. Wklej <strong>cały kod FastTony Pixel</strong> w to pole​. <strong>Nie usuwaj</strong> przy tym żadnych istniejących kodów, które mogły już tam być – dopisz kod piksela poniżej, aby nie nadpisać innych integracji​.</li>
<!– /wp:list-item –>

<!– wp:list-item –>
<li>Zapisz zmiany konfiguracji (<strong>Zapisz</strong> powinien być dostępny np. w prawym dolnym rogu panelu​). Kod zostanie automatycznie dodany do <code><;head>;</code> wszystkich stron Twojego sklepu.</li>
<!– /wp:list-item –></ol>
<p><strong>Śledzenie zdarzeń w Shoplo:</strong> Shoplo umożliwia podanie <strong>ID Facebook Pixel</strong> w ustawieniach (co skutkuje automatycznym wdrożeniem podstawowych zdarzeń, jak PageView i zakupy). Jednak przy bezpośrednim kodzie FastTony może być konieczne własnoręczne dodanie skryptów zdarzeń:</p>
<ul class=”wp-block-list”><!– wp:list-item –>
<li><strong>Zakup (Purchase):</strong> W Shoplo prawdopodobnie jest osobne pole na kod śledzenia konwersji (np. “Skrypty na stronie z podziękowaniem za zamówienie”). Jeśli tak – wklej tam dodatkowy fragment kodu wywołujący zdarzenie <code>Purchase</code> z odpowiednimi danymi transakcji​. Dzięki temu po złożeniu zamówienia piksel wyśle zdarzenie zakupu.</li>
<!– /wp:list-item –>

<!– wp:list-item –>
<li><strong>Pozostałe zdarzenia</strong> (ViewContent, AddToCart): Sprawdź dokumentację Shoplo – platforma mogła automatycznie obsługiwać podstawowe zdarzenia dla wprowadzonego ID Pixel. Jeśli nie, rozważ dodanie skryptów: np. kod <code>fbq(’track’, 'AddToCart’, {...})</code> w szablonie karty produktu (po kliknięciu “dodaj do koszyka”) itp. W razie wątpliwości skontaktuj się z supportem Shoplo, aby dowiedzieć się, jakie zdarzenia są obsługiwane natywnie, a które trzeba dodać ręcznie.</li>
<!– /wp:list-item –></ul>
<p>Po instalacji kodu w Shoplo, <strong>zweryfikuj działanie piksela</strong> (opis w sekcji weryfikacji). Upewnij się, że zdarzenia e-commerce z Twojego sklepu są rejestrowane (przejrzyj Pixel Helper oraz Menedżer zdarzeń Facebooka).</p>
<h2 class=”wp-block-heading” id=”h-shopify-krotka-instrukcja”>Shopify (krótka instrukcja)</h2>
<p>W Shopify możemy dodać kod piksela bezpośrednio do szablonu sklepu (plik theme.liquid) lub skorzystać z panelu administracyjnego. Zalecana jest edycja kodu motywu, aby umieścić piksel w <code><;head>;</code>:</p>
<ol class=”wp-block-list”><!– wp:list-item –>
<li><strong>Otwórz edycję kodu motywu:</strong> Zaloguj się do Shopify, przejdź do <strong>Online Store (Sklep online) >; Themes (Motywy)</strong>. Przy swoim aktywnym motywie kliknij <strong>Actions >; Edit code (Edytuj kod)</strong>​.</li>
<!– /wp:list-item –>

<!– wp:list-item –>
<li><strong>Zlokalizuj plik layoutu motywu:</strong> W edytorze kodu znajdź plik <code>theme.liquid</code> (w sekcji <strong>Layout</strong>). Jest to główny plik szablonu, zawierający m.in. nagłówek HTML całego sklepu​.</li>
<!– /wp:list-item –>

<!– wp:list-item –>
<li><strong>Wstaw kod przed <;/head>;:</strong> W pliku <code>theme.liquid</code> przewiń do końca sekcji <code><;head>;</code> – znajdź znacznik zamykający <code><;/head>;</code>. <strong>Bezpośrednio przed <code><;/head>;</code></strong> wklej skrypt FastTony Pixel​. Upewnij się, że został wklejony w całości (razem z <code><;script ...>;<;/script>;</code>).</li>
<!– /wp:list-item –>

<!– wp:list-item –>
<li><strong>Zapisz zmiany</strong> (przycisk <strong>Save</strong> w edytorze Shopify) i przejdź do podglądu sklepu. Kod będzie teraz ładowany na wszystkich stronach.</li>
<!– /wp:list-item –></ol>
<p>Shopify posiadał kiedyś opcję wpisania samego Pixel ID w ustawieniach (<strong>Preferences >; Facebook Pixel ID</strong>), ale to rozwiązanie oferowało ograniczone śledzenie. <strong>Rekomendowane jest ręczne dodanie pełnego kodu</strong>, co już zrobiłeś. <strong>Konfiguracja zdarzeń:</strong> Jeśli korzystasz z nowszej integracji Facebooka w Shopify (przez Sales Channel “Facebook &; Instagram”), Shopify automatycznie wyśle zdarzenia e-commerce (produkt wyświetlony, dodany do koszyka, zakup) do Twojego piksela. Przy własnoręcznie dodanym kodzie upewnij się, że te zdarzenia są nadal wyzwalane. Możesz to zrobić poprzez:</p>
<ul class=”wp-block-list”><!– wp:list-item –>
<li>Test zamówienia i sprawdzenie w Pixel Helper, czy pojawia się zdarzenie Purchase,</li>
<!– /wp:list-item –>

<!– wp:list-item –>
<li>Sprawdzenie w kodzie strony produktu, czy wywoływane jest <code>fbq(’track’, 'ViewContent’, ...)</code> – Shopify zwykle umieszcza takie wywołania gdzieś w skrypcie szablonu produktu.</li>
<!– /wp:list-item –></ul>
<p>Jeżeli brakuje zdarzeń, rozważ dodanie ich ręcznie (analogicznie jak opisano dla WooCommerce) lub poprzez <strong>Shopify Scripts</strong> (np. skrypt w pliku product.liquid do ViewContent, skrypt w pliku cart/checkout do AddToCart/Purchase – choć tu uwaga: w Shopify standardowe checkout scripts są dostępne od planu Shopify Plus lub poprzez sekcję <strong>Additional Scripts</strong> na stronie potwierdzenia zamówienia).</p>
<h2 class=”wp-block-heading” id=”h-magento-krotka-instrukcja”>Magento (krótka instrukcja)</h2>
<p>W Magento dodanie kodu do <code><;head>;</code> można wykonać przez panel administracyjny bez edycji plików (Magento 2.x):</p>
<ol class=”wp-block-list”><!– wp:list-item –>
<li><strong>Przejdź do konfiguracji szablonu:</strong> Zaloguj się do Magento Admin. Wejdź w <strong>Content (Zawartość) >; Design >; Configuration (Konfiguracja)</strong>. Wybierz swoją skórkę (store view), dla której chcesz dodać kod, i kliknij <strong>Edit (Edytuj)</strong>​.</li>
<!– /wp:list-item –>

<!– wp:list-item –>
<li><strong>Edytuj ustawienia HTML head:</strong> Rozwiń sekcję <strong>HTML Head</strong> ustawień. Znajdziesz tam pole <strong>Scripts and Style Sheets</strong> (Skrypty i arkusze stylów). <strong>Wklej kod FastTony Pixel</strong> do tego pola. To pole pozwala na dołączenie dowolnego kodu HTML/JS do sekcji <code><;head>;</code> strony na wybranym sklepie/skórce.</li>
<!– /wp:list-item –>

<!– wp:list-item –>
<li><strong>Zapisz konfigurację</strong> i <strong>wyczyść cache Magento</strong> (w menu System >; Cache Management), aby zmiany weszły w życie​<a href=”https://magecomp.com/blog/add-custom-code-in-magento-2-head-html-tag/?srsltid=AfmBOopIvdn4weyZjSY_JIn812Nw_lJgIztySP2MLnxG7omhjrEedaTW#:~:text=Image%3A%20Add” target=”_blank” rel=”noreferrer noopener”></a></li>
<!– /wp:list-item –></ol>
<p>Po tej operacji skrypt piksela będzie obecny na wszystkich stronach sklepu. <strong>Uwaga:</strong> Magento często posiada rozszerzenia do integracji Facebook Pixel – upewnij się, że nie masz zainstalowanego modułu, który już dodaje piksel, aby nie dublować kodu.</p>
<p><strong>Śledzenie zdarzeń:</strong> Jeśli korzystasz z oficjalnego modułu Facebooka dla Magento lub innego modułu do Pixel, może on automatycznie obsługiwać zdarzenia e-commerce (cofając się do ID Pixel). Gdy jednak dodajesz kod ręcznie, zadbaj o dodatkowe skrypty: np. w pliku szablonu potwierdzenia zamówienia dodaj kod <code>Purchase</code>, w szablonie produktu wywołaj <code>ViewContent</code> itd. (w Magento 2 można to zrobić poprzez rozszerzenie plików PHTML lub layout XML, co jednak wymaga wiedzy deweloperskiej). Celem jest pokrycie tych samych zdarzeń, o których była mowa wcześniej​– <strong>ViewContent, AddToCart, Purchase</strong> – z poprawnymi parametrami produktów.</p>
<h2 class=”wp-block-heading” id=”h-prestashop-krotka-instrukcja”>PrestaShop (krótka instrukcja)</h2>
<p>W PrestaShop najlepiej wkleić kod FastTony Pixel w szablon nagłówka motywu. Dla PrestaShop 1.7+ zrobisz to następująco:</p>
<ol class=”wp-block-list”><!– wp:list-item –>
<li><strong>Zaloguj się do FTP lub menedżera plików PrestaShop</strong> (ew. w Panelu Presta, jeśli masz moduł do edycji plików szablonu).</li>
<!– /wp:list-item –>

<!– wp:list-item –>
<li><strong>Znajdź plik nagłówka szablonu:</strong> Dla PS 1.7 domyślny motyw <strong>Classic</strong> ma plik <code>/themes/classic/templates/_partials/head.tpl</code>. W przypadku innego motywu ścieżka będzie podobna (<code>/themes/nazwa_motywu/templates/_partials/head.tpl</code>). Otwórz plik <code>head.tpl</code> w edycji​. (W PrestaShop 1.6 szukaj pliku <code>header.tpl</code> w katalogu motywu).</li>
<!– /wp:list-item –>

<!– wp:list-item –>
<li><strong>Wklej kod przed zamknięciem head:</strong> W pliku <code>head.tpl</code> przejdź na sam dół. Nawet jeśli nie widzisz tam jawnie znacznika <code><;/head>;</code>, kod dodany na końcu tego pliku <strong>zostanie umieszczony tuż przed <code><;/head>;</code></strong> podczas kompilacji szablonu​. Wklej tam skrypt FastTony Pixel i zapisz zmiany.</li>
<!– /wp:list-item –>

<!– wp:list-item –>
<li><strong>Wyczyść cache PrestaShop:</strong> Jeśli cache szablonów jest aktywny (Smarty cache), wyczyść go w panelu (Zaawansowane >; Wydajność >; wyłącz cache lub wyczyść). Odśwież stronę sklepu i sprawdź, czy kod się pojawił.</li>
<!– /wp:list-item –></ol>
<p><strong>Śledzenie zdarzeń:</strong> PrestaShop nie ma domyślnie wbudowanego Pixela, więc jeśli wkleiłeś tylko podstawowy kod, musisz też zadbać o zdarzenia. Możesz to zrobić poprzez moduły (np. moduł Facebook Pixel – wiele jest darmowych w Presta Addons – które po podaniu Pixel ID dodadzą odpowiednie wywołania zdarzeń <strong>ViewContent, AddToCart, Purchase</strong>). Alternatywnie, dodaj ręcznie w odpowiednich plikach szablonu:</p>
<ul class=”wp-block-list”><!– wp:list-item –>
<li>w <code>product.tpl</code> (lub ekwiwalencie dla PS 1.7 może to być plik produktowy w katalogu templates/catalog) dodaj skrypt <code>fbq(’track’, 'ViewContent’, {contents: [...]})</code> z danymi produktu,</li>
<!– /wp:list-item –>

<!– wp:list-item –>
<li>w skrypcie obsługi koszyka (np. plik <code>cart.tpl</code> lub poprzez JavaScript theme.js) wywołaj <code>AddToCart</code> po dodaniu,</li>
<!– /wp:list-item –>

<!– wp:list-item –>
<li>na stronie <code>order-confirmation.tpl</code> dodaj kod <code>Purchase</code> z danymi zamówienia.</li>
<!– /wp:list-item –></ul>
<p>Jeśli to zbyt skomplikowane, skorzystaj z gotowego modułu <strong>Facebook Pixel</strong> dla PrestaShop – wiele z nich pozwala uniknąć kodowania. Ważne, by finalnie Pixel przesyłał standardowe zdarzenia e-commerce wymagane przez katalog produktów (Facebook dynamic ads).</p>
<h2 class=”wp-block-heading” id=”h-wix-krotka-instrukcja”>Wix (krótka instrukcja)</h2>
<p>W Wix możesz dodawać własne skrypty przez panel administracyjny, funkcję <strong>Custom Code</strong>:</p>
<ol class=”wp-block-list”><!– wp:list-item –>
<li><strong>Wejdź do kokpitu swojego serwisu Wix</strong> i przejdź do <strong>Settings (Ustawienia)</strong> w panelu zarządzania stroną.</li>
<!– /wp:list-item –>

<!– wp:list-item –>
<li><strong>Wybierz “Custom Code”</strong> (w sekcji Advanced, czyli Zaawansowane). Ta opcja pozwala osadzić niestandardowy kod na wszystkich lub wybranych stronach​.</li>
<!– /wp:list-item –>

<!– wp:list-item –>
<li><strong>Dodaj nowy kod:</strong> Kliknij przycisk <strong>+ Add Custom Code</strong>. W wyświetlonym oknie wklej cały kod FastTony Pixel w pole tekstowe​. Nadaj nazwę (np. “FastTony Pixel”), żeby łatwo rozpoznać ten kod w przyszłości​.</li>
<!– /wp:list-item –>

<!– wp:list-item –>
<li><strong>Wybierz strony i miejsce:</strong> Ustaw <em>Add Code to Pages</em> = <strong>All pages</strong> (wszystkie strony)oraz <em>Place Code in</em> = <strong>Head</strong> (nagłówek)​. Dzięki temu kod będzie w sekcji <code><;head>;</code> każdej podstrony, co jest wymagane.</li>
<!– /wp:list-item –>

<!– wp:list-item –>
<li>Zapisz i <strong>zastosuj</strong> kod (przycisk <strong>Apply</strong>). Teraz opublikuj stronę (jeśli wprowadzałeś zmiany w wersji roboczej). Wix doda skrypt automatycznie do publikowanego serwisu.</li>
<!– /wp:list-item –></ol>
<p><strong>Wix a Pixel Facebooka:</strong> Wix ma integracje marketingowe, np. dedykowane pole na Google Analytics czy Meta Pixel. <strong>Uwaga:</strong> Według dokumentacji Wix, niektóre skrypty jak Google Tag Manager, Google Analytics czy Facebook Pixel <strong>nie działają poprawnie poprzez Custom Code</strong> i zaleca się ich dodawanie przez wbudowane integracje​. Jeśli Twój Wix oferuje natywne podpięcie Facebook Pixela (np. poprzez podanie ID w Marketing Integrations), rozważ użycie tego mechanizmu – ale wtedy dodawaj <em>tylko</em> ID w integracji, <strong>nie duplikuj ręcznie kodu</strong>. W kontekście FastTony Pixel (niestandardowy skrypt) najbezpieczniej jest jednak użyć metody Custom Code jak powyżej. Po dodaniu kodu sprawdź poprzez Pixel Helper, czy Wix go umieścił (powinien być widoczny w źródle strony).</p>
<p>Zdarzenia w Wix (jeśli dodano kod ręcznie) trzeba by dodać przez dodatkowy kod JavaScript (Wix Velo lub Google Tag Manager – ale GTM chcemy unikać). W praktyce, <strong>jeśli prowadzisz sklep na Wix (Wix Stores)</strong>, użyj oficjalnej integracji Facebooka w Wix – zapewni to śledzenie zdarzeń e-commerce. Dla zwykłych stron Wix (bez sklepu) wystarczy PageView z podstawowego kodu.</p>
<h2 class=”wp-block-heading” id=”h-joomla-krotka-instrukcja”>Joomla (krótka instrukcja)</h2>
<p>W Joomla brak wbudowanego mechanizmu wklejania kodu w <code><;head>;</code> przez panel (chyba że używasz specjalnego pluginu). Najbardziej niezawodną metodą jest edycja plików szablonu albo użycie małego modułu typu „Custom Code”. Oto dwie opcje:</p>
<p><strong>Opcja A: Edycja pliku szablonu</strong></p>
<ol class=”wp-block-list”><!– wp:list-item –>
<li><strong>Znajdź plik index.php motywu:</strong> Zaloguj się do panelu Joomla (administrator). Przejdź do <strong>System >; Site Templates (Szablony witryny)</strong> i wybierz swój aktywny szablon, następnie opcję <strong>Edytuj</strong>. Otwórz plik główny szablonu – zazwyczaj <code>index.php</code>​. (W Joomla 4 interfejs edycji plików pozwala to zrobić wprost z panelu).</li>
<!– /wp:list-item –>

<!– wp:list-item –>
<li><strong>Wstaw kod w <code><;head>;</code>:</strong> W pliku <code>index.php</code> znajdź sekcję z nagłówkiem HTML. Najczęściej zobaczysz tam znaczniki <code><;head>;</code> i na końcu <code><;/head>;</code>. <strong>Wklej kod FastTony Pixel tuż przed <code><;/head>;</code></strong>​. Upewnij się, że jest we właściwym miejscu pomiędzy innymi meta tagami i skryptami.</li>
<!– /wp:list-item –>

<!– wp:list-item –>
<li>Zapisz zmiany pliku. Po odświeżeniu strony Joomla powinna mieć już osadzony piksel (sprawdź poprzez podgląd kodu strony lub Pixel Helper).</li>
<!– /wp:list-item –></ol>
<p><strong>Opcja B: Własny moduł typu “HTML Custom”</strong> (bez edycji plików):</p>
<ol class=”wp-block-list”><!– wp:list-item –>
<li>W Joomla możesz utworzyć moduł, który wstrzyknie kod do nagłówka. Skorzystaj z rozszerzenia <strong>Custom Code in Head</strong> (dostępne w Joomla Extensions Directory) lub utwórz własny moduł typu HTML.</li>
<!– /wp:list-item –>

<!– wp:list-item –>
<li><strong>Utwórz nowy moduł:</strong> W panelu admina Joomla przejdź do <strong>Rozszerzenia >; Moduły >; Nowy</strong> i wybierz typ <strong>Własny (Custom)</strong>. W treści modułu włącz edycję HTML (przełącz edytor na tryb kodu) i wklej kod piksela w całości.</li>
<!– /wp:list-item –>

<!– wp:list-item –>
<li><strong>Ustaw pozycję modułu na <code>debug</code> lub inną niewidoczną</strong> w szablonie oraz <strong>ustaw wyświetlanie na wszystkich stronach</strong>. Ważne: wiele szablonów ma pozycję <code>debug</code> lub podobną, która jest wyrenderowana wysoko w kodzie strony – moduł osadzony w takiej pozycji spowoduje dodanie kodu w sekcji head. (Jeśli używasz dedykowanego pluginu “Custom code in head”, on sam zadba o to, żeby kod znalazł się w <code><;head>;</code>​). Zapisz i sprawdź stronę.</li>
<!– /wp:list-item –></ol>
<p><strong>Śledzenie zdarzeń:</strong> Joomla sama w sobie nie ma sklepu (to raczej platforma CMS). Jeśli Twój serwis Joomla to np. witryna firmowa, wystarczy podstawowy kod (PageView). Jeśli korzystasz z komponentu sklepowego (VirtueMart, J2Store czy inny) – poszukaj integracji Facebook Pixel dla tego komponentu lub dodaj zdarzenia analogicznie jak dla innych platform (kod <code>Purchase</code> na stronie potwierdzenia zamówienia, itp.).</p>
<p>Pamiętaj, że <strong>bezpośrednie osadzenie skryptu w <code><;head>;</code> jest preferowane</strong> – dzięki temu piksel ładuje się od razu przy wczytywaniu strony, co zapewnia większą skuteczność zbierania danych.</p>
<h2 class=”wp-block-heading” id=”h-weryfikacja-poprawnosci-instalacji”>Weryfikacja poprawności instalacji</h2>
<p>Po zainstalowaniu FastTony Pixel na stronie, należy sprawdzić, czy działa on prawidłowo:</p>
<ul class=”wp-block-list”><!– wp:list-item –>
<li><strong>Facebook Pixel Helper:</strong> Najprostszym sposobem jest użycie oficjalnej wtyczki do przeglądarki <strong>Meta (Facebook) Pixel Helper</strong>​. Dostępna jest dla Chrome (i innych popularnych przeglądarek). Po zainstalowaniu ikonka Pixel Helper pokaże, czy na danej stronie wykryto piksel i jakie zdarzenia zostały wysłane. Jeśli piksel został poprawnie osadzony w <code><;head>;</code>, Pixel Helper powinien wykryć przynajmniej zdarzenie “PageView” przy wczytaniu strony​.</li>
<!– /wp:list-item –>

<!– wp:list-item –>
<li><strong>Podgląd w kodzie strony:</strong> Możesz także w przeglądarce wyświetlić źródło HTML swojej strony (prawy klik ->; “Pokaż źródło strony”) i wyszukać fragment <code>pixel.fasttony.com</code> – jeśli znajduje się w sekcji <code><;head>;</code>, oznacza to, że kod został dodany.</li>
<!– /wp:list-item –>

<!– wp:list-item –>
<li><strong>Menedżer zdarzeń Facebook (Events Manager):</strong> Wejdź do Facebook Business Manager >; Menedżer zdarzeń i wybierz swojego Pixela. Skorzystaj z funkcji <strong>Testowanie zdarzeń</strong> – wpisz adres swojej strony i zobacz, czy Facebook odbiera zdarzenia w czasie rzeczywistym. Powinieneś zobaczyć pojawiające się zdarzenia PageView, a po wykonaniu akcji na stronie (dodanie produktu do koszyka, zakup testowy itp.) odpowiednie zdarzenia e-commerce.</li>
<!– /wp:list-item –>

<!– wp:list-item –>
<li><strong>Brak błędów w konsoli:</strong> Otwórz konsolę JavaScript na stronie (F12 w przeglądarce) i sprawdź, czy nie ma błędów związanych z pixelem (np. brakujący <code>fbq</code> lub inne). Jeśli dodałeś kod poprawnie, nie powinno być błędów – biblioteka piksela powinna załadować się z serwera FastTony.</li>
<!– /wp:list-item –></ul>
<p>Jeśli Pixel Helper <em>nie wykrywa piksela</em>, upewnij się, że: a) kod jest dokładnie taki, jak podany (żadnych literówek, np. cudzysłowów itp.), b) znalazł się wewnątrz <code><;head>;...<;/head>;</code> strony (nie w <code><;body>;</code>), c) skrypt nie został zablokowany przez np. wtyczkę blokującą reklamy. Pamiętaj, aby na czas testów wyłączyć AdBlocka i inne blokery, gdyż potrafią one ukrywać obecność piksela.</p>
<h2 class=”wp-block-heading” id=”h-konfiguracja-pelnego-zakresu-zdarzen-product-feed”>Konfiguracja pełnego zakresu zdarzeń (product feed)</h2>
<p>Aby w pełni wykorzystać FastTony Pixel (szczególnie do kampanii dynamicznych z katalogiem produktów), musisz zapewnić śledzenie pełnego zakresu standardowych zdarzeń e-commerce. Oznacza to, że piksel powinien wysyłać co najmniej: PageView, ViewContent (wyświetlenie szczegółów produktu), AddToCart, InitiateCheckout, Purchase, a opcjonalnie też Search, AddToWishlist – zależnie od funkcji sklepu. Każde z tych zdarzeń powinno zawierać parametry (zwłaszcza identyfikator produktu, czyli content_ids lub pojedynczy content_id, a także wartość transakcji przy zakupie, walutę itp.), które są zgodne z danymi w Twoim feedzie produktowym. Dzięki temu Facebook będzie mógł dopasować zdarzenia do konkretnych produktów w katalogu i kierować reklamy dynamiczne do osób, które oglądały lub dodały te produkty do koszyka​.</p>
<p>Jeśli Twoja platforma <strong>obsługiwała dotąd tylko podanie ID Pixel</strong> (np. poprzez panel administracyjny bez możliwości wklejenia własnych skryptów), to prawdopodobnie <strong>pewne zdarzenia były domyślnie wysyłane</strong>, ale nie zawsze wszystkie wymagane. Przykładowo, platforma mogła śledzić PageView i Purchase, ale brakowało zdarzeń ViewContent lub AddToCart – a te są krytyczne dla remarketingu dynamicznego. W takiej sytuacji:</p>
<p><strong>Testuj w Menedżerze zdarzeń</strong>: Użyj zakładki <strong>Test Events</strong> w Facebook Events Manager, aby na bieżąco śledzić, które zdarzenia dochodzą podczas interakcji ze sklepem. Porównaj listę ze standardami Facebooka – wymagane są przede wszystkim: ViewContent, AddToCart, Purchase (do Advantage+ Catalog Ads)​. Brak któregoś – uzupełnij implementację.<br></p>
<p><strong>Sprawdź dokumentację swojej platformy</strong>: dowiedz się, jakie zdarzenia są obsługiwane natywnie po wpisaniu ID Pixel.</p>
<p><strong>Dodaj brakujące zdarzenia ręcznie</strong>: Jeśli platforma nie wysyła któregoś ze standardowych zdarzeń, wykorzystaj mechanizmy dodawania własnych skryptów (omówione powyżej dla każdej platformy) aby je wdrożyć. Np. dołóż skrypt <code>fbq(’track’, 'AddToCart’, {...})</code> tam, gdzie brakuje (po dodaniu produktu do koszyka) itp.</p>
<p>Pamiętaj też o <strong>parametrach zdarzeń</strong>: dla <strong>ViewContent/AddToCart/Purchase</strong> konieczne jest przesyłanie identyfikatora produktu (<code>content_id</code> lub <code>content_ids</code>) oraz np. jego wartości <code>value</code> i waluty <code>currency</code> dla Purchase. Identyfikator powinien dokładnie odpowiadać ID (lub SKU) używanemu w pliku produktowym (feed) załadowanym do katalogu Facebook. W przeciwnym razie Facebook nie “skojarzy” zdarzenia z produktem i reklamy dynamiczne nie zadziałają. Fragment kodu z parametrami może wyglądać np. tak (przykład ogólny):</p>
<pre class=”wp-block-code”><code><;script>;
 fbq(’track’, 'ViewContent’, {
 content_ids: &#91;’PROD123’], // ID produktu zgodny z feedem
 content_type: 'product’,
 currency: 'PLN’,
 value: 199.99
 });
<;/script>;
</code></pre>
<p>Analogicznie dla AddToCart i Purchase (Purchase dodatkowo zwykle <code>num_items</code> oraz suma transakcji). Upewnij się, że te wartości są dynamicznie wstawiane przez platformę (np. zmienne szablonu).</p>
<p>Jeśli masz trudność z samodzielnym dodaniem zdarzeń, rozważ skorzystanie z oficjalnych integracji Facebooka dla danej platformy (o ile nie powodują konfliktów) <em>lub</em> zasięgnij pomocy dewelopera znającego daną platformę. <strong>Pełny zakres zdarzeń i poprawne parametry są konieczne</strong>, aby FastTony Pixel mógł zasilać Twoje kampanie (np. remarketing dynamiczny) właściwymi danymi o zachowaniach klientów​.<a href=”https://leadsbridge.com/blog/facebook-dynamic-ads-guide/#:~:text=3,item%20ID%20in%20your%20catalog” target=”_blank” rel=”noreferrer noopener”></a></p>
<h2 class=”wp-block-heading” id=”h-wskazowki-dotyczace-optymalizacji-dzialania-pixela”>Wskazówki dotyczące optymalizacji działania Pixela</h2>
<ul class=”wp-block-list”><!– wp:list-item –>
<li><strong>Unikaj podwójnej instalacji</strong>: Upewnij się, że kod FastTony Pixel jest dodany tylko raz na stronie. Nie dodawaj go jednocześnie przez GTM i bezpośrednio, ani nie używaj równolegle wtyczki, która również osadza piksel (to prowadzi do dublowania zdarzeń). Podwójne piksele mogą powodować zafałszowanie danych (np. każde zdarzenie liczone dwa razy). Wybierz jedną metodę implementacji i konsekwentnie się jej trzymaj.</li>
<!– /wp:list-item –></ul>
<ul class=”wp-block-list”><!– wp:list-item –>
<li><strong>Asynchroniczne ładowanie</strong>: Powyższy kod zawiera atrybuty <code>async defer</code>, co oznacza, że przeglądarka ładuje skrypt FastTony w tle, nie blokując renderowania strony. Jest to najlepsza praktyka – jeśli dodajesz jakiekolwiek własne wywołania <code>fbq(...);</code> bezpośrednio w <code><;head>;</code>, umieść je <strong>za</strong> tym skryptem lub w <code>async</code> do niego. Sam skrypt FastTony jest hostowany zewnętrznie – nie modyfikuj go, gdyż ewentualne zmiany mogłyby zakłócić jego asynchroniczne działanie​.</li>
<!– /wp:list-item –></ul>
<ul class=”wp-block-list”><!– wp:list-item –>
<li><strong>Lokalizacja kodu</strong>: Trzymaj kod piksela wysoko w sekcji <code><;head>;</code> (najlepiej zaraz po znacznikach meta). Im wcześniej na stronie zostanie wywołany, tym większa szansa, że zdąży zarejestrować odwiedziny nawet użytkowników z bardzo krótką sesją. Facebook zaleca umieszczanie pixelu w <code><;head>;</code> właśnie z tego względu – dzięki temu nawet jeśli użytkownik szybko opuści stronę, zdarzenie PageView zostanie wysłane.</li>
<!– /wp:list-item –></ul>
<ul class=”wp-block-list”><!– wp:list-item –>
<li><strong>Zaawansowane dopasowanie i CAPI</strong>: Rozważ włączenie tzw. <em>Advanced Matching</em> oraz <em>Conversions API</em> dla pełni danych. Advanced Matching to mechanizm dopasowujący użytkowników na podstawie np. adresu e-mail lub numeru telefonu (jeśli te dane zbierasz – np. w trakcie zakupu). Conversion API (CAPI) wysyła zdarzenia z serwera, omijając przeglądarkę. FastTony Pixel może oferować integrację z CAPI (warto to sprawdzić w dokumentacji FastTony – nazwa “Pixel i API” sugeruje, że może on łączyć działanie piksela i API konwersji). Jeśli tak, <strong>skonfiguruj token dostępu</strong> i włącz CAPI według instrukcji FastTony, aby zwiększyć odporność śledzenia na blokady (np. ITP, adblock). W przypadku np. wtyczki PixelYourSite opcje te na WordPressie włącza się jednym kliknięciem​. Sprawdź, czy FastTony Pixel automatycznie tego nie obsługuje – jeśli nie, skontaktuj się z supportem FastTony w celu instrukcji integracji CAPI.</li>
<!– /wp:list-item –></ul>
<ul class=”wp-block-list”><!– wp:list-item –>
<li><strong>Testuj wpływ na wydajność</strong>: Piksel Facebooka nie powinien znacząco obciążać strony, ale monitoruj ogólny czas ładowania. Narzędzia jak Chrome DevTools (zakładka <em>Network</em>) czy PageSpeed Insights pokażą, czy skrypt piksela nie wydłuża czasu ładowania. Dzięki async/defer wpływ powinien być minimalny​, ale jeśli zauważysz spowolnienie, upewnij się, że nie ma konfliktów z innymi skryptami.</li>
<!– /wp:list-item –></ul>
<ul class=”wp-block-list”><!– wp:list-item –>
<li><strong>Aktualizacje i zmiany</strong>: Jeśli z czasem zmienisz motyw, szablon lub platformę, pamiętaj o ponownej instalacji kodu FastTony Pixel w nowym środowisku (kod nie przeniesie się automatycznie). Również, gdy FastTony wyda aktualizacje lub nowe zalecenia implementacyjne, dostosuj swój kod (np. zmiana adresu skryptu czy dodanie dodatkowych parametrów) – bądź na bieżąco z komunikatami od FastTony.</li>
<!– /wp:list-item –></ul>
<p>Na koniec, upewnij się, że <strong>dane z piksela zbierają się prawidłowo w Menedżerze Reklam Facebooka</strong>. Dobrze skonfigurowany FastTony Pixel w <code><;head>;</code> z pełnym zestawem zdarzeń pozwoli Ci precyzyjnie śledzić konwersje i budować grupy odbiorców, bez konfliktów z innymi skryptami. Powodzenia w implementacji!</p>