Guida utente

Aggiornamento dalla versione 1

Se il negozio usa Order Source Tracking 1.x, il nome precedente di questo modulo, l’aggiornamento avviene sul posto e i dati vengono conservati. Il modulo ha un nuovo nome, un nuovo menu e un nuovo modo di registrare le visite, e il suo pannello conta in modo diverso. Questo capitolo spiega cosa aspettarsi.

Come aggiornare

Verificare che il negozio usi PrestaShop 8.0 o successivo. La versione 2 non si installa su PrestaShop 1.7; un negozio di questo tipo resta alla versione 1.
Aprire Moduli › Gestione Moduli, fare clic su Carica un modulo e selezionare il nuovo zip. PrestaShop esegue l’aggiornamento.
Aprire Ordini › Origini degli ordini › Impostazioni e leggere la Lista di controllo.

Non occorre disinstallare prima la versione 1. Se l’aggiornamento si ferma a metà, ad esempio perché una tabella grande richiede troppo tempo, caricare di nuovo lo zip: l’aggiornamento riprende da dove si era fermato.

Cosa viene conservato

Dati della versione 1	Dopo l’aggiornamento
Le origini degli ordini	Conservate, per ogni ordine che esiste ancora. Origine e mezzo sono ora in minuscolo, quindi «Facebook» e «facebook» sono diventate un’unica origine.
Visite	Conservate quando hanno meno di 13 mesi. Le visite più vecchie non vengono trasferite. Una tabella grande viene copiata mese per mese, partendo dai mesi più recenti; ciò che l’aggiornamento non completa, lo completa la pulizia quotidiana. Le visite copiate non hanno pagina di arrivo, termine, contenuto né tipo di clic su annuncio: la versione 1 non li memorizzava.
Le impostazioni	Conservate: la finestra di attribuzione, le regole del referrer, i siti esclusi, gli indirizzi di test e i due interruttori per le colonne del primo e dell’ultimo contatto della scheda Ordini del modulo.
Visitatori a metà percorso	Un visitatore arrivato prima dell’aggiornamento che ordina dopo di esso riceve comunque il primo e l’ultimo contatto corretti: il modulo legge una volta i cookie della versione 1, poi li rimuove.
Le tabelle della versione 1	Non toccate dall’aggiornamento. Restano per 30 giorni per sicurezza e vengono poi rimosse dalla pulizia. Fino ad allora la Lista di controllo mostra una riga ambra che lo indica, e Dati e manutenzione riporta la data. È un’informazione, non un problema.

Cosa è cambiato

Argomento	Versione 1	Ora
Nome e menu	Order Source Tracking: tre voci sotto Ordini, e le impostazioni in Gestione Moduli	Order Source Pro: una voce, Origini degli ordini, con le schede Pannello, Ordini, Visite e Impostazioni
Ordini confermati in background dal fornitore di pagamento	Non avevano origine	Ricevono la loro origine: viaggia con il carrello
Ordini creati nel back office	Prendevano l’origine delle visite del dipendente stesso	Non hanno origine, il che corrisponde al vero
Regole del referrer e siti esclusi	Venivano salvati e mai usati	Hanno effetto
Ritorno da una pagina di pagamento	Poteva diventare l’origine dell’ordine	Non conta mai; i propri domini e i fornitori di pagamento più comuni sono esclusi
Clic su annunci senza parametri UTM	Non riconosciuti	Riconosciuti (Piattaforme pubblicitarie: riconosciute senza parametri UTM)
Cosa memorizza una visita	Indirizzo IP, browser, dispositivo e pagine viste	Nulla di tutto ciò (Cosa viene memorizzato e cosa no)
Impostazioni	Una pagina in Gestione Moduli	Una scheda con sezioni, con nuove impostazioni per rilevamento, consenso, conservazione e visualizzazione. Partono con gli stessi valori di una nuova installazione (Impostazioni)

Schermate scomparse

Le due schermate di importazione CSV, la schermata di esportazione dei visitatori e l’esportazione per intervallo di date sopra l’elenco degli ordini. Le schede Ordini e Visite esportano con il pulsante del loro elenco.
La pagina di dettaglio di un visitatore. Tutto ciò che contiene una visita si trova nell’elenco.
Le impostazioni «Track First UTM» e «Track Last UTM». Non hanno mai avuto effetto.

I nuovi numeri del pannello

Dopo l’aggiornamento il pannello mostra una nota: «I numeri di questa pagina sono cambiati nella versione 2.1. Contano solo gli ordini validi, e il fatturato è l’importo pagato senza tasse e senza spedizione, nella valuta predefinita, come nel pannello di controllo di PrestaShop. Un ordine conta nel giorno in cui è stato effettuato.» Resta finché non si fa clic su Chiudi. La Cosa significa ogni numero spiega il giorno in cui un ordine viene contato, l’unica differenza mantenuta di proposito. Cosa c’è dietro la nota:

Numero	La versione 1 contava	Ora
Ordini	Tutti gli ordini, compresi quelli annullati e non pagati	Solo gli ordini validi, e tutti: gli ordini senza origine sono la riga Non tracciato
Fatturato	I totali degli ordini, non convertiti tra valute	Senza tasse e senza spedizione, convertito nella valuta predefinita
Ordini senza origine	«Unknown»	Non tracciato, con l’indicatore Ordini tracciati per indicare quanti hanno un’origine

Così i totali di un mese passato possono differire da quanto mostrava la versione 1. Nulla è andato perso: gli ordini annullati e non pagati non contano più, e il fatturato esclude tasse e spedizione. Per un fatturato tasse incluse, impostare Fatturato nel pannello su Tasse incluse (Ordini: dove viene mostrata l’origine). In un multinegozio, le vecchie visite che non hanno portato ad alcun ordine si trovano tutte nel negozio predefinito (Visite della versione 1).

Domande e problemi

Iniziare dalla Lista di controllo in Impostazioni › Panoramica: la maggior parte dei problemi compare lì, con un link alla sezione che li risolve. Un errore del modulo non blocca una pagina del negozio: viene invece scritto in Parametri Avanzati › Logs, in una riga che inizia con pch_ordersource.

Problemi

Non compare alcuna visita

Fare una visita di prova: aprire il negozio in una finestra privata e aggiungere ?utm_source=test all’indirizzo. Se la registrazione inizia Dopo che il visitatore accetta i cookie, accettare prima il banner dei cookie su quella pagina. Aprire la scheda Visite dopo un minuto.
Se la visita manca e la registrazione attende il consenso, il banner potrebbe non comunicare al modulo la risposta del visitatore: in tal caso non viene registrato proprio nulla (Consenso: quando può iniziare la registrazione).
Controllare Impostazioni › Rilevamento. Con Solo server e una cache delle pagine, le pagine in cache non vengono registrate. Scegliere Solo script, come spiega Il negozio usa una cache delle pagine o una CDN.
Con Solo script, un browser che blocca gli script, o una regola di un firewall davanti al negozio, può impedire la segnalazione dello script. Provare un altro browser senza estensioni.
Ancora nulla? Attivare Log delle decisioni in Impostazioni › Dati e manutenzione, ripetere la visita di prova e leggere Parametri Avanzati › Logs: il modulo scrive cosa ha registrato o ignorato, e perché, in righe che iniziano con pch_ordersource. Disattivare poi l’impostazione.

Alcuni arrivi vengono ignorati di proposito: i robot dei motori di ricerca e gli strumenti di monitoraggio, una pagina che il browser si limita a caricare in anticipo e il ritorno da una pagina di pagamento.

Ordini senza origine (Non tracciato)

Un ordine non ha origine quando il modulo non ha potuto collegarlo a una visita. I motivi abituali:

L’ordine è stato creato nel back office o tramite il webservice.
L’ordine è stato effettuato prima dell’installazione del modulo.
Il browser del visitatore ha rifiutato o eliminato il cookie, oppure il visitatore non ha accettato nel banner dei cookie.
La visita stessa non è stata registrata, per uno dei motivi indicati sopra.

Una quota di ordini non tracciati è normale. L’indicatore Ordini tracciati nel pannello indica quanto è grande. Se è bassa, controllare prima l’impostazione del consenso: con Dopo che il visitatore accetta i cookie, ogni visitatore che non accetta non è tracciato.

I numeri differiscono da Google Analytics

Differiranno, e nessuno dei due strumenti sbaglia. I due contano cose diverse:

Differenza	Order Source Pro	Un servizio di analisi
Ordini	Gli ordini reali del negozio, quando sono validi, compresi quelli confermati in background dal fornitore di pagamento.	Gli ordini che il suo script ha visto nella pagina di conferma.
Fatturato	Senza spedizione, senza tasse salvo scelta diversa, nella valuta predefinita.	Ciò che invia il codice di tracciamento del negozio, spesso con tasse e spedizione.
Quale visita riceve l’ordine	Primo contatto, oppure ultimo contatto non diretto, all’interno della finestra di attribuzione.	Il proprio modello e la propria finestra.
Una visita	Un arrivo; termina dopo 30 minuti senza pagine viste.	Una sessione, secondo le proprie regole.
Chi viene contato	Dipende dalle impostazioni Rilevamento e Consenso.	Dipende dalle sue impostazioni di consenso e dai programmi che bloccano gli script.

Confrontare invece con il pannello di controllo di PrestaShop: conta ordini e vendite con le stesse regole. La Cosa significa ogni numero indica l’unica cosa che differisce di proposito, il giorno in cui un ordine viene contato.

Il negozio usa una cache delle pagine o una CDN

Scegliere Solo script in Impostazioni › Rilevamento, come consiglia l’aiuto del campo. È l’opzione da usare quando la cache o la CDN rimuove i cookie dalle pagine che memorizza. Mai Solo server: una pagina in cache viene inviata senza che il negozio venga interpellato. La Lista di controllo avvisa quando trova un modulo di cache delle pagine insieme a Solo server. Se la cache è configurata fuori da PrestaShop, ad esempio presso la società di hosting, la lista di controllo non può vederla: scegliere l’impostazione da sé.

Il negozio ha un banner dei cookie

Decidere se i visitatori devono dare il consenso prima di essere tracciati; è una questione legale (Consenso: quando può iniziare la registrazione). Se sì, scegliere Dopo che il visitatore accetta i cookie e assicurarsi che il banner comunichi la risposta: un banner con Google Consent Mode lo fa da solo, qualsiasi altro banner ha bisogno di una chiamata. Poi provare: in una finestra privata, una visita deve comparire nella scheda Visite solo dopo aver accettato.

Un fornitore di pagamento compare tra le origini

Aggiungerne il dominio in Impostazioni › Siti esclusi (Siti esclusi: pagine da cui un cliente si limita a tornare). Le visite già registrate mantengono la loro origine; quelle nuove non la ricevono più.

Il sito di un partner compare con il suo dominio, oppure vengono contate le proprie visite

Un sito senza regola viene registrato con il suo dominio, come referral: assegnargli l’origine desiderata in Impostazioni › Regole del referrer (Regole del referrer: un’origine a scelta per un sito). Per escludere le proprie visite dal pannello, aggiungere il proprio indirizzo in Indirizzi IP di test in Impostazioni › Attribuzione.

La lista di controllo dice che la pulizia non è stata eseguita

La pulizia viene eseguita quando qualcuno apre il back office. Fare clic su Esegui ora in Impostazioni › Dati e manutenzione. Per un negozio il cui back office non viene aperto ogni giorno, far chiamare l’Indirizzo di manutenzione da un’attività pianificata una volta al giorno (L’indirizzo di manutenzione).

Mancano le visite di un ufficio o di una rete

Per fermare le ondate di visite, il modulo registra al massimo 30 nuove visite al minuto da un singolo indirizzo. I visitatori reali non raggiungono mai questo limite, a meno che il negozio non si trovi dietro un proxy o una CDN che mostra al negozio un unico indirizzo per tutti. La società di hosting può configurare il server in modo che il negozio veda l’indirizzo reale di ogni visitatore.

Un dipendente non riesce ad aprire le schede del modulo

Le quattro schede sono pagine del menu del back office. Concedere al profilo del dipendente il diritto di vederle in Parametri Avanzati › Dipendenti › Permessi. La colonna Origine e il riquadro Origine dell’ordine non richiedono un permesso proprio.

Limiti noti

Limite	Cosa significa (una caratteristica del funzionamento del modulo, non un errore)
Un browser è un visitatore	Chi clicca un annuncio sul telefono e acquista sul portatile conta come due visitatori. L’ordine riceve l’origine con cui è arrivato il portatile.
Ordini creati nel back office	Non hanno origine: non sono preceduti da alcuna visita del cliente. Lo stesso vale per gli ordini che arrivano tramite il webservice.
Visitatori che rifiutano il cookie	Non vengono tracciati, e i loro ordini non hanno origine. Con Dopo che il visitatore accetta i cookie, ciò riguarda ogni visitatore che non accetta. Un browser che non conserva i cookie sembra nuovo a ogni pagina; il limite contro le ondate di visite gli impedisce di riempire gli elenchi.
Consenso dato in ritardo	Con Dopo che il visitatore accetta i cookie, un visitatore che accetta solo dopo aver lasciato la prima pagina viene registrato come diretto.
Un proxy che nasconde gli indirizzi dei visitatori	Il limite contro le ondate di visite conta allora tutti insieme (vedere sopra).
Più negozi	Un negozio in una cartella di un altro negozio ne condivide i visitatori. Le visite della versione 1 che non hanno portato ad alcun ordine si trovano nel negozio predefinito (Più negozi).
Solo primo e ultimo contatto	Il modulo non suddivide un ordine tra più origini e non importa i costi pubblicitari. Un ordine riceve la sua origine una volta sola: un’impostazione o una regola modificata in seguito non riscrive gli ordini e le visite già memorizzati.
PrestaShop 1.7	Non supportato dalla versione 2.

Domande frequenti

Cosa vedono i clienti?

Nulla: nessun pop-up e nessun banner. A seconda di Rilevamento, viene caricato un piccolo script dopo la pagina. Invia una breve segnalazione per visita, al negozio stesso.

Perché «diretto» pesa così tanto?

Diretto comprende ogni visita che non dice nulla della sua origine: indirizzi digitati e segnalibri, ma anche link in app, in programmi di posta elettronica e in messaggi che non contengono parametri. Contrassegnando con parametri UTM i link che si pubblicano (Costruire i link delle campagne), quella quota si riduce.

Assistenza

PrestaChamps sviluppa e supporta questo modulo. Accedere a addons.prestashop.com, aprire il proprio ordine di Order Source Pro e scrivere allo sviluppatore con il modulo di contatto. Indicare le versioni di PrestaShop, PHP e del modulo, cosa ci si aspettava e cosa succede invece, con una schermata della Lista di controllo. Se mancano visite o origini, attivare Log delle decisioni, ripetere il caso e inviarci le righe del modulo in Parametri Avanzati › Logs. Non inviare mai la propria password: se dobbiamo vedere il back office, chiediamo un account dipendente temporaneo.

Per gli sviluppatori

Questo capitolo è per chi configura il banner dei cookie, il server o i report: le chiamate JavaScript per un banner dei cookie, l’indirizzo per un’attività pianificata e le tabelle che stanno dietro agli elenchi.

Le chiamate JavaScript per un banner dei cookie

Contano solo quando Quando inizia la registrazione è impostato su Dopo che il visitatore accetta i cookie (Consenso: quando può iniziare la registrazione). Lo script del modulo allora non memorizza nulla e non imposta alcun cookie finché non apprende che il visitatore ha dato il consenso.

Google Consent Mode

Nulla da aggiungere. Lo script legge le voci di consenso che il banner invia a window.dataLayer:

Una voce che imposta analytics_storage su granted avvia la registrazione, che si tratti di una voce default o update.
Una voce update che lo imposta su denied revoca il consenso.
Una voce default con denied è lo stato iniziale del banner: non cambia nulla.

Qualsiasi altro banner

window.pchOrderSource.grantConsent();    // il visitatore ha accettato i cookie statistici
window.pchOrderSource.revokeConsent();   // il visitatore ha revocato il consenso, o ha rifiutato dopo averlo dato

Un banner che conosce presto la risposta memorizzata può invece impostare un flag, prima che venga eseguito lo script del modulo: window.pchOrderSourceConsent = 'granted', oppure 'denied'.

Cosa succede	Effetto
Il consenso viene dato sulla pagina di arrivo del visitatore	La visita viene registrata con la sua origine reale. Le pagine successive della stessa visita non richiedono un nuovo segnale.
Il consenso viene dato su una pagina successiva	La visita viene registrata come diretta: la campagna dell’arrivo non è più nota.
Il consenso viene revocato	Lo script rimuove il contrassegno della visita, e il negozio rimuove entrambi i cookie. Le visite già memorizzate non vengono eliminate (Esportare e cancellare i dati di un cliente).

Per verificare la configurazione, aprire il negozio in una finestra privata: prima di accettare, non deve esistere alcun cookie chiamato pch_os_v o pch_os_s; dopo aver accettato esistono entrambi, e la visita si trova nella scheda Visite.

L’indirizzo di manutenzione

La pulizia si avvia quando qualcuno apre il back office. Se il back office resta chiuso per giorni, far chiamare l’indirizzo di manutenzione una volta al giorno da un’attività pianificata (un cron job).

Aprire Impostazioni › Dati e manutenzione e fare clic su Copia accanto a Indirizzo di manutenzione.
Nel pannello di controllo dell’hosting, creare un’attività pianificata che chiami questo indirizzo una volta al giorno, in un orario di poco traffico. La maggior parte dei pannelli ha un campo per un indirizzo; su un server con riga di comando, basta una riga come questa:

# ogni giorno alle 03:15; incollare tra le virgolette l’indirizzo copiato
15 3 * * * curl -fsS "PASTE-THE-MAINTENANCE-ADDRESS-HERE" > /dev/null

Una chiamata riuscita risponde con OK e ciò che ha eliminato, ad esempio OK visits=0 cart_links=0 legacy_tables=0. L’indirizzo contiene un token segreto: trattarlo come una password. Una chiamata senza il token corretto viene rifiutata e non fa nulla. È lo stesso indirizzo per tutti i negozi di un multinegozio.

Le tabelle

Il modulo conserva i dati in quattro tabelle, dopo il prefisso delle tabelle del negozio (ps_ nella maggior parte dei negozi). Leggerle per i propri report; non scriverci.

Tabella	Una riga è
`pch_ordersource_visit`	Una visita: `visitor_key`, `id_shop`, `date_add`, `source`, `medium`, `campaign`, `term`, `content`, `click_id_type`, `landing_path`, `referrer_host`, `id_order`, `is_test`, `origin`.
`pch_ordersource_order`	L’origine di un ordine: `id_order`, `id_shop`, poi `first_source`, `first_medium`, `first_campaign`, `first_term`, `first_content`, `first_click_id_type`, `first_landing_path`, `first_date`, e le stesse otto colonne con `last_`.
`pch_ordersource_cart`	Il collegamento tra un carrello e il suo visitatore: `id_cart`, `visitor_key`, `date_add`.
`pch_ordersource_guard`	Il contatore del limite contro le ondate di visite. La pulizia quotidiana ne elimina le righe.

Valori da conoscere

Una visita diretta viene memorizzata con origine (direct) e mezzo (none). Un link con utm_source e senza utm_medium ha il mezzo (not set).
click_id_type è vuoto oppure uno tra google, microsoft, tiktok, meta.
origin indica come è stata registrata la visita: 0 dal negozio, 1 dallo script, 2 copiata dalla versione 1, 3 letta da un cookie della versione 1. Le righe con 3 esistono solo per l’attribuzione; escluderle quando si contano le visite, come fa il pannello.
Il pannello conta gli ordini con valid = 1 per date_add e somma (total_paid_tax_excl - total_shipping_tax_excl) / conversion_rate (con le tasse: le due colonne _tax_incl). Un ordine senza riga in pch_ordersource_order non è tracciato.

Come il modulo si collega al negozio

La segnalazione dello script. Una breve richiesta per visita a /module/pch_ordersource/beacon del negozio, che accetta richieste solo dalle pagine del negozio. Un firewall davanti al negozio deve lasciarla passare.
L’ordine. Il modulo collega un carrello al suo visitatore quando il carrello viene salvato nel front office, e scrive l’origine quando PrestaShop convalida l’ordine. In quel momento non legge alcun cookie, quindi anche un ordine confermato dal server di un fornitore di pagamento riceve la sua origine. I carrelli creati nel back office o tramite il webservice non vengono collegati.

↑

Aggiornamento dalla versione 1 — Order Source Pro