Taboola Pixel + S2S Postback — Documentazione

Tracci le visite da Taboola Realize e le azioni e-commerce del suo negozio PrestaShop. Il modulo aggiunge il Pixel browser di Taboola, supporta postback server-to-server opzionali e le consente di creare eventi di conversione personalizzati per le interazioni del negozio importanti per le sue campagne.

Compatibilità

Compatibile con PrestaShop 1.6 fino a 9.0 (latest) e PHP 7.1+. Continuiamo a supportare le prossime versioni di PrestaShop.

Configurazione

1. Installi il modulo e apra Modules -> Taboola Pixel -> Configure.
2. Incolli il suo Taboola Account ID numerico da Taboola Realize.
3. Attivi Taboola Pixel.
4. Scelga quali eventi e-commerce devono essere inviati.
5. Opzionale: attivi S2S postback events se le sue campagne Taboola passano un ID clic.
6. Opzionale: aggiunga regole evento personalizzate per clic, URL, controller o eventi JavaScript.

L’Account ID deve essere numerico:

ACCOUNT_ID=1234567

Il modulo viene installato con questi nomi evento predefiniti:

product_view
collection_view
add_to_cart
start_checkout
make_purchase
search_submitted
add_to_wish_list
complete_registration

Impostazioni principali

La pagina di configurazione include queste impostazioni per il merchant:

ENABLED=1
ACCOUNT_ID=1234567
EXCLUDE_EMPLOYEES=1
RESPECT_CONSENT=1
TRACK_PAGEVIEW=1
TRACK_VIEWCONTENT=1
TRACK_VIEWCATEGORY=1
TRACK_ADDTOCART=1
TRACK_STARTCHECKOUT=1
TRACK_PURCHASE=1
TRACK_SEARCH=1
TRACK_ADDTOWISHLIST=1
TRACK_SIGNUP=1
S2S_ENABLED=0
S2S_BATCH_LIMIT=20

Valori predefiniti utili:

• Escludi dipendenti: interrompe il tracciamento front-office mentre un dipendente back-office autenticato sta navigando.
• Rispetta il consenso ai cookie: attende il consenso marketing quando mprcookiesrevolution o mprcookiebanner è attivo.
• Limite batch della coda: elabora per impostazione predefinita fino a 20 eventi S2S in coda per esecuzione. L’intervallo accettato va da 1 a 1000.

Eventi

Gli eventi browser integrati includono:

• Visualizzazione pagina: page_view
• Visualizzazione prodotto: product_view
• Visualizzazione categoria o collezione: collection_view
• Aggiunta al carrello: add_to_cart
• Avvio checkout: start_checkout
• Acquisto: make_purchase
• Ricerca: search_submitted
• Aggiunta alla lista desideri: add_to_wish_list
• Registrazione cliente: complete_registration

Il tracciamento degli acquisti usa la pagina di conferma ordine e invia, quando disponibili, valori dell’ordine come ricavi, valuta, quantità e ID ordine.

Server-To-Server Postbacks

I postback S2S sono opzionali. Il tracciamento tramite Pixel browser può funzionare anche senza di essi.

Per l’attribuzione S2S, gli URL delle landing page delle campagne Taboola devono includere uno di questi parametri ID clic:

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

Lo script front salva l’ID clic in questi cookie per l’attribuzione successiva:

mprtbpx_tblci
taboola_click_id

I postback S2S vengono inviati a Taboola tramite questo endpoint:

https://trc.taboola.com/actions-handler/log/3/s2s-action

La query del postback può includere:

click-id=TABOOLA_CLICK_ID
name=make_purchase
revenue=49.90
currency=EUR
quantity=2
orderid=1234

Il campo Test tblci accetta lettere, numeri, punti, underscore, due punti e trattini:

S2S_TEST_CLICK_ID=abc.DEF_123-456:789

Eventi personalizzati

Attivi Track custom events quando desidera inviare punti di conversione aggiuntivi, come navigazione nella galleria, pulsanti lead, clic sul localizzatore negozi o visite a landing page.

Le regole degli eventi personalizzati usano JSON. I trigger supportati sono:

click
url
controller
event

Esempio di regola clic:

[
  {
    "event": "gallery_browse",
    "trigger": "click",
    "selector": ".product-images img,.images-container img",
    "params": {
      "property": "product_gallery"
    },
    "s2s": true,
    "once": false
  }
]

Esempio di regola URL:

[
  {
    "event": "landing_page_view",
    "trigger": "url",
    "contains": ["/sale", "utm_campaign=taboola"],
    "params": {
      "property": "taboola_landing"
    },
    "s2s": true
  }
]

Esempio di regola controller:

[
  {
    "event": "contact_page_view",
    "trigger": "controller",
    "controllers": ["contact"],
    "params": {
      "property": "contact"
    },
    "s2s": true
  }
]

Esempio di regola evento JavaScript:

[
  {
    "event": "lead",
    "trigger": "event",
    "dom_event": "mprtbpx:custom",
    "params": {
      "property": "lead_form"
    },
    "s2s": true
  }
]

Un tema o un piccolo script personalizzato può quindi attivare l’evento DOM:

document.dispatchEvent(new CustomEvent('mprtbpx:custom', {
  detail: {
    params: {
      value: 1,
      currency: 'EUR'
    }
  }
}));

Per le regole clic, il modulo può anche leggere parametri dagli elementi cliccati:

<a href="/contact"
   class="taboola-lead-button"
   data-taboola-param-property="lead_button"
   data-mprtbpx-param-location="product_page">
  Contact us
</a>

Diagnostica

La pagina di configurazione mostra controlli di prontezza per:

• Taboola Account ID
• Tracciamento browser
• Nome evento acquisto
• Stato postback S2S
• Regole eventi personalizzati
• Acquisizione di tblci
• Tabella della coda

Mostra anche i conteggi della coda S2S:

pending
sending
sent
failed

Può usare Send S2S probe dopo aver aggiunto un vero tblci e Retry failed events per riportare i postback non riusciti nella coda in attesa.

Note tecniche per i proprietari del negozio

Il modulo registra questi hook PrestaShop:

displayHeader
displayOrderConfirmation
actionValidateOrder
actionCustomerAccountAdd

Un’attività pianificata elabora le conversioni Taboola in coda:

send_taboola_conversions
schedule: every:300
timeout: 30

Normalmente non è necessario modificare questi valori. Sono elencati qui affinché il suo sviluppatore o il team hosting possa confermare rapidamente che il modulo è installato e viene eseguito nei punti previsti.