TikTok Pixel Tracking Pro moduł dla PrestaShop

Cechy i zalety modułu TikTok Pixel dla PrestaShop

• Wdrożenie TikTok Pixel z panelu PrestaShop: wystarczy podać TikTok Pixel ID w konfiguracji modułu; nie trzeba ręcznie wklejać kodu Pixela do plików motywu.
• Obsługa ścieżki zakupowej: moduł rejestruje zdarzenia ViewContent, Search, AddToCart, InitiateCheckout, AddPaymentInfo, Purchase i CompleteRegistration w miejscach, w których są dostępne odpowiadające im dane sklepu.
• Kontrola nad zdarzeniem zakupu: Purchase jest kolejkowane po przejściu zamówienia do statusu oznaczonego przez PrestaShop jako opłacony, a nie przy samym rozpoczęciu płatności.
• Ochrona jakości danych koszyka: AddToCart jest wysyłane po udanej aktualizacji koszyka, a dane produktu do tego zdarzenia są pobierane z bieżącego stanu serwera.
• Dopasowanie do katalogu TikTok: dla zdarzeń produktowych można wybrać ID produktu, ID produktu z kombinacją, referencję, EAN-13 albo UPC oraz zastosować wspólny prefiks identyfikatorów.
• Opcjonalny TikTok Events API: moduł może przekazywać opłacone zakupy również z serwera, bez wyłączania standardowego śledzenia przez TikTok Pixel w przeglądarce.
• Wspólny identyfikator zdarzenia: przeglądarkowy i serwerowy Purchase używają tego samego deterministycznego event_id, aby obsłużyć deduplikację obu kanałów wysyłki.
• Konfiguracja per sklep: w multistore każdy sklep może mieć własny Pixel ID, token Events API, typ identyfikatora produktu, prefiks i ustawienia zgody.

Najważniejsze funkcjonalności

• Uruchomienie Pixela i wywołanie page: po spełnieniu warunków konfiguracji oraz zgody moduł ładuje bibliotekę TikTok Pixel i wywołuje page.
• ViewContent na stronie produktu: zdarzenie zawiera wybrany identyfikator produktu, cenę, walutę, ilość i dane pozycji przygotowane z aktualnego produktu.
• Search na stronie wyszukiwania: dla niepustej frazy moduł przekazuje zapytanie wyszukiwarki do zdarzenia Search.
• AddToCart po potwierdzeniu zmiany koszyka: skrypt reaguje na udaną aktualizację koszyka PrestaShop i pobiera dane zdarzenia przez chroniony endpoint modułu.
• InitiateCheckout i AddPaymentInfo: moduł tworzy InitiateCheckout na obsługiwanych stronach checkoutu, a AddPaymentInfo po zmianie standardowego wyboru metody płatności.
• CompleteRegistration: po utworzeniu konta moduł kolejkuje zdarzenie rejestracji i przekazuje je przy kolejnej obsługiwanej stronie klienta.
• Purchase na stronie potwierdzenia: moduł korzysta z danych opłaconego zamówienia, w tym pozycji, wartości i waluty, oraz przypisuje zdarzeniu deterministyczny event_id.
• Endpoint CRON dla Events API: gdy Events API jest skonfigurowane, moduł udostępnia chroniony tokenem adres do ponawiania krótkotrwałych błędów dostawy serwerowego Purchase.

Zgoda marketingowa i Advanced Matching

• Opcjonalna bramka zgody: po włączeniu wymogu zgody marketingowej Pixel nie jest ładowany, dopóki integracja używanego menedżera zgód nie wywoła udostępnionej funkcji lub zdarzenia JavaScript modułu albo nie zostanie rozpoznana decyzja PD Cookie Pro.
• Integracja z PD Cookie Pro: moduł rozpoznaje podpisaną decyzję z aktywnego PD Cookie Pro w wersji 1.1.1 lub nowszej. Zgoda „all” udziela modułowi zgody na śledzenie i Advanced Matching, przy czym sama funkcja Advanced Matching nadal wymaga włączenia w konfiguracji; własne grupy wymagają wartości ad_storage dla śledzenia oraz ad_storage i ad_user_data dla Advanced Matching.
• Advanced Matching domyślnie wyłączony: po jego włączeniu i uzyskaniu zgody marketingowej moduł może przekazać prawidłowy adres e-mail oraz numer telefonu zapisany przy adresie dostawy tego zalogowanego klienta, jeśli numer ma już format E.164.
• Dane w Events API: w serwerowym Purchase e-mail i telefon są normalizowane oraz haszowane SHA-256 wyłącznie wtedy, gdy Advanced Matching jest włączony i zapisano zgodę marketingową.
• Zakres techniczny: moduł pomaga sterować działaniem Pixela zgodnie ze stanem zgody, ale nie zastępuje konfiguracji banera cookies, polityki prywatności ani oceny obowiązków prawnych administratora sklepu.

TikTok Events API i niezawodność wysyłki

• Dobrowolne połączenie serwerowe: token dostępu do TikTok Events API jest opcjonalny; bez niego nadal działa śledzenie zdarzeń przez przeglądarkowy TikTok Pixel.
• Tylko opłacone Purchase: Events API nie wysyła pełnej listy zdarzeń przeglądarkowych; serwerowa wysyłka dotyczy wyłącznie opłaconego zakupu.
• Obsługa problemów transportowych: krótkotrwałe błędy mogą zostać ponowione przez CRON, natomiast odrzucone dane lub nieprawidłowe poświadczenia nie są bez końca wysyłane ponownie.
• Bezpieczne ustawienia administratora: zapis nowego tokenu Events API może wznowić dostawy zatrzymane po błędzie poświadczeń, a przełącznik pozwala usunąć token i zatrzymać wyłącznie wysyłkę serwerową.

Identyfikatory produktów i katalog TikTok

• Wybór źródła content_id: dostępne są ID produktu, ID produktu z kombinacją, referencja, EAN-13 i UPC.
• Prefiks identyfikatorów: jeden opcjonalny prefiks jest dodawany do każdego identyfikatora przekazywanego w zdarzeniach produktowych.
• Zgodność z katalogiem: wybrany identyfikator i prefiks powinny dokładnie odpowiadać wartościom użytym w katalogu produktów TikTok. Gdy dla wybranej referencji, EAN-13 lub UPC brakuje wartości, moduł pomija tę pozycję zamiast zastępować ją innym identyfikatorem.

Kompatybilność i multistore

• PrestaShop: moduł deklaruje zgodność z PrestaShop od wersji 1.7.0.0 do 9.99.99.
• Multistore: konfiguracja wymaga wybrania konkretnego sklepu, dzięki czemu ustawienia śledzenia nie są przypadkowo współdzielone między sklepami.
• Motywy i checkout: moduł korzysta z hooków frontowych PrestaShop, obsługuje standardowy checkout oraz rozpoznaje wskazane w kodzie kontrolery one-page checkout, w tym TheCheckout, SuperCheckout i OnepageCheckout.