Caratteristiche e vantaggi del modulo TikTok Pixel per PrestaShop
- Implementazione di TikTok Pixel dal pannello PrestaShop: è sufficiente inserire il TikTok Pixel ID nella configurazione del modulo; non è necessario incollare manualmente il codice del Pixel nei file del tema.
- Supporto del percorso di acquisto: il modulo registra gli eventi ViewContent, Search, AddToCart, InitiateCheckout, AddPaymentInfo, Purchase e CompleteRegistration nei punti in cui sono disponibili i dati del negozio corrispondenti.
- Controllo sull’evento di acquisto: Purchase viene messo in coda dopo che l’ordine passa allo stato contrassegnato da PrestaShop come pagato, e non al semplice avvio del pagamento.
- Tutela della qualità dei dati del carrello: AddToCart viene inviato dopo l’aggiornamento riuscito del carrello, e i dati del prodotto per questo evento vengono prelevati dallo stato corrente del server.
- Adattamento al catalogo TikTok: per gli eventi di prodotto è possibile scegliere l’ID prodotto, l’ID prodotto con combinazione, il riferimento, l’EAN-13 oppure l’UPC e applicare un prefisso comune agli identificatori.
- TikTok Events API opzionale: il modulo può trasmettere anche gli acquisti pagati dal server, senza disattivare il tracciamento standard tramite TikTok Pixel nel browser.
- Identificatore evento condiviso: il Purchase lato browser e lato server utilizzano lo stesso event_id deterministico per gestire la deduplicazione di entrambi i canali di invio.
- Configurazione per negozio: in multistore ogni negozio può avere il proprio Pixel ID, token Events API, tipo di identificatore prodotto, prefisso e impostazioni di consenso.
Funzionalità principali
- Avvio del Pixel e chiamata page: dopo il soddisfacimento delle condizioni di configurazione e di consenso, il modulo carica la libreria TikTok Pixel e richiama page.
- ViewContent nella pagina prodotto: l’evento contiene l’identificatore prodotto selezionato, il prezzo, la valuta, la quantità e i dati dell’articolo preparati a partire dal prodotto corrente.
- Search nella pagina di ricerca: per una query non vuota il modulo trasmette la richiesta del motore di ricerca all’evento Search.
- AddToCart dopo la conferma della modifica del carrello: lo script reagisce a un aggiornamento riuscito del carrello PrestaShop e recupera i dati dell’evento tramite l’endpoint protetto del modulo.
- InitiateCheckout e AddPaymentInfo: il modulo crea InitiateCheckout nelle pagine di checkout supportate, e AddPaymentInfo dopo la modifica della selezione standard del metodo di pagamento.
- CompleteRegistration: dopo la creazione dell’account il modulo mette in coda l’evento di registrazione e lo trasmette alla successiva pagina cliente supportata.
- Purchase nella pagina di conferma: il modulo utilizza i dati dell’ordine pagato, inclusi articoli, valore e valuta, e assegna all’evento un event_id deterministico.
- Endpoint CRON per Events API: quando Events API è configurata, il modulo mette a disposizione un indirizzo protetto da token per ritentare gli errori temporanei di consegna del Purchase lato server.
Consenso marketing e Advanced Matching
- Gate di consenso opzionale: dopo l’attivazione del requisito di consenso marketing, il Pixel non viene caricato finché l’integrazione del gestore di consensi utilizzato non richiama la funzione o l’evento JavaScript del modulo messi a disposizione, oppure finché non viene riconosciuta la decisione di PD Cookie Pro.
- Integrazione con PD Cookie Pro: il modulo riconosce la decisione firmata di PD Cookie Pro attivo nella versione 1.1.1 o successiva. Il consenso “all” concede al modulo il consenso al tracciamento e ad Advanced Matching, fermo restando che la stessa funzione Advanced Matching richiede comunque l’attivazione nella configurazione; i gruppi personalizzati richiedono il valore ad_storage per il tracciamento e ad_storage e ad_user_data per Advanced Matching.
- Advanced Matching disattivato per impostazione predefinita: dopo la sua attivazione e l’ottenimento del consenso marketing, il modulo può trasmettere l’indirizzo e-mail corretto e il numero di telefono salvato nell’indirizzo di consegna di questo cliente connesso, se il numero è già nel formato E.164.
- Dati in Events API: nel Purchase lato server l’e-mail e il telefono vengono normalizzati e sottoposti ad hashing SHA-256 esclusivamente quando Advanced Matching è attivato e il consenso marketing è stato registrato.
- Ambito tecnico: il modulo aiuta a controllare il funzionamento del Pixel in base allo stato del consenso, ma non sostituisce la configurazione del banner cookie, dell’informativa sulla privacy né la valutazione degli obblighi legali dell’amministratore del negozio.
TikTok Events API e affidabilità dell’invio
- Connessione server volontaria: il token di accesso a TikTok Events API è opzionale; senza di esso continua a funzionare il tracciamento degli eventi tramite TikTok Pixel lato browser.
- Solo Purchase pagati: Events API non invia l’elenco completo degli eventi del browser; l’invio lato server riguarda esclusivamente l’acquisto pagato.
- Gestione dei problemi di trasporto: gli errori temporanei possono essere ritentati tramite CRON, mentre i dati rifiutati o le credenziali non valide non vengono reinviati all’infinito.
- Impostazioni amministratore sicure: il salvataggio di un nuovo token Events API può riprendere le consegne interrotte dopo un errore di credenziali, e l’interruttore consente di rimuovere il token e fermare esclusivamente l’invio lato server.
Identificatori prodotto e catalogo TikTok
- Scelta della fonte di content_id: sono disponibili ID prodotto, ID prodotto con combinazione, riferimento, EAN-13 e UPC.
- Prefisso degli identificatori: un unico prefisso opzionale viene aggiunto a ogni identificatore trasmesso negli eventi di prodotto.
- Compatibilità con il catalogo: l’identificatore e il prefisso selezionati devono corrispondere esattamente ai valori utilizzati nel catalogo prodotti TikTok. Quando manca il valore per il riferimento, l’EAN-13 o l’UPC selezionato, il modulo omette quell’articolo invece di sostituirlo con un altro identificatore.
Compatibilità e multistore
- PrestaShop: il modulo dichiara la compatibilità con PrestaShop dalla versione 1.7.0.0 alla 9.99.99.
- Multistore: la configurazione richiede la selezione di un negozio specifico, così le impostazioni di tracciamento non vengono condivise accidentalmente tra i negozi.
- Temi e checkout: il modulo utilizza gli hook frontend di PrestaShop, supporta il checkout standard e riconosce i controller one-page checkout indicati nel codice, tra cui TheCheckout, SuperCheckout e OnepageCheckout.