Outbrain Pixel + S2S Postback — Guida alla configurazione

Outbrain Pixel + S2S Postback aggiunge il tracciamento delle conversioni Outbrain al tuo negozio PrestaShop, con eventi Pixel nel browser e postback server-to-server opzionali. Il modulo ti aiuta a inviare a Outbrain segnali e-commerce e lead, mantenendo selezione degli eventi, gestione del consenso e diagnostica nel back office.

Funzionalità

Outbrain Pixel nel browser. Il modulo inserisce Outbrain Pixel da displayHeader e carica https://amplify.outbrain.com/cp/obtp.js quando il tracciamento è attivo.
Tracciamento degli eventi e-commerce. Può inviare gli eventi PageView, View Content, View Category, Add To Cart, Checkout, Purchase, Search, Add To Wishlist e Sign Up.
Evento di acquisto alla conferma dell’ordine. L’hook displayOrderConfirmation invia l’evento di acquisto nel browser con valore dell’ordine, valuta, ID ordine e dati dei prodotti.
Postback server-to-server. Le conversioni idonee possono essere messe in coda e inviate a Outbrain tramite https://tr.outbrain.com/unifiedPixel quando è disponibile un ID clic Outbrain.
Acquisizione dell’ID clic. Lo script front legge ob_click_id, OutbrainClickId, outbrain_click_id e dicbo dagli URL di atterraggio e salva il valore nel cookie mproutbr_ob_click_id.
Regole di conversione personalizzate. Puoi definire regole JSON per conversioni basate su clic, URL, controller o eventi DOM. Le regole controller possono essere opzionalmente limitate a specifici front controller del modulo.
Bridge di conversione front. Il front controller conversion riceve eventi bridge del browser protetti da token per l’inserimento nella coda S2S.
Tracciamento delle registrazioni. L’hook actionCustomerAccountAdd contrassegna i nuovi account cliente, così la pagina account successiva può inviare l’evento Sign Up.
Caricamento consapevole del consenso. Quando mprcookiesrevolution o mprcookiebanner è attivo, il Pixel attende il consenso marketing prima di avviarsi.
Diagnostica e controlli della coda. La pagina del back office mostra controlli di prontezza, conteggi della coda per eventi in attesa/in invio/inviati/falliti, un’azione di prova S2S e un’azione di retry per gli eventi falliti.
Elaborazione cron. Il worker della coda registra send_outbrain_conversions con schedule: every:300 e timeout: 30.

Outbrain Pixel + S2S Postback — Outbrain storefront pixel

Outbrain Pixel + S2S Postback — Admin integrity checks

Opzioni di configurazione

Imposta questi valori in Modules > Outbrain Pixel + S2S Postback > Configure.

Abilita Outbrain Pixel. Attiva o disattiva il tracciamento nel browser; predefinito: 0.
Outbrain Marketer ID. Salva il tuo Outbrain Marketer ID numerico; predefinito: ``. Più ID possono essere separati da virgole.
Escludi dipendenti. Blocca il tracciamento quando un dipendente connesso al back office naviga nel front office; predefinito: 1.
Rispetta il consenso ai cookie. Attende il consenso marketing da mprcookiesrevolution o mprcookiebanner quando uno dei due moduli è attivo; predefinito: 1.
Traccia PageView. Invia l’evento Outbrain PAGE_VIEW dall’header della pagina; predefinito: 1.
Traccia View Content. Invia eventi di visualizzazione prodotto nelle pagine prodotto; predefinito: 1.
Traccia View Category. Invia eventi di visualizzazione categoria quando viene rilevata una categoria corrente; predefinito: 1.
Traccia Add To Cart. Invia eventi di aggiunta al carrello dal bus eventi PrestaShop o dai pulsanti di aggiunta al carrello supportati; predefinito: 1.
Traccia Checkout. Invia eventi di avvio checkout quando il modulo rileva la pagina iniziale del checkout con prodotti nel carrello; predefinito: 1.
Traccia Purchase. Invia eventi di acquisto alla conferma dell’ordine e può mettere in coda postback di acquisto per S2S; predefinito: 1.
Traccia Search. Invia eventi di ricerca sul controller di ricerca quando s o search_query è presente; predefinito: 1.
Traccia Add To Wishlist. Invia eventi wishlist dai pulsanti wishlist supportati e dal bus eventi wishlist di PrestaShop; predefinito: 1.
Traccia Sign Up. Invia un evento Sign Up dopo la creazione dell’account cliente; predefinito: 1.
Nome evento Purchase. Controlla il nome evento Outbrain usato per gli acquisti; predefinito: Purchase.
Traccia eventi personalizzati. Abilita le regole di conversione personalizzate definite in JSON; predefinito: 0.
Regole eventi personalizzati. Salva l’array JSON per regole personalizzate basate su clic, URL, controller o eventi DOM; predefinito: ``.
Abilita eventi postback S2S. Mette in coda lato server gli eventi di conversione idonei quando è disponibile un ID clic Outbrain; predefinito: 0.
Test ob_click_id. Salva un vero ID clic Outbrain usato solo dalla prova S2S amministrativa; predefinito: ``.
Mantieni IP e user agent nei metadati in coda. Conserva i metadati IP e user-agent nella coda conversioni condivisa per la diagnostica; predefinito: 1.
Limite batch della coda. Imposta quanti eventi di conversione in coda vengono gestiti dal processore cron a ogni esecuzione; predefinito: 20. Intervallo consentito: 1-1000.

Outbrain Pixel + S2S Postback — Outbrain product events

Outbrain Pixel + S2S Postback — Storefront pixel rendered

Esempi di personalizzazione

URL di atterraggio della campagna con acquisizione dell’ID clic Outbrain:

https://www.example.com/product.html?ob_click_id={{ob_click_id}}

Più Marketer IDs possono essere inseriti così:

123456, 789012

Regola evento personalizzato basata su clic per l’interazione con la galleria prodotto:

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

Pulsante lead con parametri Outbrain aggiuntivi letti dagli attributi HTML:

<a
  href="/contact"
  class="js-outbrain-lead"
  data-outbrain-param-property="contact_cta"
  data-outbrain-param-placement="product_page"
>
  Contact us
</a>

Regola corrispondente per quel pulsante:

[
  {
    "event": "Lead",
    "trigger": "click",
    "selector": ".js-outbrain-lead",
    "s2s": true
  }
]

Evento lead basato su URL per la pagina contatti:

[
  {
    "event": "Lead",
    "trigger": "url",
    "contains": ["/contact"],
    "params": {
      "property": "contact_page"
    },
    "s2s": true
  }
]

Regola basata su controller, con corrispondenza modulo opzionale per i front controller del modulo:

[
  {
    "event": "Lead",
    "trigger": "controller",
    "controllers": ["contact"],
    "modules": [],
    "params": {
      "property": "contact_controller"
    },
    "once": true,
    "s2s": true
  }
]

Regola evento DOM per un modulo personalizzato o uno script del tema:

[
  {
    "event": "Lead",
    "trigger": "event",
    "dom_event": "mproutbr:lead",
    "params": {
      "property": "custom_form"
    },
    "s2s": true
  }
]

JavaScript del tema che attiva l’evento DOM:

document.dispatchEvent(new CustomEvent('mproutbr:lead', {
  detail: {
    params: {
      placement: 'footer_form',
      value: 1
    }
  }
}));

Chiamata diretta al tracciamento nel browser dopo l’avvio del modulo:

if (typeof window.mproutbrTrack === 'function') {
  window.mproutbrTrack('Lead', {
    property: 'custom_cta',
    event_source_url: window.location.href
  }, true);
}

Outbrain Pixel + S2S Postback — Outbrain s2s diagnostics

Outbrain Pixel + S2S Postback — Storefront purchase event

Installazione

Scarica lo ZIP del modulo dal tuo account mypresta.rocks.
Nel back office PrestaShop, vai su Modules > Module Manager.
Fai clic su Upload a module e seleziona il file ZIP.
Dopo l’installazione, apri Modules > Outbrain Pixel + S2S Postback > Configure.
Salva i valori richiesti, poi usa il pannello diagnostico per confermare lo stato del Pixel, la disponibilità dell’ID clic e lo stato della coda.
Se usi postback S2S, aggiungi un parametro ID clic Outbrain agli URL delle campagne e testa con Send S2S probe usando un vero ob_click_id.

Outbrain Pixel + S2S Postback — Admin config credentials

Come funziona

Nel front office, gli acquirenti non vedono widget o banner generati da questo modulo. Quando il tracciamento è attivo, il modulo carica Outbrain Pixel nell’header della pagina, invia gli eventi browser selezionati e acquisisce gli ID clic Outbrain dagli URL di atterraggio delle campagne.

Per acquisti ed eventi personalizzati idonei, il modulo può anche mettere in coda postback lato server. Il task cron elabora la coda in batch e il pannello diagnostico mostra se gli eventi sono in attesa, in invio, inviati o falliti.

Outbrain Pixel + S2S Postback — Admin config events

Limiti dichiarati

L’attribuzione S2S richiede un vero ID clic Outbrain nella visita; il tracciamento Pixel nel browser può funzionare senza, ma i postback senza ID clic non vengono messi in coda.
PageView in questo modulo è solo lato browser e non viene inviato tramite il bridge S2S.
La prova S2S richiede un vero ob_click_id proveniente da un clic su un annuncio Outbrain, non un valore di test inventato.
L’attesa del consenso si applica solo quando mprcookiesrevolution o mprcookiebanner è attivo e il cookie/evento di consenso è disponibile.
Il tracciamento Add To Cart e Add To Wishlist supporta bus eventi e selettori PrestaShop comuni; temi personalizzati insoliti potrebbero richiedere una regola evento personalizzata.
Configurazione delle campagne Outbrain, nomi delle conversioni e reportistica dentro Outbrain restano gestiti nel tuo account Outbrain.

Compatibilità: da PrestaShop 1.6 a 9.0 (ultima versione), PHP 7.1+. Continuiamo a supportare le prossime versioni di PrestaShop.