TikTok Pixel a Events API pro PrestaShop | PrestaDev
TikTok Pixel a Events API pro PrestaShop | PrestaDev

TikTok Pixel Tracking Pro modul pro PrestaShop

Module version: 1.3.0

PrestaShop compatibility: 1.7.x 8.x 9.x

Aktualizace souboru modulu: 2026-10-10 18:39:51

Aktualizace údajů o produktu: 2026-10-10 18:40:04


TikTok Pixel Tracking Pro je modul PrestaShop pro implementaci TikTok Pixelu v internetovém obchodě. Po uložení identifikátoru Pixelu modul načte kód TikTok a obsluhuje standardní události na stránkách produktu, vyhledávání, košíku, checkoutu a potvrzení objednávky. Zaznamenává ViewContent, Search, AddToCart, InitiateCheckout, AddPaymentInfo, Purchase a CompleteRegistration, přičemž Purchase je připraveno výhradně pro objednávku, která v PrestaShopu dosáhla stavu zaplaceno. Volitelné TikTok Events API může odesílat zaplacené nákupy ze serveru se stejným event_id, které používá událost v prohlížeči. Administrátor vybírá identifikátor produktu kompatibilní s katalogem TikTok a může také přidat prefix. Modul také umožňuje zapnout bránu marketingového souhlasu a volitelný Advanced Matching. Nastavení se ukládají samostatně pro každý obchod v prostředí multistore.

Typ licence / aktualizace
119,00 zł
96,75 złnetto
Price history:

Popis

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.

Detaily produktu

Podpora pro Prestashop 9.x
Ano
Podpora pro Prestashop 8.x
Ano
Podpora Prestashop 1.7.x
Ano
Překlady modulů
EN. EN
Podpora zdarma
Ano
Bezplatné aktualizace (1 rok)
Ano
Snadná instalace
Ano
PDTTP-FULL

Mohlo by se Vám také líbit

Changelog

Release history for this product. Expand an entry to see what changed.

  • dodano obsługę content API TIkTok-a

FAQ

Find answers to the most common questions about this product.

Modul implementuje TikTok Pixel v obchodě PrestaShop a odesílá události související s chováním zákazníka a nákupní cestou. Po nakonfigurování TikTok Pixel ID, pokud to nastavení souhlasu umožňuje, podporuje ViewContent, Search, AddToCart, InitiateCheckout, AddPaymentInfo, Purchase a CompleteRegistration. Modul nevytváří katalog produktů TikTok, reklamní kampaně ani reporty v panelu TikTok Ads Manager.

Modul načítá TikTok Pixel a vyvolává page, a také obsluhuje ViewContent na stránce produktu, Search na stránce vyhledávání, AddToCart po úspěšné aktualizaci košíku, InitiateCheckout na podporované stránce pokladny, AddPaymentInfo po změně standardního výběru platby, Purchase pro zaplacenou objednávku a CompleteRegistration po vytvoření účtu.

V konfiguraci modulu zadejte TikTok Pixel ID, vyberte typ identifikátoru produktu a případnou předponu. Můžete také zapnout Advanced Matching, požadavek na marketingový souhlas a volitelně zadat token TikTok Events API. Pixel ID by mělo pocházet z TikTok Ads Manageru; do pole se nemá vkládat kód JavaScriptu.

Ano, TikTok Events API je volitelná funkce aktivovaná po uložení přístupového tokenu. Modul odesílá přes API výhradně zaplacenou událost Purchase; ostatní standardní události jsou obsluhovány pomocí TikTok Pixelu v prohlížeči. Vypnutí nebo odstranění tokenu zastaví pouze serverové odesílání, nikoli základní fungování Pixelu.

Pokud jsou pro danou zaplacenou objednávku použity oba kanály, modul vytvoří deterministické event_id. Stejné event_id se předává do prohlížečového Purchase i do serverového Purchase odesílaného prostřednictvím TikTok Events API, což umožňuje deduplikaci obou kanálů odesílání.

Purchase je zařazen do fronty teprve tehdy, když objednávka dosáhne stavu označeného systémem PrestaShop jako zaplacená. Na stránce potvrzení může modul předat událost v prohlížeči a při nakonfigurovaném Events API ji může také odeslat ze serveru. V případě opožděného potvrzení platby stránka potvrzení provádí omezenou opětovnou kontrolu čekajícího nákupu.

Ano. Přepínač požadavku na marketingový souhlas je volitelný a ve výchozím nastavení vypnutý. Po jeho zapnutí Pixel čeká na signál předaný integrací správce souhlasů prostřednictvím poskytnuté funkce nebo události JavaScript modulu, případně na rozhodnutí aktivního PD Cookie Pro. Jedná se o technické zpracování stavu souhlasu, nikoli o samostatný systém CMP ani záruku právního souladu.

Integrace vyžaduje aktivní PD Cookie Pro ve verzi 1.1.1 nebo novější a správně podepsané rozhodnutí o souhlasu. Rozhodnutí „all“ uděluje souhlas se sledováním a Advanced Matching, přičemž Advanced Matching musí být navíc povolen v konfiguraci modulu. Při vlastním výběru skupin sledování vyžaduje hodnotu ad_storage a Advanced Matching současně ad_storage a ad_user_data.

Advanced Matching je ve výchozím nastavení vypnutý. Po jeho zapnutí a uložení marketingového souhlasu může modul pro přihlášeného zákazníka předat správnou e-mailovou adresu a telefonní číslo do prohlížečového Pixelu, ale telefon se používá pouze tehdy, pokud je uveden u doručovací adresy tohoto zákazníka a již má formát E.164. V serverovém Events API jsou e-mail a telefon normalizovány a hashovány pomocí SHA-256.

V konfiguraci vyberte jeden zdroj content_id: ID produktu, ID produktu s kombinací, referenci, EAN-13 nebo UPC. Můžete také přidat prefix. Zvolená hodnota musí přesně odpovídat identifikátoru v katalogu TikTok; pokud pro zvolenou referenci, EAN-13 nebo UPC produkt nemá hodnotu, modul tuto položku přeskočí místo toho, aby ji nahradil ID produktu.

CRON není potřeba pro prohlížečový TikTok Pixel. Když je nakonfigurováno Events API, modul zpřístupní tokenem chráněnou adresu CRON pro opakování krátkodobých chyb doručení serverové události Purchase; konfigurační panel doporučuje její spouštění každých pět minut.

Ano. Nastavení modulu se ukládá samostatně pro každý obchod, proto je v režimu multistore před konfigurací nutné vybrat konkrétní obchod. V kódu modulu je deklarována kompatibilita s PrestaShopem od verze 1.7.0.0 do 9.99.99.

Recenze (0)

Žádné recenze