Usare Footnote su una vetrina Catalyst

Controlla la tua versione di Catalyst

Le etichette richiedono Catalyst core 1.4 o successivo. Catalyst carica gli script di Script Manager tramite il suo gestore del consenso ai cookie dalla versione 1.3, e la 1.4 ha aggiunto il posizionamento nell’intestazione e nel corpo della pagina su cui si basa lo script di Footnote. La versione si trova in core/package.json, sotto il nome @bigcommerce/catalyst-core.

Un aggiornamento di Catalyst rilasciato da BigCommerce arriva alla tua vetrina solo quando il tuo sviluppatore lo unisce alla tua copia, quindi una vetrina più vecchia resta sulla sua versione finché qualcuno non la aggiorna.

Mantieni il gestore del consenso nel layout principale

Catalyst carica gli script di Script Manager tramite il componente <ConsentManager> in core/app/[locale]/layout.tsx. Se viene rimosso o sostituito, lo script di Footnote non si carica mai e non compare nessuna etichetta. Footnote non può accorgersene da BigCommerce, quindi Impostazioni continua a indicare la vetrina come coperta.

Lascia lo script nella categoria «Essential»

Footnote aggiunge uno script a Script Manager, chiamato «Footnote AI image labels», con la categoria di consenso «Essential» (essenziale). Il banner dei cookie di Catalyst tratta gli script «Essential» come necessari, quindi lo script si carica prima che il cliente scelga e anche dopo che ha rifiutato i cookie. Non imposta cookie e non raccoglie nulla sui clienti.

Se qualcuno cambia la categoria in «Functional», «Analytics» o «Targeting», i clienti che rifiutano i cookie non vedono più le etichette. Riportala a «Essential» in Script Manager.

Tieni le immagini prodotto sulla CDN di BigCommerce

Footnote trova un’immagine etichettata tramite il suo indirizzo sulla CDN di BigCommerce, che contiene i numeri del prodotto e dell’immagine, ad esempio cdn11.bigcommerce.com/s-abc123/images/stencil/384w/products/157/551/. Catalyst standard mostra le immagini prodotto direttamente da quell’indirizzo, quindi funziona senza modifiche. Funzionano anche le immagini che passano dall’ottimizzazione delle immagini di Next.js (/_next/image?url=...), perché Footnote legge l’indirizzo originale al loro interno.

Le etichette spariscono quando l’indirizzo di un’immagine non contiene più il percorso BigCommerce. Succede con un loader di immagini personalizzato che riscrive l’indirizzo, con un proxy o un altro servizio di immagini davanti alla CDN, o con immagini inserite tramite Makeswift.

Consenti Footnote in una Content Security Policy personalizzata

Catalyst standard non limita le origini da cui si caricano gli script. Se il tuo sviluppatore ha aggiunto regole script-src o connect-src, consenti https://footnote.pouchapps.com in entrambe. Lo script delle etichette si carica da lì e da lì recupera le impostazioni delle tue etichette.

Prevedi fino a un’ora per le modifiche

Catalyst tiene in cache l’elenco degli script di Script Manager fino a un’ora. Dopo l’installazione di Footnote, o dopo qualsiasi modifica alle tue etichette, la vetrina può impiegare tutto quel tempo per aggiornarsi. Su Stencil le stesse modifiche compaiono entro circa un minuto.

Uno sviluppatore può far comparire le modifiche prima in due modi:

• Ripubblicare la vetrina. Un nuovo deploy recupera di nuovo l’elenco degli script. È la soluzione più semplice dopo aver installato Footnote.
• Abbassare DEFAULT_REVALIDATE_TARGET. Il valore è in secondi e per impostazione predefinita è 3600. Stabilisce per quanto tempo Catalyst tiene in cache gran parte dei suoi dati BigCommerce, non solo gli script, quindi un numero più basso significa più richieste a BigCommerce. Abbassalo per i test invece di lasciarlo basso.

Controlla che le etichette compaiano

1. In Footnote, apri Impostazioni e controlla che la tua vetrina Catalyst sia indicata come coperta. Essentials copre solo la tua vetrina predefinita. Pro copre tutte le vetrine.
2. Contrassegna un’immagine come Generata con IA e attiva «Mostra etichette» in Impostazioni.
3. Aspetta fino a un’ora, o chiedi al tuo sviluppatore di ripubblicare.
4. Apri quella pagina prodotto in una finestra di navigazione privata. Se compare un banner dei cookie, rifiuta. L’etichetta dovrebbe trovarsi nell’angolo che hai scelto nella scheda Badge. Su Catalyst compare un attimo dopo la pagina, quando la pagina ha finito di caricare i suoi script.

Per controllare dal browser, apri la console per sviluppatori su una qualsiasi pagina della vetrina ed esegui document.documentElement.dataset.footnote. Se restituisce "1", lo script di Footnote è in esecuzione lì.

Risolvi un’etichetta mancante

Se sei ancora bloccato, scrivi a footnote@pouchapps.com indicando l’indirizzo della tua vetrina, una pagina prodotto che dovrebbe mostrare un’etichetta, la tua versione di Catalyst e il risultato del controllo nella console. La pagina di assistenza elenca i motivi per cui un’etichetta può mancare su qualsiasi vetrina.