Integrazione Reddit Pixel: configurazione e aiuto

Segui i passaggi in Avvio rapido.

Impostali in Moduli -> Reddit Pixel -> "Configure".

• "Enable Reddit Pixel". Attiva o disattiva il monitoraggio Pixel nel browser; predefinito: 0.

• Pixel ID. Memorizza il tuo ID Reddit Pixel da "Reddit Ads Manager" -> "Events Manager"; predefinito: "". Deve contenere da 4 a 128 caratteri, solo lettere, numeri, trattini bassi e trattini.

• "Exclude employee browsing". Interrompe il monitoraggio quando un dipendente connesso al back office visita il negozio; predefinito: 1.

• "Respect marketing consent". Carica il monitoraggio Reddit solo dopo il consenso marketing quando è attivo mprcookiesrevolution o mprcookiebanner; predefinito: 1.

• "Track PageVisit". Invia un evento generale di visita sulle pagine monitorate del negozio; predefinito: 1.

• "Track ViewContent". Invia eventi di visualizzazione sulle pagine prodotto quando i dati sono disponibili; predefinito: 1.

• "Track AddToCart". Invia eventi di aggiunta al carrello dopo un aumento di quantità riuscito e confermato; predefinito: 1.

• "Track AddToWishlist". Invia eventi di aggiunta alla lista desideri da aggiunte riuscite e confermate; predefinito: 1.

• "Track InitiateCheckout". Invia l'ingresso nel checkout come evento Reddit personalizzato chiamato InitiateCheckout; predefinito: 1.

• "Track Search". Invia eventi di ricerca sulle pagine pertinenti quando è presente una query; predefinito: 1.

• "Track Purchase". Invia eventi di acquisto alla conferma dell'ordine con valore dell'ordine, valuta, prodotti, ID transazione e ID conversione; predefinito: 1.

• "Track SignUp". Invia un evento di registrazione al caricamento della pagina successivo alla creazione dell'account cliente; predefinito: 1.

• "Track custom events". Attiva le tue regole di eventi personalizzati JSON per il monitoraggio Pixel nel browser; predefinito: 0.

• Regole eventi personalizzati. Memorizza l'array JSON usato per le regole di clic, URL, controller ed eventi DOM; predefinito: "".

• "Enable Conversions API events". Accoda gli eventi idonei lato server e li invia a Reddit con ID conversione corrispondenti dove il trasporto li supporta; predefinito: 0.

• Token di accesso Conversions API. Memorizza il token Reddit Conversions API generato in "Reddit Ads Manager" -> "Events Manager"; predefinito: "".

• "Events testing ID". Se compilato, attiva la modalità di test Reddit per i payload CAPI; predefinito: "".

• "Queue batch limit". Controlla quanti eventi di conversione in coda vengono elaborati per esecuzione, da 1 a 100; predefinito: 20.

• "Persist consent withdrawals". Predefinito: 0. Attiva un veto persistente per eventi di acquisto e moduli di contatto precedentemente accettati. Attivalo se ti serve conservare la revoca.

Fai clic su Salva dopo aver modificato il form.

Il form 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, 45 secondi di permanenza 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 tema non richiede selettori diversi. Questi segnali facoltativi richiedono controlli di consenso, criteri dipendenti e titolarità del monitoraggio come gli eventi commerciali.

Mantieni attive le impostazioni di consenso ed esclusione dipendenti durante la configurazione iniziale. Prova da un normale browser visitatore non contrassegnato come dipendente. Una sessione back office connessa, una regola di traffico interno o la rinuncia del visitatore può impedire il monitoraggio.

Il livello di consenso condiviso supporta le integrazioni MPR e altri adattatori CMP. 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 preferenza di consenso precedente non prevale su un rifiuto attuale di una CMP rilevata.

Il modulo deve essere titolare della destinazione configurata nel coordinatore di monitoraggio condiviso. Una titolarità assente, ambigua o in conflitto può trattenere gli invii browser e server. Rimuovi i tag duplicati nel 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 moduli lato server vengono inviati solo con il consenso dato dall’acquirente in quel momento; un’esecuzione cron successiva non può sostituirlo.

L'header del negozio fornisce una configurazione compatibile con la cache. Il modulo carica https://www.redditstatic.com/ads/pixel.js dopo il superamento dei controlli. Non viene mostrato un normale widget del negozio. Il modulo supporta displayHeader, displayOrderConfirmation, actionValidateOrder, actionCustomerAccountAdd, displayFooter e displayBeforeBodyClosingTag.

Con i relativi interruttori attivi, le visite inviano PageVisit, le pagine prodotto ViewContent e le pagine di ricerca Search; le aggiunte confermate al carrello e alla lista desideri inviano gli eventi corrispondenti. L'ingresso nel checkout invia Reddit Custom con customEventName=InitiateCheckout. La creazione dell'account viene segnata per SignUp al successivo caricamento di pagina idoneo.

Gli acquisti includono gli articoli disponibili dell’ordine, quantità, valore, valuta, ID transazione e conversione. Gli acquisti server e browser condividono la stessa identità d’acquisto quando disponibile. Le aggiunte al carrello e alla lista desideri richiedono la conferma di un’aggiunta reale; un evento browser da solo non basta.

Gli eventi server vengono inviati all'endpoint Reddit https://ads-api.reddit.com/api/v2.0/conversions/events/PIXEL_ID con il Pixel ID configurato. I dati di corrispondenza inviati dipendono dall'attribuzione originale e dal consenso del visitatore. Le copie browser e server condividono un ID evento per la deduplicazione quando vengono inviate entrambe, ma non tutti gli eventi passano da entrambi i canali.

Attiva "Track custom events", incolla un array JSON in Regole eventi personalizzati e salva. Adatta selettori e percorsi al negozio. Usa i trigger click, url, controller o event. Una regola controller può includere anche una lista modules. I nomi consentono lettere, numeri, trattini bassi e trattini, fino a 64 caratteri. Il limite è di 15 nomi distinti. once limita una regola nell'esecuzione della pagina corrente.

[
  {
    "event": "GalleryBrowse",
    "trigger": "click",
    "selector": ".product-images img,.images-container img",
    "params": {
      "property": "product_gallery"
    },
    "once": false,
    "capi": true
  },
  {
    "event": "LandingView",
    "trigger": "url",
    "contains": [
      "/special-offer"
    ],
    "params": {
      "property": "special_offer"
    },
    "once": true,
    "capi": true
  },
  {
    "event": "ContactView",
    "trigger": "controller",
    "controllers": [
      "contact"
    ],
    "params": {
      "property": "contact_page"
    },
    "once": true,
    "capi": true
  },
  {
    "event": "SizeGuideOpen",
    "trigger": "event",
    "dom_event": "mprreddit:sizeGuideOpen",
    "params": {
      "property": "size_guide"
    },
    "once": false,
    "capi": true
  }
]

Attiva la regola DOM dal tema dopo l'inizializzazione del monitoraggio:

document.dispatchEvent(new CustomEvent('mprreddit:sizeGuideOpen'));

Il flag capi di ogni regola invia una copia server tramite il bridge personalizzato. Il bridge accetta Custom con customEventName, controlla che la regola sia configurata e richiede un ID evento e il consenso attuale del visitatore. Senza di essi, l'evento viene trattenuto.

Per la regola di clic, gli attributi dati supportati possono sovrascrivere value, currency, num_items ed event_id, per esempio:

<button class="track-reddit-demo" data-reddit-param-value="12.50"
        data-mprreddit-param-currency="EUR">Track custom action</button>

Usa un selettore di clic corrispondente nella regola. Il vecchio esempio di attributi product_id e product_category non è usato dal runtime attuale. Un evento DOM può fornire i valori commerciali supportati in detail.params. Inserisci i parametri descrittivi statici nella regola stessa.

Il task send_reddit_conversions è registrato con pianificazione every:300. È pianificato ogni cinque minuti. Il runner cron MPR condiviso deve eseguire i task dovuti; la sola dichiarazione non avvia un worker. Il limite del lotto limita le righe della coda per esecuzione da 1 a 100, con 20 come predefinito.

Il modulo non include un punto di ingresso autonomo cron.php. Usa lo scheduler condiviso già configurato per il negozio. Conferma lì l'esecuzione dei task e controlla date, orari e stato della coda nella pagina di configurazione del modulo.

La diagnostica include controlli di prontezza, contatori della coda, righe recenti, Invia probe API 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 dipendenti, titolarità dell'account o destinazione.

Per Invia probe API, inserisci un "Events testing ID" e tieni pronto un vero evento in attesa di un acquirente che ha dato il consenso. Senza ID di test, consenso attuale o un evento utilizzabile in coda, la probe viene rifiutata; non crea mai un acquisto fittizio. Svuota "Events testing ID" quando sei pronto per gli eventi di produzione.

1. Controlla gli avvisi di configurazione richiesta, la titolarità del monitoraggio e il banner di integrità.
2. Usa un normale browser visitatore e concedi il consenso marketing tramite la CMP configurata.
3. Apri un prodotto, esegui una ricerca e completa un'aggiunta al carrello riuscita. Controlla il caricamento dell'SDK e le richieste degli eventi corrispondenti nel pannello di rete del browser.
4. Controlla la diagnostica eventi di Reddit o Pixel Helper, se disponibile nel tuo ambiente di prova.
5. Per gli acquisti, usa un flusso di prova autorizzato e ispeziona l'evento browser, l'ID conversione e la riga della coda.
6. Per l'invio server, esegui lo scheduler configurato e controlla il risultato della coda. Una chiamata browser accettata dal negozio non è necessariamente arrivata a Reddit.

Se non si carica alcuno script, controlla "Enable Reddit Pixel", sintassi di Pixel ID, consenso, marcatori dipendenti, titolarità, politica in uscita e blocchi script. Se mancano eventi carrello o lista desideri, ispeziona i segnali di operazione riuscita e i dati prodotto. Un clic da solo non basta. Usa regole personalizzate per interazioni separate, senza etichettare un clic come acquisto o aggiunta al carrello comprovati.

Se le righe CAPI falliscono o restano trattenute, controlla token, destinazione Pixel, consenso registrato, schema della coda ed esecuzione cron. Le regole personalizzate richiedono JSON e selettori validi. Questa versione non fornisce il precedente helper window.mprredditTrack.

Disattiva gli interruttori browser e server e salva per interrompere il monitoraggio conservando la configurazione. Disinstalla da "Module Manager" per rimuovere impostazioni del modulo, voci di menu e task registrati.

La disinstallazione richiama la pulizia condivisa della coda conversioni. La tabella condivisa viene conservata finché un altro modulo conversioni la usa e può essere eliminata quando viene rimosso l'ultimo utilizzatore. Esporta la diagnostica necessaria prima di disinstallare. Non presumere che la disinstallazione elimini gli eventi già inviati alla piattaforma pubblicitaria o cancelli tutta l'archiviazione di attribuzione del browser.

Richiede PrestaShop 1.6.0.0 o successivo e PHP 7.1 o successivo.