Taboola Pixel + S2S Postback: configurazione e aiuto

1. Carica e installa lo ZIP in Moduli > "Module Manager", poi apri Taboola Pixel + S2S Postback > "Configure".
2. Inserisci ID account Taboola in Impostazioni Taboola Pixel.
3. Controlla gli interruttori degli eventi e allinea Nome evento acquisto e gli altri campi dei nomi evento all’account.
4. Imposta "Enable Taboola Pixel" su Sì e fai clic su Salva.
5. Concedi il consenso marketing in un browser visitatore e apri un prodotto.
6. Verifica che tfa.js venga caricato e che venga emesso l’evento di visualizzazione prodotto configurato.
7. Per gli acquisti server facoltativi, attiva "Capture purchase consent evidence" e "Enable S2S postback events". Poi effettua un ordine di prova da un clic su un annuncio Taboola (con ID clic tblci) accettando il tracciamento, e controlla che l’ordine entri nella coda e venga inviato dallo scheduler.

Apri Moduli > "Module Manager" > Taboola Pixel + S2S Postback > "Configure".

• "Enable Taboola Pixel". Interruttore principale del tracciamento nel browser; valore predefinito: 0.

• ID account Taboola. ID numerico dell’account Taboola da Realize > "Tracking"; valore predefinito: "".

• "Exclude employees". Interrompe il tracciamento mentre un dipendente connesso al back office naviga nel negozio; valore predefinito: 1.

• "Respect cookie consent". Attende il consenso marketing da mprcookiesrevolution o mprcookiebanner quando uno di questi moduli è attivo; valore predefinito: 1.

• "Track PageView". Invia l’evento standard page_view nelle pagine tracciate; valore predefinito: 1.

• "Track View Content". Invia l’evento di visualizzazione prodotto nelle pagine prodotto; valore predefinito: 1.

• "Track View Category". Invia l’evento di visualizzazione categoria o raccolta quando viene rilevata una categoria corrente; valore predefinito: 1.

• "Track Add To Cart". Invia eventi browser di aggiunta al carrello dopo aggiunte riuscite e confermate; valore predefinito: 1.

• "Track Checkout". Invia l’evento di avvio del checkout quando il modulo rileva la pagina iniziale del checkout e il carrello contiene prodotti; valore predefinito: 1.

• "Track Purchase". Invia eventi di acquisto alla conferma e alla convalida dell’ordine; valore predefinito: 1.

• "Track Search". Invia eventi di ricerca nella pagina di ricerca quando è presente un termine; valore predefinito: 1.

• "Track Add To Wishlist". Invia eventi della lista desideri dopo aggiunte riuscite e confermate; valore predefinito: 1.

• "Track Sign Up". Invia un evento di registrazione dopo la creazione di un nuovo account cliente; valore predefinito: 1.

• Nome evento acquisto. Nome evento Taboola usato per acquisti e postback S2S degli acquisti; valore predefinito: make_purchase.

• "Product view event name". Nome evento Taboola usato per le visualizzazioni prodotto; valore predefinito: product_view.

• "Collection/category view event name". Nome evento Taboola usato per le visualizzazioni categoria; valore predefinito: collection_view.

• "Add to cart event name". Nome evento Taboola usato per le aggiunte al carrello; valore predefinito: add_to_cart.

• "Start checkout event name". Nome evento Taboola usato per gli avvii del checkout; valore predefinito: start_checkout.

• "Search submitted event name". Nome evento Taboola usato per le ricerche; valore predefinito: search_submitted.

• "Wishlist event name". Nome evento Taboola usato per le aggiunte alla lista desideri; valore predefinito: add_to_wish_list.

• "Registration event name". Nome evento Taboola usato per le registrazioni di nuovi account; valore predefinito: complete_registration.

• "Track custom events". Attiva regole JSON browser personalizzate; gli eventi server inviati dal browser vengono trattenuti; valore predefinito: 0.

• Regole eventi personalizzati. Array JSON di regole evento personalizzate per trigger click, url, controller o event; valore predefinito: "".

• "Enable S2S postback events". Invia gli acquisti dal server per gli acquirenti arrivati da un clic Taboola (tblci) il cui consenso è stato registrato al checkout; valore predefinito: 0.

• "Test tblci". Valore conservato per compatibilità; la sonda attuale rifiuta l’invio; valore predefinito: "".

• "Queue batch limit". Numero massimo di eventi di conversione Taboola in coda elaborati per esecuzione, intervallo accettato da 1 a 1000; valore predefinito: 20.

• "Capture purchase consent evidence". Valore predefinito: 0. Attiva questa opzione prima di testare gli acquisti server. Registra il consenso dell’acquirente al momento dell’ordine; gli acquisti server richiedono anche un banner di consenso di cui il modulo possa leggere la scelta salvata, ad esempio Cookies Revolution.

Fai clic su Salva. Usa un ID account numerico diverso da zero, con un massimo di 32 cifre. I nomi evento devono corrispondere esattamente all’account e contenere da 1 a 100 lettere, numeri o trattini bassi. I nomi non validi non vengono riscritti automaticamente. Modifica i campi dei nomi evento integrati solo quando l’account usa il nome sostitutivo.

Il modulo di configurazione attuale espone anche queste impostazioni. Tutti gli interruttori dei segnali sono su No per impostazione predefinita. Attiva solo le azioni che intendi osservare.

Le soglie condivise sono tre visualizzazioni della galleria, un cambio variante, un clic sui dettagli, una permanenza di 45 secondi e un intervallo minimo di 1500 ms per le opzioni. I conteggi di galleria, varianti e dettagli sono limitati da 1 a 20. La permanenza è limitata da 5 a 600 secondi. L’intervallo è limitato da 250 a 60000 ms. Per esempio:

{"min_gallery_views":3,"min_variant_changes":1,"min_detail_clicks":1,"dwell_seconds":45,"option_throttle_ms":1500}

Puoi anche fornire gallery_selectors, variant_selectors e detail_selectors. Mantieni i valori predefiniti se il tuo tema non richiede selettori diversi. Questi segnali facoltativi richiedono controlli del consenso, dei criteri per i dipendenti e della titolarità del tracciamento come gli eventi commerciali.

Mantieni attive le impostazioni di consenso ed esclusione dei dipendenti durante la configurazione iniziale. Esegui il test da un normale browser visitatore non contrassegnato come dipendente. Una sessione back office connessa, una regola sul traffico interno o la rinuncia del visitatore possono impedire il tracciamento.

Il livello di consenso condiviso supporta le integrazioni di consenso MPR e adattatori CMP aggiuntivi. Deve ottenere una decisione marketing utilizzabile per la destinazione. Una decisione sconosciuta, scaduta o negativa può trattenere gli eventi. Il modulo non fornisce un banner cookie. Una vecchia preferenza di consenso non prevale su un rifiuto attuale di una CMP rilevata.

Il modulo deve essere titolare della destinazione configurata nel coordinatore di tracciamento condiviso. Una titolarità assente, ambigua o in conflitto può trattenere l’invio da browser e server. Rimuovi i tag duplicati del tema o risolvi la titolarità quando un altro modulo MPR gestisce lo stesso account.

L’invio in produzione segue anche i criteri di uscita. Un evento mostrato in demo o anteprima non viene necessariamente consegnato al tuo account pubblicitario. Gli acquisti e gli eventi dei formulari lato server vengono inviati solo con il consenso dato dall’acquirente in quel momento; un’esecuzione cron successiva non può sostituirlo.

Il modulo prepara la configurazione tramite displayHeader. Il runtime carica https://cdn.taboola.com/libtrc/unip/ACCOUNT_ID/tfa.js dopo il superamento dei controlli e invia gli eventi browser attivi. Non ottieni un normale widget nel negozio.

Le visite alle pagine usano page_view. Gli eventi di prodotto, categoria, aggiunta al carrello confermata, checkout, acquisto, ricerca, aggiunta alla lista desideri confermata e registrazione usano i nomi salvati. Gli acquisti possono includere ricavi dell’ordine, valuta, quantità, riferimento ordine e contesto prodotto. La registrazione viene contrassegnata su actionCustomerAccountAdd e consumata in una successiva richiesta idonea della sessione nativa.

Per l’attribuzione server, usa URL di destinazione della campagna contenenti un solo tblci reale, per esempio:

https://www.example.com/product-name?tblci=REAL_TABOOLA_CLICK_ID

L’acquisizione browser attuale accetta tblci; non acquisisce il vecchio alias URL taboola_click_id. Dopo il consenso e gli altri controlli, memorizza mprtbpx_tblci per 30 giorni usando il percorso cookie configurato, SameSite=Lax e Secure su HTTPS. Un rifiuto del consenso cancella i cookie di attribuzione supportati dal runtime.

Attiva "Track custom events", inserisci un array JSON in Regole eventi personalizzati e salva. Usa i nomi evento esatti dell’account con da 1 a 100 lettere, numeri o trattini bassi. Questi esempi coprono trigger di clic, URL, controller ed eventi DOM. Le regole controller possono limitare un modulo front office con modules.

[
  {
    "event": "gallery_browse",
    "trigger": "click",
    "selector": ".product-images img,.images-container img",
    "once": false
  },
  {
    "event": "landing_page_view",
    "trigger": "url",
    "contains": [
      "/sale"
    ]
  },
  {
    "event": "contact_page_view",
    "trigger": "controller",
    "controllers": [
      "contact"
    ],
    "modules": []
  },
  {
    "event": "lead",
    "trigger": "event",
    "dom_event": "mprtbpx:custom"
  }
]

Attiva la regola DOM dopo l’inizializzazione:

document.dispatchEvent(new CustomEvent('mprtbpx:custom'));

Le regole URL esaminano il percorso. I frammenti di query come utm_campaign=taboola non corrispondono al percorso. once limita i trigger di clic o DOM ripetuti nel runtime attuale.

Le regole personalizzate inviano il nome evento configurato. Non copiano attributi dati di clic né detail.params del DOM. Gli eventi personalizzati arrivano a Taboola solo dal browser: il modulo rifiuta gli eventi inviati dal browser per l’invio server, quindi s2s: true in una regola personalizzata non invia alcun postback server.

Attiva "Enable S2S postback events" e "Capture purchase consent evidence" quando il negozio ha un banner di consenso leggibile dal modulo e i visitatori arrivano con ID clic Taboola. Mantieni "Track Purchase" attivo e allinea Nome evento acquisto al tuo account Taboola.

Alla convalida dell’ordine il modulo registra consenso e ID clic dell’acquirente e aggiunge l’acquisto alla coda. Un acquisto server viene inviato solo se l’acquirente ha dato il consenso, non è un dipendente, questo modulo gestisce il tracciamento Taboola ed è stato acquisito un vero tblci. Le vecchie righe di coda inviate dal browser restano trattenute.

Quando un acquisto viene accettato nella coda del server, il modulo blocca anche il relativo evento nel browser per evitare di inviare lo stesso acquisto due volte. Se l’acquisto non può entrare nella coda del server, l’evento del browser può ancora essere inviato quando il consenso e le altre condizioni di tracciamento lo consentono.

L’attività send_taboola_conversions è registrata con pianificazione every:300. Scade ogni cinque minuti. Il runner cron MPR condiviso deve eseguire le attività in scadenza; la sola dichiarazione della pianificazione non avvia un worker. Il limite del batch limita le righe di coda per esecuzione da 1 a 1000, con valore predefinito 20.

Il modulo non dispone di un punto di avvio autonomo cron.php. Usa il pianificatore condiviso già configurato per il tuo negozio. Controlla l’esecuzione delle attività nel pianificatore e le date e lo stato della coda nella pagina di configurazione di questo modulo.

La diagnostica include controlli di prontezza, contatori di coda, righe recenti, Invia test S2S e Riprova eventi non riusciti. Risolvi la causa dell’errore prima di riprovare. Riportare le righe non riuscite in attesa non aggira i controlli attuali di consenso, criteri per i dipendenti, titolarità dell’account o destinazione.

Invia test S2S non invia nulla, perché Taboola non offre una modalità di test che tenga le conversioni di prova fuori dai rapporti. "Test tblci" resta per compatibilità e non genera una conversione di prova. Per controllare l’invio, guarda la risposta della coda per un acquisto reale da un clic Taboola.

1. Controlla configurazione richiesta, integrità, prontezza, titolarità e scheduler condiviso.
2. In un normale browser visitatore, concedi il consenso marketing e apri un prodotto. Verifica tfa.js e l’evento di visualizzazione prodotto configurato.
3. Aggiungi un prodotto al carrello con successo e conferma l’evento di aggiunta. Un semplice clic sul pulsante non è sufficiente.
4. Per S2S, attiva l’acquisizione del consenso, poi effettua un acquisto da un clic su un annuncio Taboola. Controlla il tblci originale, il consenso registrato e la riga dell’ordine in coda.
5. Lascia che lo scheduler elabori la riga. Esamina il risultato finale e l’evento nei report Taboola. Controlla che lo stesso ordine non sia stato inviato tramite entrambi i trasporti.

Se non appare alcuno script browser, controlla attivazione, ID account, consenso, marcatori dei dipendenti, titolarità, tag duplicati e blocchi del browser. Se un acquisto server viene trattenuto, controlla "Capture purchase consent evidence", il banner di consenso, l’ID clic, l’identità dell’acquirente e il motivo registrato. Se le regole personalizzate falliscono, controlla nomi esatti, selettori e corrispondenza del percorso. La vecchia funzione globale window.mprtbpxTrack non è disponibile.

Disattiva gli interruttori browser e server e salva per interrompere il tracciamento mantenendo la configurazione. Disinstalla da "Module Manager" per rimuovere impostazioni del modulo, voci di menu e attività registrate.

La disinstallazione richiama la pulizia condivisa della coda conversioni. La tabella condivisa viene mantenuta mentre un altro modulo di conversione la usa e può essere eliminata quando viene rimosso l’ultimo utilizzatore. Esporta la diagnostica necessaria prima di disinstallare. Non presumere che la disinstallazione rimuova eventi già inviati alla piattaforma pubblicitaria o cancelli tutti i dati di attribuzione nel browser.

Richiede PrestaShop 1.6 o successivo e PHP 7.1 o successivo.