✨ Prestashop - Nuova documentazione modulo

Hai la possibilità di automatizzare la trasmissione della prova di acquisto e servizi tramite il CMS Prestashop. 

Questa documentazione è valida solo per i clienti che hanno l'ultima versione della piattaforma Recensioni Verificate.

Se non hai questa pagina, usa questa documentazione.

Se stai aggiornando il tuo connettore Prestashop alla versione 9, consulta questo articolo che dettaglia le specificità di questo aggiornamento.

Come funziona

Una volta che il modulo è installato e configurato, tutto è automatico: Recensioni Verificate si collega direttamente alla tua soluzione di e-commerce.

  • Recupero automatico degli ordini e delle richieste di recensioni: Il modulo comunica i tuoi ultimi ordini direttamente a noi. La nostra piattaforma recupera gli ordini per i quali dobbiamo inviare richieste di recensioni, in base alla configurazione impostata durante l'installazione descritta più avanti in questo documento.
  • Mostra le recensioni dei prodotti sul tuo sito: Il modulo ti consente di mostrare le recensioni dei prodotti raccolte sulla nostra piattaforma direttamente nelle tue pagine prodotto, rassicurando i tuoi clienti sulla qualità dei tuoi prodotti.

Installazione del modulo

  • Accedi al tuo pannello di amministrazione Prestashop
  • Clicca su Catalogo Moduli e cerca "netreviews", apparirà il modulo "Recensioni Verificate", oppure clicca qui
  • Clicca su Installa

blobid0.png

  • Un messaggio di successo apparirà dopo l'installazione

blobid1.png

Accedere alla configurazione

Configurazione iniziale:

Per configurare il modulo nell'ambiente Prestashop, vai al menu Moduli > Gestione Moduli, individua il modulo Recensioni Verificate nella scheda "Moduli" e clicca su "Configura".

blobid2.png

 

Prima di configurare, se hai un'installazione multishop su Prestashop, assicurati che il modulo sia attivato nel gestore moduli. Una volta sulla pagina di configurazione del modulo, seleziona il negozio rilevante utilizzando il selettore di Prestashop in cima alla pagina.

 

Per far sì che la nostra piattaforma comunichi con il tuo negozio, devi fornire i due campi “Chiave Segreta del Connettore e “Identificatore del Sito Web che puoi ottenere dalla tua area clienti Recensioni Verificate. Dal menu “Gestione Account > Il Mio Connettore Prestashop”, copia i codici di integrazione (vedi immagine sotto).

blobid4.jpg

Inseriscili nel tuo negozio Prestashop nella sezione “CONFIGURAZIONE”.

blobid5.jpg

 

Clicca su “Salva” per attivare il modulo su Prestashop. Successivamente, dovrai completare l'attivazione del modulo nel tuo account Recensioni Verificate.

 

Configurazione multilingue

Se il tuo Prestashop è in modalità multishop, puoi collegare solo un account Recensioni Verificate a un negozio (un id_shop). Se desideri integrare il modulo Recensioni Verificate in più negozi, hai bisogno di tante configurazioni di negozi quanti sono gli account Recensioni Verificate (diversi idWebsite e chiavi segrete).

Se il tuo sito è disponibile in diverse lingue, puoi scegliere di attivare la configurazione multilingue del modulo. Per farlo, devi avere account Recensioni Verificate su diverse piattaforme e compilare la Chiave Segreta e l'ID del Sito Web per ciascun account.

Ad esempio, se il tuo sito è disponibile in francese, spagnolo, italiano e inglese. Per beneficiare della configurazione multilingue, hai bisogno di un account su ciascuna delle nostre piattaforme:

Sarà quindi necessario inserire la Chiave Segreta e l'ID del Sito Web per ciascun account. I clienti riceveranno le e-mail di richiesta di opinione nella lingua della versione del sito su cui hanno fatto l'ordine:

  • se il tuo cliente effettua un ordine dalla versione inglese, le e-mail verranno inviate in inglese
  • se il tuo cliente effettua un ordine dalla versione spagnola, le e-mail verranno inviate in spagnolo, ecc.
  • Il modulo consente inoltre, con la personalizzazione del codice, di visualizzare tutte le recensioni in tutte le lingue.

Se il tuo sito non è disponibile in più lingue, non attivare la configurazione multilingue.

Configurazione del Modulo su Recensioni Verificate

Ora che il tuo modulo è installato e i tuoi codici sono integrati nel tuo ambiente Prestashop, puoi assicurarti che il modulo stia comunicando correttamente con la nostra piattaforma.

Vai alla tua area clienti di Recensioni Verificate nel menu
« Gestione Account > Il mio Connettore Prestashop».

Codici di Integrazione

Come menzionato nella sezione "Configurazione Accesso", devi andare alla pagina « Gestione Account > Il mio Connettore Prestashop», copiare i codici e incollarli nei campi corrispondenti nel tuo connettore.

Configurazione Raccolta Recensioni

Per configurare la raccolta tramite il modulo, dal menu laterale sinistro, vai aRaccolta delle Recensioni, poi Configurazione.

Da questa interfaccia, potrai configurare tutti gli aspetti della tua raccolta.

  • Ritardo prima di inviare la richiesta di recensione del marchio

Questa opzione ti consente di gestire il tempo di attesa prima di inviare le tue richieste di recensione. Questo ritardo si applica non appena i nostri servizi ricevono un ordine.

 

  • Stati desiderati per il recupero degli ordini

Questa opzione ti consente di scegliere lo stato o gli stati che i nostri servizi utilizzeranno per recuperare i tuoi ordini.

  • Ritardo dopo l'invio della richiesta di recensione del marchio

Questa opzione ti consente di selezionare il numero di giorni tra l'invio della richiesta di recensione del marchio e la richiesta di recensione del prodotto.

 

  • Follow-up della richiesta di recensione

Questa opzione ti consente di rinviare una notifica ai tuoi clienti chiedendo loro di lasciare una recensione. Puoi anche impostare il tempo prima di inviare questa email.

 

 

  • Estensioni email da escludere

Puoi inserire in questo campo i nomi di dominio sui quali non verrà inviata alcuna richiesta di recensione.

Configurazione della visualizzazione delle recensioni dei prodotti

1. Configura il widget del prodotto

2. Integra il widget del prodotto

Hai 2 opzioni di integrazione disponibili:

Per l'integrazione manuale del widget, sostituisci ogni elemento dati nel codice con i valori appropriati del tuo sito web e degli attributi del prodotto.

Scopri di più sull'integrazione del widget del prodotto.

3. Integra le stelle nelle pagine delle categorie

Puoi abilitare la visualizzazione delle stelle nelle pagine delle categorie e/o nella pagina principale dalla pagina di configurazione del modulo del tuo account Prestashop: sezione Design:

Configurazione della visualizzazione delle recensioni del marchio

Hai due opzioni per integrare il nostro widget:

Come integrare manualmente il widget del marchio?

Integrazione automatica dei widget di marca e prodotto

L'integrazione automatica è valida solo per i clienti che hanno l'ultima versione della piattaforma Recensioni Verificate e funziona solo per integrare un widget flottante. 

In qualsiasi momento, puoi disattivare l'integrazione automatica.

La rimozione di un widget di marca dal back office annulla automaticamente qualsiasi integrazione automatica se era in atto.

Esporta i miei ordini (versione 9.0.0)

In caso di perdita temporanea dell'automazione, puoi generare un file CSV con i tuoi ordini passati per recuperarti.

Ogni esportazione contiene un massimo di 5000 ordini. Una volta effettuata la prima esportazione, gli ordini inclusi nel file vengono considerati recuperati dai nostri servizi. Assicurati di caricare correttamente il CSV sulla nostra piattaforma.

Per evitare qualsiasi sovrascrittura, assicurati anche che gli ordini nel file non siano già presenti nel nostro sistema.

Dettagli delle opzioni:

  • Da: puoi recuperare ordini fino a 12 mesi (come definito nei nostri Termini di Servizio).
  • Recupera recensioni dei prodotti: seleziona "sì" se desideri recuperare recensioni dei prodotti per questi ordini (essenziale se desideri sondare i tuoi prodotti).
  • Esporta ordini con stato: puoi selezionare uno o più stati di recupero.

Una volta recuperato il CSV generato, contatta il nostro team di Assistenza Clienti.

  • Pannello e aggiunta di hook

L'opzione "aggiungi tutti gli hook" ti consente di riattaccare gli hook nel caso in cui siano stati registrati in modo errato, ad esempio. Questa funzione è disponibile dalla versione 1.6.

Recupero automatico degli ordini

Processo generale:

Recuperiamo i tuoi ordini in base alle impostazioni che definisci nel tuo account di Opinioni Verificate "Impostazioni Raccolta Recensioni".

Puoi monitorare gli ordini recuperati nel tuo account sotto "Monitoraggio Richiesta di Raccolta Recensioni".

Quando recuperiamo anche i dettagli dei prodotti, il riferimento del prodotto è il ID di Prestashop. Se viene lasciata una recensione sul prodotto, tale recensione verrà associata con l'ID di Prestashop nel tuo account di Opinioni Verificate. Apparirà quindi nel widget del prodotto che viene visualizzato nella pagina del prodotto corrispondente a quell'ID di Prestashop.

Hook di recupero:

Il nostro sistema di recupero ordini si basa sul sistema predefinito di Prestashop: ad ogni convalida di un ordine, lo registriamo eseguendo il hook actionValidateOrder nella nostra tabella av_orders.

Solo gli ordini correttamente registrati in questa tabella sono considerati "idonei" per la trasmissione automatica ai nostri servizi. La trasmissione avviene quando un ordine cambia stato e passa a uno degli stato/i di recupero selezionati nella configurazione.

Affinché gli ordini vengano trasmessi, il metodo di cambio stato nel back-office di Prestashop deve attivare il hook actionOrderStatusPostUpdate.

Google Shopping:

Per poter condividere le tue recensioni dei prodotti su Google Shopping, abbiamo bisogno del GTIN_EAN (Europa) o GTIN_UPC (USA, Canada) che sono i dati più precisi per Google, o se necessario, del duo marca + MPN. È anche importante fornire il marchio e l'MPN anche se hai GTIN: più informazioni possiamo fornire sui tuoi prodotti a Google, più facile sarà per Google associare le recensioni con i prodotti.

Quando recuperiamo ordini, recuperiamo automaticamente le informazioni di Google Shopping sempre che siano correttamente compilate nelle schede prodotto del catalogo nel Back Office di Prestashop.

Log e Avvisi (a partire dalla versione 10.0.0)

Log

I log vengono conservati per 7 giorni nel connettore, con una rotazione giornaliera. Per impostazione predefinita, il modulo registra diversi eventi, tra cui:

  • le risposte di errore delle chiamate effettuate ai nostri servizi
  • i riferimenti degli ordini inviati ai nostri servizi
  • l'esecuzione degli hook su cui opera il connettore

A partire dalla versione 10.0.0 del connettore, sono stati introdotti due livelli aggiuntivi di log. Puoi attivarli/disattivarli nella sezione «Azioni avanzate».

  • Log avanzati: Sono attivati per impostazione predefinita. Ti consigliamo di mantenerli attivati, in quanto facilitano l'indagine di eventuali problemi. Permettono di sapere quali altri moduli sono stati installati/disinstallati dall'installazione del nostro modulo e quali sono collegati agli stessi hook utilizzati dal connettore.
  • Log completi per il debug: Sono disattivati per impostazione predefinita. Ti consigliamo di attivarli solo su richiesta del nostro team di supporto. Questa opzione consente di registrare tutte le modifiche di stato per ogni ordine, per indagare su eventuali problemi relativi alla trasmissione degli ordini.

Il pulsante Esporta log ti permette di esportare con un clic un file in formato .zip che puoi allegare a un ticket di supporto. Il nostro team di supporto potrà così accedere direttamente ai log del connettore per effettuare le necessarie indagini.

Avvisi

In caso di malfunzionamenti gravi del connettore, questo mostrerà un avviso nel tuo account Prestashop. Dal pannello di controllo e dal gestore dei moduli, un messaggio di avviso ti informerà di un potenziale problema. Un link ti porterà direttamente alla pagina di configurazione del modulo dove potrai consultare i dettagli dell'avviso. Per ogni avviso, è disponibile un link alla documentazione con le prime azioni consigliate.

4 tipi di errori possono generare un avviso:

  1. Errore durante l'installazione del connettore
  2. Errori nelle risposte delle chiamate ai nostri servizi
  3. Impossibilità di scrivere log
  4. Incoerenza tra gli stati di recupero degli ordini selezionati nella configurazione e le modifiche di stato nell'account Prestashop: questo avviso può apparire se trascorrono 15 giorni senza alcun ordine negli stati configurati.

Raccomandazioni tecniche

Questa documentazione presenta le opzioni disponibili nell'ultima versione del modulo. È sempre consigliato aggiornare il tuo modulo per beneficiare di nuove funzionalità/correzioni di bug e controllare regolarmente che il connettore stia trasmettendo correttamente gli ordini effettuati sul tuo sito.

Aggiornamento del modulo

Se il tuo modulo è stato personalizzato (sovrascritture, file del modulo modificati, ecc.), assicurati di eseguire un backup dei file prima di aggiornare e prova l'aggiornamento in un sito di pre-produzione prima di aggiornare il tuo sito principale.

Nel caso di un aggiornamento del modulo alla versione 9.0.0 o successiva del connettore, si consiglia vivamente di leggere questo articolo: https://help.rr.skeepers.com/hc/it/articles/14666167026332-%C3%88-disponibile-la-nuova-versione-del-tuo-connettore-Prestashop-come-ottenerla-e-beneficiare-degli-ultimi-miglioramenti-del-prodotto. Descrive in dettaglio i numerosi vantaggi e le importanti modifiche da considerare per ottenere l'aggiornamento più soddisfacente possibile.

Nel caso di un aggiornamento del modulo alla versione 10.0.0 o successiva del connettore, Le consigliamo di verificare che non vi sia alcun codice legacy del modulo nei Suoi file /override/classes/Product.php e themes/il_suo_tema/product_list.tpl. Se presente, dovrà rimuovere il codice prima di procedere con l'aggiornamento del modulo.

Modifiche nella struttura del tuo sito (solo se la tua versione del connettore è inferiore a 9.0.0)

Comunichiamo con il tuo sito tramite un'API URL. Questa URL API corrisponde al percorso al file netreviewsApi.php situato nella radice del modulo.

Se sposti il modulo all'interno dei tuoi file, o se aggiungi una sottodirectory, assicurati di controllare sempre la connessione e contattare il supporto per modificare l'API URL se necessario.

Ad esempio: se il dominio del tuo sito è https://monsupersitedetest.com e installi il modulo nella radice del sito, l'URL API sarà https://monsupersitedetest.com/netreviewsApi.php.
Se installi il modulo in una sottodirectory denominata "netreviews", l'URL API diventa https://monsupersitedetest.com/netreviews/netreviewsApi.php.

Sincronizzazione della Configurazione di Raccolta e Visualizzazione dei Widget con il tuo Sito Prestashop

Quando salvi una configurazione di raccolta o abiliti l'integrazione automatica di un widget, le modifiche possono richiedere fino a un'ora per essere applicate.

Se desideri applicare immediatamente queste modifiche, puoi forzare la sincronizzazione facendo clic sul pulsante "Recupera" nella sezione Azioni Avanzate della pagina di configurazione del modulo nel Back Office di Prestashop.

 

 

FAQ

Le mie recensioni non vengono visualizzate

Controllo del riferimento prodotto:
Come spiegato in precedenza, il modulo Prestashop utilizza l'ID prodotto di Prestashop come riferimento. Puoi controllare nel tuo account Recensioni Verificate che le tue recensioni siano collegate correttamente agli ID di Prestashop.

In altri casi, ecco i passaggi da seguire se le recensioni non vengono visualizzate:

1. Verifica la connessione tra la nostra piattaforma e il tuo sito accedendo al tuo account Recensioni Verificate, quindi “Gestione account > Il mio Connettore Prestashop”, dove puoi fare clic sul pulsante “Test connessione”. Se ricevi un messaggio di errore, contatta l'assistenza (solo se la tua versione del connettore è inferiore a 9.0.0).

2. Verifica nel tuo account Recensioni Verificate che l'integrazione automatica sia attivata in “Integra i miei widget > Attiva integrazione automatica”.

3. Fai clic sul pulsante “Aggiungi tutti i hook” per registrare nuovamente i hook (pagina di configurazione del modulo nel Back-Office di Prestashop > sezione DEBUG).

4. Cancella tutte le tue cache: cache di Smarty e cache dei plugin (ad esempio, Page Cache Ultimate). Quando cancelli la cache di Smarty, assicurati che l'opzione “Non ricompilare mai il template” non sia selezionata.

Se dopo tutto questo, le recensioni non vengono ancora visualizzate: è probabile che il tuo tema non incorpori i hook a cui ci colleghiamo. Puoi inserire manualmente i nostri hook personalizzati nel tuo template product.tpl:

{hook h='ExtraNetreviews'} per visualizzare le stelle
{hook h='TabcontentNetreviews' product=$product} per visualizzare il blocco recensioni

Per quanto riguarda le stelle nelle pagine delle categorie, il nostro modulo si collega ai hook:

displayProductListReviews se la versione di Prestashop è < 1.7
displayProductPriceBlock (type="before_price") se la versione di Prestashop è > 1.7

Dopo aver attivato questa opzione, se le stelle (nell'elenco dei prodotti) non compaiono ancora: significa che questi hook non sono presenti nel tuo tema. In questo caso, puoi aggiungere direttamente il nostro hook personalizzato {hook h='CategorystarsNetreviews' product=$product} nel file product-list.tpl (Prestashop < 1.7) o nel file delle miniature dei prodotti (nel tema predefinito di Prestashop 1.7, il percorso del file è themes/classic/templates/catalog/_partials/miniatures/product.tpl).

La visualizzazione delle mie recensioni sui prodotti è rotta

Questo è solitamente un problema di cache.

Nella pagina di configurazione del modulo nel Back-Office di Prestashop > sezione DEBUG, fai clic sul pulsante “Aggiungi tutti i hook” per registrare nuovamente i hook e quindi cancella tutte le cache: cache di Smarty e cache dei plugin (ad esempio, Page Cache Ultimate). Quando cancelli le cache di Smarty, assicurati che l'opzione “Non ricompilare mai il template” non sia selezionata.

Voglio spostare le mie recensioni

Le nostre stelle nelle pagine dei prodotti e delle categorie, così come il blocco recensioni, normalmente compaiono automaticamente.

Se la loro posizione non è soddisfacente e desideri spostarle, puoi farlo seguendo questi passaggi:

1. Sganciare i hook rilevanti

Per farlo, dalla pagina di configurazione del modulo, fai clic su Hooks

Seleziona l'opzione “Mostra hook invisibili” per visualizzare tutti i hook associati al modulo.

Per disabilitare la visualizzazione automatica delle stelle sulle pagine dei prodotti, sgancia “displayProductButtons,” “displayLeftColumnProduct” e “displayRightColumnProduct”.

Per disabilitare la visualizzazione automatica del blocco recensioni nelle schede delle pagine dei prodotti, sgancia “displayProductExtraContent”.

Per disabilitare la visualizzazione automatica delle recensioni nei miniatura dei prodotti nelle pagine delle categorie, sgancia “displayProductPriceBlock” e “displayProductListReviews”.

2. Inserire manualmente i nostri hook personalizzati

Pagine prodotto: nel tuo file product.tpl, aggiungi:

{hook h='ExtraNetreviews'} per visualizzare le stelle

{hook h='TabcontentNetreviews' product=$product} per visualizzare il blocco recensioni

Pagine delle categorie: nel file product-list.tpl (Prestashop < 1.7) o nel file delle miniature dei prodotti (nel tema predefinito di Prestashop 1.7, il percorso del file è themes/classic/templates/catalog/_partials/miniatures/product.tpl), aggiungi:

{hook h='CategorystarsNetreviews' product=$product}

I miei ordini non vengono recuperati

1. Verifica la connessione tra la nostra piattaforma e il tuo sito: dal menu laterale sinistro, vai su Recensioni Verificate, poi Raccolta delle Recensioni e Configurazione. Clicca sul pulsante Testa Connessione o su Invia Configurazione. Se ricevi un messaggio di errore, contatta il nostro team Care tramite l'icona di contatto disponibile in basso a destra della pagina (solo se la tua versione del connettore è inferiore alla 9.0.0).

2. Verifica che l’automazione sia attivata correttamente: dal menu laterale sinistro, vai su Recensioni Verificate, poi Raccolta delle Recensioni e Configurazione.

3. Assicurati che gli ordini da trasmettere abbiano gli stessi stati di quelli selezionati nel tuo account Recensioni Verificate: menu laterale sinistro, Raccolta delle Recensioni, e Configurazione.

4. Conferma che il metodo che utilizzi per cambiare gli stati degli ordini attivi correttamente il hook actionOrderStatusPostUpdate.

Dopo aver effettuato queste verifiche, se il problema persiste, contatta il nostro team Care tramite l'icona di contatto.

 

Questo articolo ti è stato utile?
Utenti che ritengono sia utile: 0 su 0