Tutta la documentazione

Reddit Pixel Integration – Documentazione

Reddit Pixel aggiunge il tracciamento pubblicitario Reddit al suo negozio PrestaShop, inclusi gli eventi Pixel nel browser e, opzionalmente, gli eventi Reddit Conversions API. Aiuta a misurare visualizzazioni prodotto, azioni nel carrello, ricerche, registrazioni, avvii del checkout e acquisti per le campagne Reddit Ads.

Funzionalità

  • Reddit browser Pixel. Il modulo carica https://www.redditstatic.com/ads/pixel.js tramite displayHeader quando il tracciamento è attivo e le regole di consenso lo consentono.
  • Tracciamento eventi nello storefront. Può inviare PageVisit, ViewContent, Search, AddToCart, AddToWishlist, Purchase, SignUp e un evento personalizzato InitiateCheckout.
  • Dati di prodotto e ordine. Visualizzazioni prodotto, azioni nel carrello e acquisti possono includere ID prodotto, nomi, categorie, quantità, valore, valuta, ID transazione e ID conversione.
  • Coda Conversions API. Gli eventi lato server vengono accodati e inviati a Reddit tramite https://ads-api.reddit.com/api/v2.0/conversions/events/PIXEL_ID.
  • Deduplicazione tra browser e server. Gli eventi Browser Pixel e Conversions API condividono lo stesso ID conversione dove supportato, così Reddit può deduplicare gli eventi corrispondenti.
  • Bridge per carrello e lista desideri. Il front controller conversion può accodare eventi lato server per gli eventi solo browser AddToCart e AddToWishlist.
  • Regole evento personalizzate. Può tracciare clic, URL corrispondenti, controller PrestaShop ed eventi DOM personalizzati con regole JSON.
  • Caricamento attento al consenso. Il modulo verifica il consenso marketing di mprcookiesrevolution e mprcookiebanner prima di caricare il tracciamento Reddit quando il rispetto del consenso è attivo.
  • Esclusione del traffico dei dipendenti. La navigazione degli impiegati back-office collegati può essere ignorata, per tenere i test dello staff fuori dai dati pubblicitari.
  • Diagnostica back-office. La pagina di configurazione mostra controlli di prontezza, stato della coda, eventi CAPI recenti, un pulsante di test API e un’azione di ritentativo per gli eventi non riusciti.
  • Controlli di integrità dell’installazione. Il modulo include avvisi di configurazione obbligatoria e controlli di integrità per tabella della coda, configurazione, hook, tab e controller admin.
  • Monitor demo. Sugli host demo mypresta.rocks, un pannello di telemetria flottante mostra un’anteprima dei percorsi evento attivi lato browser e lato server.
Reddit Pixel Integration, Admin custom events Reddit Pixel Integration, Admin readiness

Opzioni di configurazione

Impostarle in Modules -> Reddit Pixel -> Configure.

  • Enable Reddit Pixel. Attiva o disattiva il tracciamento Browser Pixel; predefinito: 0.
  • Pixel ID. Memorizza il suo Reddit Pixel ID da Reddit Ads Manager -> Events Manager; predefinito: "". Deve contenere solo lettere, numeri, underscore e trattini, da 4 a 128 caratteri.
  • Exclude employee browsing. Interrompe il tracciamento quando un impiegato back-office collegato naviga nello storefront; predefinito: 1.
  • Respect marketing consent. Carica il tracciamento Reddit solo dopo il consenso marketing quando mprcookiesrevolution o mprcookiebanner è attivo; predefinito: 1.
  • Track PageVisit. Invia un evento generale di visita pagina sulle pagine dello storefront tracciate; predefinito: 1.
  • Track ViewContent. Invia eventi di visualizzazione prodotto sulle pagine prodotto quando i dati prodotto sono disponibili; predefinito: 1.
  • Track AddToCart. Invia eventi di aggiunta al carrello dagli aggiornamenti carrello di PrestaShop o dai pulsanti comuni di aggiunta al carrello; predefinito: 1.
  • Track AddToWishlist. Invia eventi di aggiunta alla lista desideri dagli eventi lista desideri supportati o dai pulsanti comuni di lista desideri; predefinito: 1.
  • Track InitiateCheckout. Invia l’ingresso nel checkout come evento personalizzato Reddit chiamato InitiateCheckout; predefinito: 1.
  • Track Search. Invia eventi di ricerca sulle pagine relative alla ricerca quando è presente una query; predefinito: 1.
  • Track Purchase. Invia eventi di acquisto sulla conferma ordine con valore ordine, valuta, prodotti, ID transazione e ID conversione; predefinito: 1.
  • Track SignUp. Invia un evento di registrazione al caricamento della pagina successiva alla creazione dell’account cliente; predefinito: 1.
  • Track custom events. Abilita le sue regole evento personalizzate JSON per il tracciamento Browser Pixel; predefinito: 0.
  • Custom event rules. Memorizza l’array JSON usato per regole di clic, URL, controller ed evento DOM; predefinito: "".
  • Enable Conversions API events. Accoda gli eventi idonei lato server e li invia a Reddit con ID conversione corrispondenti dove disponibili; predefinito: 0.
  • Conversions API access token. Memorizza il token Reddit Conversions API generato in Reddit Ads Manager -> Events Manager; predefinito: "".
  • Events testing ID. Abilita la modalità test Reddit per i payload CAPI quando compilato; predefinito: "".
  • Queue batch limit. Controlla quanti eventi di conversione in coda vengono elaborati per esecuzione, da 1 a 100; predefinito: 20.
Reddit Pixel Integration, Admin config consent Reddit Pixel Integration, Storefront order confirmation

Esempi di personalizzazione

Tracciare i clic sulle immagini della galleria prodotto:

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

Tracciare una URL di landing page una sola volta:

[
  {
    "event": "LandingView",
    "trigger": "url",
    "contains": ["/special-offer"],
    "params": {
      "property": "special_offer"
    },
    "once": true
  }
]

Tracciare una pagina controller PrestaShop:

[
  {
    "event": "ContactView",
    "trigger": "controller",
    "controllers": ["contact"],
    "params": {
      "property": "contact_page"
    },
    "once": true
  }
]

Tracciare un evento DOM personalizzato dal suo tema o modulo:

[
  {
    "event": "SizeGuideOpen",
    "trigger": "event",
    "dom_event": "mprreddit:sizeGuideOpen",
    "params": {
      "property": "size_guide"
    },
    "once": false
  }
]

document.dispatchEvent(new CustomEvent('mprreddit:sizeGuideOpen', {
  detail: {
    params: {
      product_id: '123',
      product_category: 'Shower trays'
    }
  }
}));

Aggiungere parametri evento extra a un elemento cliccabile:

<button
  class="track-reddit-demo"
  data-reddit-param-product_id="123"
  data-mprreddit-param-product_category="Accessories">
  Track custom action
</button>

Inviare manualmente un evento personalizzato dopo il caricamento del modulo:

if (window.mprredditTrack) {
  window.mprredditTrack('Custom', {
    customEventName: 'PromoClick',
    property: 'homepage_promo',
    conversionId: 'promo-homepage-001'
  }, false);
}
Reddit Pixel Integration, Admin config custom events Reddit Pixel Integration, Storefront view source

Installazione

  1. Nel Back Office PrestaShop, andare su Modules -> Module Manager.
  2. Fare clic su Upload a module e selezionare il file ZIP del modulo.
  3. Dopo l’installazione, fare clic su Configure.
  4. Inserire il suo Reddit Pixel ID.
  5. Abilitare il tracciamento nel browser e scegliere gli eventi dello storefront da inviare.
  6. Opzionale: abilitare Reddit Conversions API e inserire il token di accesso.
  7. Salvare, poi testare con Reddit Pixel Helper, Reddit Events Manager e il blocco diagnostico nella pagina di configurazione del modulo.
Reddit Pixel Integration, Admin config events

Come funziona

Il modulo registra displayHeader, displayOrderConfirmation, actionValidateOrder e actionCustomerAccountAdd. Nello storefront inietta lo script Reddit Pixel, cattura gli identificatori di clic Reddit dal traffico pubblicitario, li salva nei cookie di attribuzione e invia gli eventi abilitati quando avviene l’azione cliente corrispondente.

Per Conversions API, gli eventi idonei vengono salvati nella coda di conversione condivisa. Il task cron send_reddit_conversions viene eseguito ogni 300 secondi, elabora fino al limite batch configurato e mantiene visibile nel back-office lo stato recente della coda.

Reddit Pixel Integration, Admin config pixel

Limiti reali

  • Il tracciamento Reddit parte solo quando il Pixel ID è valido e il tracciamento browser è abilitato.
  • I controlli di consenso dipendono dai moduli di consenso MPR supportati; altri banner cookie non vengono rilevati automaticamente da questo modulo.
  • Il rilevamento di aggiunta al carrello e alla lista desideri dipende dal markup del tema o dagli eventi JavaScript di PrestaShop, quindi temi insoliti possono richiedere regole personalizzate.
  • Conversions API richiede un token di accesso Reddit valido e Reddit può rifiutare gli eventi se l’account pubblicitario, il Pixel o le autorizzazioni del token non sono corretti.
  • I nomi evento personalizzati sono limitati a lettere, numeri, underscore e trattini, fino a 64 caratteri, con un massimo di 15 nomi evento personalizzati distinti.
  • Le regole JSON personalizzate inviano eventi personalizzati Browser Pixel. Il loro flag capi pubblica il nome evento browser Custom, ma il bridge lato server accetta solo AddToCart, AddToWishlist o un nome evento browser pubblicato che corrisponde direttamente a una regola personalizzata configurata; quindi le normali regole personalizzate configurate, come GalleryBrowse, non vengono accodate lato server.
  • Il modulo gestisce l’implementazione tecnica del tracciamento, ma testo della privacy policy, base giuridica e accordi con le piattaforme pubblicitarie restano responsabilità del commerciante.

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

Reddit Pixel Integration, Admin integrity
Torna su