Collegare il tema e pubblicare i file AI

Prima di iniziare

• Completa la prima configurazione.
• Tieni aperta un’altra scheda con l’Admin di Shopify: alcune azioni aprono l’editor del tema.

Tutto quello che segue si trova in Shopify Admin › App › IFG GEO Optimizer › Audit catalogo › Integrazione e struttura. Le sezioni sono in quest’ordine; accanto al titolo di ognuna c’è un’icona «i» che apre una spiegazione breve con un esempio.

Verificare il blocco GEO Schema

La sezione Integrazione con il tema mostra lo stato del blocco: Attivo, Non attivo o Non ancora verificato.

1. Se lo stato non è Attivo, premi Apri editor del tema ↗.
2. Nell’editor del tema attiva GEO Schema tra gli app embed e premi Salva.

3. Torna nell’app e premi Verifica attivazione.

   Cosa vedrai: lo stato diventa Attivo. Il controllo guarda solo il tema pubblicato, non le bozze.

Suggerimento: nell’editor del tema il blocco GEO Schema ha una sola opzione, Condizione predefinita del prodotto: Nuovo (valore di partenza), Usato, Ricondizionato o Danneggiato. Vale per i prodotti senza un tag di condizione; se un prodotto ha un tag come «usato», vince il tag.

Controllare il tema

Questi controlli leggono i file del tema e non cambiano nulla. Se un controllo dice «parziale» o «riprova tra poco», rilancialo: di solito è un intoppo momentaneo.

1. In Conflitti di schema JSON-LD premi Controlla conflitti JSON-LD nel tema.

   Cosa vedrai: «Nessun conflitto rilevato: né theme.liquid né le sezioni del tuo tema dichiarano già nessuno di questi schemi.» oppure un riquadro «Il tuo tema ha già un proprio schema Product» con il file del tema dove l’ha trovato.

2. In Blocchi Custom Liquid nascosti premi Controlla blocchi Custom Liquid nascosti nel tema.

   Cosa vedrai: «Nessun blocco Custom Liquid nascosto rilevato nei template del tuo tema.» oppure l’elenco dei blocchi sospetti, con il testo nascosto e la sezione del tema dove si trova. L’app non modifica né rimuove mai il contenuto del tema: decidi tu.

3. In Contenuti duplicati premi Controlla contenuti duplicati. Confronta pagine e articoli del blog e trova quelli che parlano dello stesso argomento con indirizzi diversi.

Nota: se il controllo dei conflitti trova uno schema del tema dello stesso tipo, l’app consiglia di tenere quello del tema. Il blocco GEO Schema si attiva e disattiva tutto insieme dall’editor del tema: se non sai quale tenere, scrivici dall’assistenza.

Sul piano Unlimited trovi altri due controlli, che usano l’AI e hanno un limite mensile:

• Contraddizioni fattuali tra pagine (20 al mese): confronta i testi del tema con un campione di descrizioni prodotto e mostra le frasi che si contraddicono. Premi Controlla contraddizioni fattuali.
• Statistiche non citate (25 al mese): cerca in pagine e articoli del blog numeri precisi senza una fonte vicina. Premi Controlla statistiche non citate.

Su Free e Grow queste due sezioni sono visibili ma bloccate, con il pulsante per passare a Unlimited. Contenuti duplicati ha un limite mensile per piano: 10 su Free, 50 su Grow, 150 su Unlimited.

Generare i file per gli agenti AI

Tre file descrivono il negozio agli agenti software e alle integrazioni:

• llms.txt: l’elenco di prodotti e collezioni, una riga per prodotto con nome, prezzo e link.
• llms-full.txt: la versione completa, con descrizioni intere, codici, specifiche e FAQ approvate.
• agents.md: le istruzioni per gli agenti di acquisto (come navigare il catalogo, regole di checkout, politiche del negozio).

Nota: oggi questi file servono soprattutto ad agenti di sviluppo e integrazioni. Non risulta che aumentino le citazioni su ChatGPT o Perplexity. I file vengono sempre scritti in inglese, la lingua che i motori AI interpretano in modo più affidabile.

1. In llms.txt — indice per i motori AI premi Genera anteprima.

   Cosa vedrai: l’anteprima del file e l’URL pubblico con il pulsante Copia URL. Per vedere il testo intero premi Mostra anteprima completa.

2. Fai lo stesso in llms-full.txt — catalogo completo per agenti AI e in agents.md — guida per gli agenti AI di shopping.
3. Quando cambi prodotti o prezzi, premi Aggiorna anteprima per rigenerare l’anteprima.

Pubblicare i file sul tema

La sezione Pubblica file AI sul tema attivo scrive i tre file sul tema pubblicato, così diventano raggiungibili all’indirizzo del tuo negozio: tuosito.com/llms.txt, tuosito.com/llms-full.txt e tuosito.com/agents.md.

Attenzione: questa azione scrive file nel tema pubblicato del negozio. Se un’altra app ha già scritto uno di questi file, l’app non lo tocca senza la tua conferma.

1. Premi Pubblica sul tema attivo.

   Cosa vedrai: «File AI pubblicati sul tema attivo.» e, sotto «Disponibili su:», i tre indirizzi.

2. Se compare «Un’altra app ha già scritto llms.txt», scegli Sostituisci con IFG per sostituirlo con il file dell’app oppure Annulla per lasciarlo com’è.

I file contengono il catalogo com’era al momento della pubblicazione. Dopo aver cambiato prodotti, prezzi o descrizioni premi di nuovo Pubblica sul tema attivo. Se in seguito pubblichi un tema diverso, l’app riscrive i file sul nuovo tema da sola, a patto che tu li abbia pubblicati almeno una volta con questo pulsante.

Nota: su un catalogo molto grande llms-full.txt può contenere solo una parte dei prodotti, perché Shopify limita la dimensione di un file del tema. L’app te lo dice con il numero di prodotti inclusi.

Verificare i dati azienda online

La sezione Schema Organization mostra un punteggio da 0 a 100 dei dati azienda inseriti in Impostazioni e l’elenco di Cosa manca, per esempio «Partita IVA o numero Registro Imprese».

1. Se manca qualcosa, premi Modifica in Impostazioni e completa i campi (vedi Tutte le impostazioni).

2. Torna qui e premi Verifica online.

   Cosa vedrai: «Verificato: lo schema è online e coincide con i dati configurati.» se la home del negozio mostra gli stessi dati delle impostazioni. Se un dato è diverso, l’app ti dice quale e ti offre Correggi in Impostazioni o Verifica di nuovo.

Se qualcosa non va

La verifica dice «Nessuno schema Organization trovato nella homepage. Verifica che il blocco “GEO Schema” sia attivo nel tema.» Il blocco GEO Schema non è attivo nel tema pubblicato. Attivalo come spiegato all’inizio di questa pagina.

La pubblicazione dice «Accesso negato: l’app non ha ancora il permesso di scrittura sul tema. Rimuovi e reinstalla l’app per concedere il nuovo scope write_themes.» L’installazione non ha il permesso di scrivere sul tema. Rimuovi l’app e installala di nuovo per concederlo: la configurazione va rifatta.

La pubblicazione dice «Nessun tema pubblicato trovato — pubblica un tema nelle impostazioni del negozio prima di procedere.» Nel negozio non c’è un tema pubblicato. Pubblicane uno in Negozio online › Temi e riprova.

I file non sono stati scritti per una «ripetizione anomala». Il testo della descrizione del negozio in Impostazioni sembra rovinato. Correggilo e premi di nuovo Pubblica sul tema attivo.

Prossimo passo

Creare le FAQ dei prodotti