Integrazione Quora Pixel: configurazione e aiuto

Segui i passaggi in Avvio rapido.

• "Enable Quora Pixel". Attiva o disattiva il monitoraggio Pixel nel browser; predefinito: 0. Impostalo nella configurazione del modulo dopo aver inserito un Pixel ID valido.
• Pixel ID. Memorizza il tuo ID Quora Pixel da "Quora Ads Manager"; predefinito: empty. Deve contenere da 4 a 128 lettere, numeri, trattini bassi o trattini.
• "Advanced match email". Invia a Quora l'e-mail cliente con hash SHA-256 quando è disponibile un cliente connesso; predefinito: 1.
• "Exclude employee browsing". Impedisce il monitoraggio quando un dipendente del back office visita il negozio; predefinito: 1.
• "Respect marketing consent". Richiede il consenso marketing quando è attivo. Disattivandolo, consenti il monitoraggio senza una decisione di consenso separata solo se non viene rilevato alcun gestore del consenso supportato; predefinito: 1.
• "Track page visits". Invia le visite come eventi Quora Generic con event_label=PageVisit; predefinito: 1.
• "Track ViewContent". Invia visualizzazioni di pagine prodotto con ID prodotto, nome, categoria, valore e valuta quando disponibili; predefinito: 1.
• "Track AddToCart". Monitora le aggiunte al carrello riuscite e confermate con un aumento di quantità comprovato; predefinito: 1.
• "Track AddToWishlist". Monitora le aggiunte alla lista desideri da aggiunte riuscite e confermate; predefinito: 1.
• "Track InitiateCheckout". Invia InitiateCheckout quando il cliente raggiunge la pagina iniziale del checkout; predefinito: 1.
• "Track Search". Invia eventi Search con la stringa di ricerca inviata quando disponibile; predefinito: 1.
• "Track Purchase". Invia eventi di acquisto alla conferma dell'ordine e può accodare acquisti lato server quando Conversions API è configurata; predefinito: 1.
• "Track CompleteRegistration". Invia CompleteRegistration dopo la creazione di un account cliente; predefinito: 1.
• "Track custom events". Attiva le tue regole di eventi personalizzati JSON; predefinito: 0.
• Regole eventi personalizzati. Memorizza le regole JSON per il monitoraggio personalizzato di clic, URL, controller ed eventi DOM; predefinito: empty.
• "Enable Conversions API events". Attiva l'accodamento e l'invio lato server per eventi con un ID clic Quora valido; predefinito: 0.
• ID account pubblicitario Quora. Memorizza l'ID numerico dell'account pubblicitario Quora richiesto per Conversions API; predefinito: empty.
• Token di accesso Conversions API. Memorizza il token generato in "Quora Ads Manager" per inviare conversioni lato server; predefinito: empty.
• "Test qclid". Memorizza un vero ID clic Quora per la diagnostica; non viene inviata alcuna conversione di prova; predefinito: empty.
• "Queue batch limit". Limita gli eventi per elaborazione di ciascuna coda, da 1 a 100; gli eventi commerciali e i moduli confermati hanno code separate; predefinito: 20.

Fai clic su Salva dopo le modifiche. L'ID dell'account pubblicitario deve essere un numero intero positivo, fino a 9007199254740991. "Test qclid" accetta fino a 500 lettere, numeri, punti, trattini bassi, due punti e trattini.

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 relativi ai 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 modulo supporta le integrazioni di consenso MPR e altri adattatori CMP. Quando viene rilevato un gestore del consenso supportato, il monitoraggio richiede una decisione marketing valida per la destinazione. Una decisione sconosciuta, scaduta o negativa trattiene gli eventi. Il modulo non fornisce un banner cookie. Disattivare "Respect marketing consent" non prevale sul rifiuto di un gestore del consenso rilevato.

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. La modalità demo e i domini di anteprima o test riconosciuti bloccano l’invio al tuo account pubblicitario. Gli acquisti e gli eventi dei moduli lato server usano l’autorizzazione registrata al momento dell’azione dell’acquirente; un’esecuzione cron successiva non può fornire l’autorizzazione mancante.

Il modulo carica https://a.quora.com/qevents.js quando il consenso marketing e gli altri requisiti di monitoraggio lo consentono. I tuoi clienti non vedono alcun widget nel negozio.

Le visite usano Quora Generic con un'etichetta di visita. Pagine prodotto, aggiunte confermate al carrello e alla lista desideri, ingresso nel checkout, ricerca, registrazione e conferma ordine usano ViewContent, AddToCart, AddToWishlist, InitiateCheckout, Search, CompleteRegistration e Purchase. Il contesto prodotto e ordine può includere ID, nomi, categorie, quantità, valore, valuta e riferimento ordine. Il relativo evento deve essere attivo e i dati disponibili.

Gli acquisti idonei vengono accodati per l'invio server alla convalida dell'ordine e monitorati nel browser alla conferma dell'ordine. La creazione dell'account viene monitorata al successivo caricamento di pagina idoneo. Vengono monitorati anche gli invii confermati dei moduli.

L'attribuzione dei clic pubblicitari Quora usa qclid. Quando il monitoraggio è consentito, il modulo lo salva nel cookie mprqrpx_qclid per 30 giorni e nell'archiviazione locale del browser senza scadenza automatica. Il rifiuto del consenso cancella questi dati di attribuzione. Il monitoraggio nel browser funziona senza CAPI, ma gli eventi server richiedono un ID clic acquisito valido.

"Advanced match email" attiva la corrispondenza e-mail con hash SHA-256 quando consentito e con dati cliente disponibili. È soggetta anche ai controlli separati sul consenso alla corrispondenza; un cliente connesso da solo non la autorizza.

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": "mprquora:custom",
    "params": {
      "property": "size_guide"
    },
    "once": false,
    "capi": true
  }
]

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

document.dispatchEvent(new CustomEvent('mprquora:custom'));

Quora riceve le regole personalizzate come Generic con metadati custom_event_name. Le regole URL confrontano location.pathname; frammenti della query come utm_campaign=quora non sono confrontati dal runtime personalizzato attuale. Inserisci i parametri statici supportati, come value, in params. Le chiavi arbitrarie come property negli esempi non vengono inoltrate al Pixel browser; il payload server conserva nome, ora e ID dell'evento, ID clic e valore facoltativo. Il gestore DOM accetta un detail.event_id adatto, ma non unisce valori arbitrari di detail.params. I vecchi esempi di attributi dati per clic non vengono letti da questo runtime.

Gli eventi browser e server usano event_id corrispondenti quando l'evento originale è idoneo per entrambi. Una richiesta personalizzata capi richiede comunque attribuzione clic acquisita, identità evento accettata e autorizzazione attuale dell'acquirente.

Il task send_quora_conversions è registrato con pianificazione every:300. Risulta dovuto 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 per elaborazione di ciascuna coda da 1 a 100, con 20 come predefinito. Le code degli eventi commerciali e dei moduli confermati vengono elaborate separatamente per ogni negozio.

Il modulo usa lo scheduler condiviso configurato per il negozio e non ha un file cron.php separato. 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 relativi ai dipendenti, titolarità dell'account o destinazione.

Il client server invia a https://api.quora.com/ads/v0/conversion. Configura l'ID numerico dell'account e il relativo token. Invia probe API non invia nulla, perché questa integrazione non dispone di una modalità di invio di test o di sola validazione. "Test qclid" non invia una conversione di prova.

1. Controlla gli avvisi di configurazione richiesta, la prontezza, l'integrità e la titolarità della destinazione.
2. In un normale browser visitatore, concedi il consenso marketing e apri un prodotto. Verifica che qevents.js si carichi e che l'evento prodotto venga emesso.
3. Esegui un'aggiunta reale e riuscita al carrello e ispeziona l'evento browser.
4. Per i test server, usa un vero flusso autorizzato attribuito a un annuncio con qclid valido. Ispeziona lo stato dell'evento in coda e la diagnostica effettiva della piattaforma dopo l'elaborazione cron.
5. Conferma gli ID browser e server dove entrambi gli eventi sono stati ammessi.

Se mancano eventi browser, controlla Pixel ID, interruttori, consenso, marcatori dipendenti, titolare del monitoraggio, politica in uscita e blocchi browser. Se mancano eventi server, controlla attribuzione del clic, credenziali, consenso registrato dell'acquirente ed esecuzioni dello scheduler. Gli eventi server richiedono un ID clic qclid, quindi una visita normale senza di esso non genera alcun evento CAPI. Riprova solo dopo aver corretto l'errore registrato.

Se una regola personalizzata non viene eseguita, valida JSON e sintassi dei selettori e verifica se intendevi confrontare il percorso o la query. Il runtime attuale non espone window.mprquoraTrack.

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. Gli eventi già inviati restano sulla piattaforma pubblicitaria. La disinstallazione non cancella i dati di attribuzione del browser.

Richiede PrestaShop 1.6 o successivo e PHP 7.1 o successivo.