Outbrain Pixel + S2S Postback: configurazione e aiuto

1. Carica e installa lo ZIP in Moduli > "Module Manager", poi apri Outbrain Pixel + S2S Postback > "Configure".
2. Inserisci Marketer ID Outbrain, separando più ID con virgole se necessario.
3. Controlla gli interruttori di tracciamento eventi e Nome evento acquisto.
4. Imposta "Enable Outbrain Pixel" su Sì e fai clic su Salva.
5. Concedi il consenso marketing da un normale browser visitatore e apri un prodotto.
6. Verifica che obtp.js venga caricato e che venga emesso l’evento browser "View Content".
7. Se usi S2S, controlla prima che i visitatori arrivino con ID clic Outbrain e che il consenso dell’acquirente venga registrato, poi attiva "Enable S2S postback events" e cerca un acquisto reale nella coda e nei report Outbrain.

Configura queste opzioni in Moduli > Outbrain Pixel + S2S Postback > "Configure".

• "Enable Outbrain Pixel". Attiva o disattiva il tracciamento nel browser; valore predefinito: 0.

• Marketer ID Outbrain. Memorizza un Marketer ID alfanumerico da 10 a 50 caratteri o un ID decimale esistente con un massimo di 32 cifre; valore predefinito: empty. Puoi separare più ID con virgole.

• "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 Outbrain PAGE_VIEW dall’intestazione della pagina; valore predefinito: 1.

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

• "Track View Category". Invia eventi di visualizzazione categoria 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 dell’ordine e può accodare postback di acquisto S2S; valore predefinito: 1.

• "Track Search". Invia eventi di ricerca nel controller di ricerca quando è presente s o search_query; 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. Controlla il nome evento Outbrain usato per gli acquisti; valore predefinito: Purchase.

• "Track custom events". Attiva regole di conversione personalizzate definite in JSON; valore predefinito: 0.

• Regole eventi personalizzati. Memorizza l’array JSON per regole personalizzate di clic, URL, controller o eventi DOM; valore predefinito: empty.

• "Enable S2S postback events". Accoda gli eventi di conversione idonei lato server quando è disponibile un ID clic Outbrain; valore predefinito: 0.

• "S2s Test Click Id". Campo conservato per compatibilità; valore predefinito: vuoto. La sonda di acquisto in produzione è disattivata.

• "Legacy IP/user-agent preference". Valore predefinito: 1. Preferenza conservata per compatibilità. Indirizzi IP e user-agent non vengono accodati né inviati.

• "Queue batch limit". Imposta quanti eventi di conversione in coda il processore cron gestisce per esecuzione; valore predefinito: 20. Intervallo consentito: 1-1000.

• "Persist marketing consent withdrawals". Valore predefinito: 0. Registra le revoche del consenso marketing affinché gli eventi in coda le rispettino.

Fai clic su Salva. Nome evento acquisto ha come valore predefinito Purchase. Allinea i nomi all’account Outbrain. Il modulo mantiene configurazione delle campagne e report in quell’account esterno.

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. La consegna degli eventi demo e di anteprima al tuo account pubblicitario dipende da questi criteri. Gli acquisti e gli eventi dei moduli lato server vengono inviati solo con il consenso dato dall’acquirente in quel momento; un’esecuzione cron successiva non può sostituirlo.

Quando consentito, il modulo carica https://amplify.outbrain.com/cp/obtp.js. Il modulo non aggiunge un normale widget visibile ai clienti. Invia gli eventi browser attivi di pagina, prodotto, categoria, aggiunta al carrello confermata, checkout, acquisto, ricerca, aggiunta alla lista desideri confermata, registrazione ed eventi personalizzati configurati con il contesto prodotto e ordine disponibile.

Le visite alle pagine usano PAGE_VIEW. Gli altri nomi integrati sono View Content, View Category, Add To Cart, Checkout, il nome acquisto configurato, Search, Add To Wishlist e Sign Up. Il contesto di acquisto include valore ordine, valuta, riferimento e articoli, se disponibili.

Puoi inserire più Marketer ID separati da virgole, per esempio 123456, 789012. Ogni destinazione ha i propri controlli di titolarità del tracciamento.

Il runtime accetta ob_click_id, OutbrainClickId, outbrain_click_id e dicbo dagli URL di destinazione e memorizza un valore valido in mproutbr_ob_click_id per 90 giorni dopo i controlli di autorizzazione. Usa la sostituzione effettiva del clic della tua campagna, per esempio:

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

Il tracciamento browser può funzionare senza attribuzione dei clic. I postback server la richiedono. PageView rimane solo nel browser.

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, spazi o trattini. I trattini bassi non sono accettati nei nomi personalizzati. 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,
    "s2s": false,
    "params": {
      "property": "custom_interaction"
    }
  },
  {
    "event": "Landing Page View",
    "trigger": "url",
    "contains": [
      "/sale"
    ],
    "s2s": false,
    "params": {
      "property": "custom_interaction"
    }
  },
  {
    "event": "Contact Page View",
    "trigger": "controller",
    "controllers": [
      "contact"
    ],
    "modules": [],
    "s2s": false,
    "params": {
      "property": "custom_interaction"
    }
  },
  {
    "event": "Lead",
    "trigger": "event",
    "dom_event": "mproutbr:lead",
    "s2s": false,
    "params": {
      "property": "custom_interaction"
    }
  }
]

Attiva la regola DOM dopo l’inizializzazione:

document.dispatchEvent(new CustomEvent('mproutbr:lead'));

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

Gli esempi impostano s2s su false per tracciare le interazioni solo nel browser. Il bridge front office può accodare eventi idonei solo con una ricevuta di occorrenza emessa dal server, legata alla sessione nativa dell’acquirente e all’autorizzazione attuale. Un token o semplici dati prodotto arbitrari inviati non sono sufficienti.

Mantieni i parametri statici supportati in params. Il codice attuale dei trigger non unisce valori arbitrari data-outbrain-param-* o detail.params del DOM. Non è esposto alcun helper window.mproutbrTrack.

Attiva "Enable S2S postback events" solo quando gli ID clic Outbrain e il consenso degli acquirenti vengono registrati. Alla convalida dell’ordine il modulo registra questi dati e mette l’acquisto in coda per il server. Il postback va a https://tr.outbrain.com/unifiedPixel con i valori di attribuzione ed evento consentiti. Non inoltra l’indirizzo IP né lo user agent.

Outbrain non può deduplicare un acquisto inviato sia dal browser sia dal server, quindi il modulo usa un solo canale per acquisto. Con S2S attivo, la pagina di conferma ordine non invia alcun acquisto browser e mette in coda solo il postback server; un acquisto senza ID clic o consenso registrato quindi non viene inviato affatto. Con S2S disattivato, l’acquisto viene inviato dal browser nella pagina di conferma ordine.

L’attività send_outbrain_conversions è registrata con pianificazione every:300. Diventa eseguibile 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.

Usa lo scheduler condiviso configurato per il tuo negozio; il modulo non ha un punto di ingresso cron.php autonomo. Consulta l'esecuzione delle attività nello scheduler e i timestamp e lo stato della coda nella pagina di configurazione del modulo.

La diagnostica include controlli di prontezza, contatori di coda, righe recenti, Invia probe 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.

L’attività ha un timeout di 30 secondi. Invia probe S2S è disattivato perché Outbrain non ha una modalità di test che tenga le conversioni di prova fuori dai rapporti. Compilare il campo clic di test non invia alcun acquisto di prova.

1. Controlla campi obbligatori, prontezza, integrità e titolarità per ogni Marketer ID.
2. Usa un normale browser visitatore, concedi il consenso marketing e apri un prodotto.
3. Verifica che obtp.js venga caricato e che venga emesso l’evento browser previsto.
4. Esegui un’effettiva aggiunta al carrello riuscita ed esamina l’evento.
5. Per S2S, verifica un acquisto reale autorizzato attribuito a un annuncio. Esamina ricevuta, risultato della coda, esecuzione cron e report Outbrain.

Se il pixel browser è assente, controlla interruttore di attivazione, Marketer ID, consenso, criteri per i dipendenti, criteri di uscita, tag duplicati e blocchi del browser. Se mancano gli acquisti S2S, controlla l’attribuzione dei clic e il consenso registrato dell’acquirente. Non aspettarti un ripiego sull’acquisto browser mentre S2S è attivo. Prima di reimpostare le righe non riuscite, controlla se l’invio è arrivato a Outbrain, perché un postback ripetuto può contare l’acquisto due volte.

Se una regola personalizzata fallisce, convalida il nome evento esatto e il JSON. Usa condizioni sul percorso per i trigger URL. Per gli eventi personalizzati server, esamina la ricevuta emessa dal server e il suo legame invece di fornire una ricevuta inventata da JavaScript.

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.