Vlastnosti a výhody modulu TikTok Pixel pro PrestaShop
- Nasazení TikTok Pixel z panelu PrestaShop: stačí zadat TikTok Pixel ID v konfiguraci modulu; není nutné ručně vkládat kód Pixelu do souborů šablony.
- Podpora nákupní cesty: modul zaznamenává události ViewContent, Search, AddToCart, InitiateCheckout, AddPaymentInfo, Purchase a CompleteRegistration v místech, kde jsou k dispozici odpovídající data obchodu.
- Kontrola nad událostí nákupu: Purchase je zařazeno do fronty po přechodu objednávky do stavu označeného PrestaShopem jako zaplaceno, nikoli už při samotném zahájení platby.
- Ochrana kvality dat košíku: AddToCart se odesílá po úspěšné aktualizaci košíku a data produktu pro tuto událost se načítají z aktuálního stavu serveru.
- Přizpůsobení katalogu TikTok: pro produktové události lze vybrat ID produktu, ID produktu s kombinací, referenci, EAN-13 nebo UPC a použít společný prefix identifikátorů.
- Volitelné TikTok Events API: modul může předávat zaplacené nákupy také ze serveru, aniž by se vypínalo standardní sledování přes TikTok Pixel v prohlížeči.
- Společný identifikátor události: prohlížečové i serverové Purchase používají stejné deterministické event_id, aby byla zajištěna deduplikace obou kanálů odesílání.
- Konfigurace pro každý obchod: v multistore může mít každý obchod vlastní Pixel ID, token Events API, typ identifikátoru produktu, prefix a nastavení souhlasu.
Nejdůležitější funkce
- Spuštění Pixelu a volání page: po splnění podmínek konfigurace a souhlasu modul načte knihovnu TikTok Pixel a zavolá page.
- ViewContent na stránce produktu: událost obsahuje vybraný identifikátor produktu, cenu, měnu, množství a data položky připravená z aktuálního produktu.
- Search na stránce vyhledávání: pro neprázdnou frázi modul předává dotaz vyhledávání do události Search.
- AddToCart po potvrzení změny košíku: skript reaguje na úspěšnou aktualizaci košíku v PrestaShopu a načítá data události přes chráněný endpoint modulu.
- InitiateCheckout a AddPaymentInfo: modul vytváří InitiateCheckout na podporovaných stránkách checkoutu a AddPaymentInfo po změně standardního výběru platební metody.
- CompleteRegistration: po vytvoření účtu modul zařadí registrační událost do fronty a předá ji na další podporované stránce zákazníka.
- Purchase na stránce potvrzení: modul používá data zaplacené objednávky, včetně položek, hodnoty a měny, a přiřazuje události deterministické event_id.
- CRON endpoint pro Events API: když je Events API nakonfigurováno, modul zpřístupní tokenem chráněnou adresu pro opakování krátkodobých chyb doručení serverového Purchase.
Marketingový souhlas a Advanced Matching
- Volitelná brána souhlasu: po zapnutí požadavku na marketingový souhlas se Pixel nenačte, dokud integrace používaného správce souhlasů nevyvolá poskytnutou funkci nebo JavaScriptovou událost modulu anebo není rozpoznáno rozhodnutí PD Cookie Pro.
- Integrace s PD Cookie Pro: modul rozpoznává podepsané rozhodnutí z aktivního PD Cookie Pro ve verzi 1.1.1 nebo novější. Souhlas „all“ uděluje modulu souhlas se sledováním a Advanced Matching, přičemž samotná funkce Advanced Matching stále vyžaduje zapnutí v konfiguraci; vlastní skupiny vyžadují hodnotu ad_storage pro sledování a ad_storage a ad_user_data pro Advanced Matching.
- Advanced Matching ve výchozím nastavení vypnutý: po jeho zapnutí a získání marketingového souhlasu může modul předat platnou e-mailovou adresu a telefonní číslo uložené u doručovací adresy tohoto přihlášeného zákazníka, pokud už má číslo formát E.164.
- Data v Events API: při serverovém Purchase jsou e-mail a telefon normalizovány a hashovány pomocí SHA-256 výhradně tehdy, když je Advanced Matching zapnutý a byl uložen marketingový souhlas.
- Technický rozsah: modul pomáhá řídit fungování Pixelu podle stavu souhlasu, ale nenahrazuje konfiguraci cookie banneru, zásady ochrany osobních údajů ani posouzení právních povinností správce obchodu.
TikTok Events API a spolehlivost odesílání
- Dobrovolné serverové připojení: přístupový token k TikTok Events API je volitelný; bez něj stále funguje sledování událostí přes prohlížečový TikTok Pixel.
- Pouze zaplacené Purchase: Events API neodesílá úplný seznam prohlížečových událostí; serverové odesílání se týká výhradně zaplaceného nákupu.
- Řešení problémů s přenosem: krátkodobé chyby lze opakovat přes CRON, zatímco odmítnutá data nebo neplatné přihlašovací údaje se znovu neposílají donekonečna.
- Bezpečné nastavení administrátora: uložení nového tokenu Events API může obnovit doručování zastavené po chybě přihlašovacích údajů a přepínač umožňuje odstranit token a zastavit pouze serverové odesílání.
Identifikátory produktů a katalog TikTok
- Výběr zdroje content_id: k dispozici jsou ID produktu, ID produktu s kombinací, reference, EAN-13 a UPC.
- Prefix identifikátorů: jeden volitelný prefix se přidává ke každému identifikátoru předávanému v produktových událostech.
- Shoda s katalogem: vybraný identifikátor a prefix by měly přesně odpovídat hodnotám použitým v katalogu produktů TikTok. Pokud u vybrané reference, EAN-13 nebo UPC chybí hodnota, modul tuto položku vynechá místo toho, aby ji nahradil jiným identifikátorem.
Kompatibilita a multistore
- PrestaShop: modul deklaruje kompatibilitu s PrestaShopem od verze 1.7.0.0 do 9.99.99.
- Multistore: konfigurace vyžaduje výběr konkrétního obchodu, takže nastavení sledování nejsou omylem sdílena mezi obchody.
- Šablony a checkout: modul využívá frontendové hooky PrestaShopu, podporuje standardní checkout a rozpoznává controllery one-page checkoutu uvedené v kódu, včetně TheCheckout, SuperCheckout a OnepageCheckout.