Configura Specfinder, passo dopo passo

Prima di iniziare

• Un tema Online Store 2.0 come Horizon o Dawn. Ogni blocco si inserisce nell’editor di temi; il codice del tema non lo tocchi mai.
• L’app gratuita Search & Discovery di Shopify. È l’unico posto in cui si può creare un filtro per il negozio, per questo serve nel passaggio 9. Tutto il resto funziona senza.
• I dati dei tuoi prodotti in fogli di calcolo salvati come CSV. Se non ne hai ancora, il passaggio 4 ti mostra prima un risultato con dati di esempio, e i file di esempio qui sotto ti danno il formato esatto.
• Il piano Full per l’import CSV, i pacchetti iniziali e un selettore dei veicoli con più di 50 veicoli. Tutti i blocchi, il modello dei dati e i dati di esempio sono gratuiti.
• Il tuo settore. Sceglilo nelle schede qui sotto: indicano i nomi da scegliere, i file da importare e i blocchi adatti, con un set completo di file di esempio.

Cosa cambia nel tuo settore

Scegli il tuo settore. La scheda indica i nomi da scegliere nel passaggio 5, i file da importare nel passaggio 6, i filtri e i blocchi che di solito hanno senso, il set di esempio completo e come appare il risultato in un negozio reale.

Ricambi auto e veicoli

Sezioni del pacchetto iniziale (passaggio 5)

Contenuto della confezione · Montaggio · Omologazioni e marcature · Garanzia

Dati di compatibilità (passaggi 5 e 6)

Si chiama: Veicolo (Marca · Modello · Anno da · Anno a · Motore)

Campo prodotto: Veicoli compatibili

Colonne nel file:

handle,make,model,year_from,year_to,engine
vw-golf-vii-1-0-tsi,VW,Golf VII,2012,2020,1.0 TSI

Righe di specifica tipiche

Gruppo ricambi Freni · Posizione di montaggio Asse anteriore · Materiale Ghisa · Diametro 300 mm · Spessore 24 mm

Filtri di esclusione (passaggio 8)

Materiale, per filtri come «senza ceramica». Nel negozio demo una sola proprietà ne dà otto.

Blocchi che di solito sono adatti (passaggio 10)

Tabella delle specifiche, Selettore di compatibilità sopra «Va bene?», Codici, Documenti, Dettagli del prodotto, Cercatore di prodotti, Anteprima rapida.

Set di esempio

• s1-spec-rows.csv70 · righe di specifica
• s1-spec-groups.csv20 · gruppi di specifiche
• s1-compatibility-targets.csv78 · destinazioni di compatibilità
• s1-documents.csv5 · documenti
• s2-group-to-rows.csv70 · gruppi → righe
• s3-product-to-groups.csv20 · prodotti → gruppi
• s3-product-to-targets.csv244 · prodotti → destinazioni
• s3-product-to-documents.csv5 · prodotti → documenti

Scarica il set in ZIP

Origine: 78 veicoli e 244 assegnazioni da Broadstock.

In un negozio reale (Broadstock)

Utensili e industria

Sezioni del pacchetto iniziale (passaggio 5)

Contenuto della confezione · Motore e sistema batteria · Sicurezza e dispositivi di protezione · Documenti

Dati di compatibilità (passaggi 5 e 6)

Si chiama: Dispositivo (Marca · Sistema di batterie · Valido da · Valido fino a · Dispositivo)

Campo prodotto: Dispositivi compatibili

Colonne nel file:

handle,make,model,year_from,year_to,engine
bosch-18v-gsr-18v-60,Bosch,18V Professional,2019,,GSR 18V-60

Qui «model» contiene il sistema di batterie e «engine» il dispositivo.

Righe di specifica tipiche

Alimentazione Batteria 18 V · Sistema di batterie Hallberg 18V · Coppia 70 Nm · Mandrino 13 mm · Peso 1,40 kg

Filtri di esclusione (passaggio 8)

Utile quando un prodotto contiene qualcosa che gli acquirenti vogliono evitare, per esempio un materiale. Molti negozi di utensili ne fanno a meno.

Blocchi che di solito sono adatti (passaggio 10)

Tabella delle specifiche, Documenti (dichiarazioni, manuali), Codici, Dettagli del prodotto, Selettore di compatibilità sopra «Va bene?» per batterie e accessori, Cercatore di prodotti, Anteprima rapida.

Set di esempio

• s1-spec-rows.csv69 · righe di specifica
• s1-spec-groups.csv20 · gruppi di specifiche
• s1-compatibility-targets.csv4 · destinazioni di compatibilità
• s1-documents.csv9 · documenti
• s2-group-to-rows.csv69 · gruppi → righe
• s3-product-to-groups.csv20 · prodotti → gruppi
• s3-product-to-targets.csv4 · prodotti → destinazioni
• s3-product-to-documents.csv9 · prodotti → documenti

Scarica il set in ZIP

Origine: Specifiche e documenti da Broadstock; le quattro destinazioni di compatibilità sono un nostro esempio.

In un negozio reale (Broadstock)

Ufficio e materiali di consumo

Sezioni del pacchetto iniziale (passaggio 5)

Compatibilità · Resa e autonomia · Contenuto della confezione · Sostenibilità e smaltimento

Dati di compatibilità (passaggi 5 e 6)

Si chiama: Stampante (Marca · Serie · Valido da · Valido fino a · Modello)

Campo prodotto: Stampanti compatibili

Colonne nel file:

handle,make,model,year_from,year_to,engine
hp-officejet-pro-9010,HP,OfficeJet Pro,2019,,9010

Qui «model» contiene la serie e «engine» il modello di stampante.

Righe di specifica tipiche

Reparto Forniture per ufficio · Gruppo prodotti Materiali di consumo · Resa in pagine · Colore

Filtri di esclusione (passaggio 8)

Serve di rado. Una proprietà come «Contiene» ti permette di offrire filtri «senza …», se il tuo assortimento ne ha una.

Blocchi che di solito sono adatti (passaggio 10)

Tabella delle specifiche (qui con gruppi ripiegabili), Codici, Documenti (schede di sicurezza), Dettagli del prodotto, Selettore di compatibilità sopra «Va bene?», Cercatore di prodotti, Anteprima rapida.

Set di esempio

• s1-spec-rows.csv70 · righe di specifica
• s1-spec-groups.csv20 · gruppi di specifiche
• s1-compatibility-targets.csv3 · destinazioni di compatibilità
• s1-documents.csv4 · documenti
• s2-group-to-rows.csv70 · gruppi → righe
• s3-product-to-groups.csv20 · prodotti → gruppi
• s3-product-to-targets.csv3 · prodotti → destinazioni
• s3-product-to-documents.csv4 · prodotti → documenti

Scarica il set in ZIP

Origine: Specifiche e documenti da Broadstock; le tre stampanti sono un nostro esempio.

In un negozio reale (Broadstock)

Tecnologia

Sezioni del pacchetto iniziale (passaggio 5)

Contenuto della confezione · Compatibilità · Garanzia · Documenti

Dati di compatibilità (passaggi 5 e 6)

Si chiama: Dispositivo (Produttore · Gamma · Valido da · Valido fino a · Modello)

Campo prodotto: Dispositivi compatibili

Colonne nel file:

handle,make,model,year_from,year_to,engine
apple-macbook-air-13-m2,Apple,MacBook Air,2022,,13-inch M2

Qui «make» contiene il produttore, «model» la gamma e «engine» il modello.

Righe di specifica tipiche

Gruppo prodotti Periferiche di input · Connessione USB-C · Layout Tenkeyless · Switch Tactile brown · Peso 0,78 kg

Filtri di esclusione (passaggio 8)

Serve di rado. Qui di solito contano di più gli intervalli derivati («almeno 120 W»).

Blocchi che di solito sono adatti (passaggio 10)

Tabella delle specifiche, Tabella di confronto, Dettagli del prodotto (qui a schede), Codici, Documenti, Cercatore di prodotti, Anteprima rapida.

Set di esempio

• s1-spec-rows.csv70 · righe di specifica
• s1-spec-groups.csv20 · gruppi di specifiche
• s1-compatibility-targets.csv3 · destinazioni di compatibilità
• s1-documents.csv2 · documenti
• s2-group-to-rows.csv70 · gruppi → righe
• s3-product-to-groups.csv20 · prodotti → gruppi
• s3-product-to-targets.csv3 · prodotti → destinazioni
• s3-product-to-documents.csv2 · prodotti → documenti

Scarica il set in ZIP

Origine: Specifiche e documenti da Broadstock; i tre dispositivi sono un nostro esempio.

In un negozio reale (Broadstock)

Moda

Sezioni del pacchetto iniziale (passaggio 5)

Taglia e vestibilità · Materiale · Cura · Spedizione e resi

Dati di compatibilità (passaggi 5 e 6)

Non si usano in questo settore. Salta il file di compatibilità nel passaggio 6; il Selettore di compatibilità e «Va bene?» non servono.

Righe di specifica tipiche

Materiale Laminato a 3 strati · Cura Lavaggio in lavatrice a 30 °C · Peso 0,42 kg · Colonna d’acqua 20.000 mm

Filtri di esclusione (passaggio 8)

Materiale, per filtri come «senza lana» o «senza poliestere».

Blocchi che di solito sono adatti (passaggio 10)

Dettagli del prodotto (le sezioni del pacchetto iniziale, qui come elenco aperto), Tabella delle specifiche, Cercatore di prodotti, Anteprima rapida.

Set di esempio

• s1-spec-rows.csv70 · righe di specifica
• s1-spec-groups.csv20 · gruppi di specifiche
• s2-group-to-rows.csv70 · gruppi → righe
• s3-product-to-groups.csv20 · prodotti → gruppi

Scarica il set in ZIP

In un negozio reale (Broadstock)

Cosmetica

Sezioni del pacchetto iniziale (passaggio 5)

Ingredienti (INCI) · Modo d’uso · Tipo di pelle · Benefici

Dati di compatibilità (passaggi 5 e 6)

Non si usano in questo settore. Salta il file di compatibilità nel passaggio 6; il Selettore di compatibilità e «Va bene?» non servono.

Righe di specifica tipiche

Volume 30 ml · Tipo di pelle Con imperfezioni · Profumo Senza · Vegano Sì · Principio attivo Niacinamide 10 %

Filtri di esclusione (passaggio 8)

Una proprietà come «Contiene», per filtri come «senza profumo» o «senza parabeni».

Blocchi che di solito sono adatti (passaggio 10)

Dettagli del prodotto (le sezioni del pacchetto iniziale), Tabella delle specifiche, Cercatore di prodotti, Anteprima rapida.

Set di esempio

• s1-spec-rows.csv70 · righe di specifica
• s1-spec-groups.csv20 · gruppi di specifiche
• s2-group-to-rows.csv70 · gruppi → righe
• s3-product-to-groups.csv20 · prodotti → gruppi

Scarica il set in ZIP

In un negozio reale (Broadstock)

Alimentari

Sezioni del pacchetto iniziale (passaggio 5)

Ingredienti · Valori nutrizionali · Allergeni · Origine e conservazione

Dati di compatibilità (passaggi 5 e 6)

Non si usano in questo settore. Salta il file di compatibilità nel passaggio 6; il Selettore di compatibilità e «Va bene?» non servono.

Righe di specifica tipiche

Origine Brasile / Colombia · Da consumarsi preferibilmente entro 12 mesi · Bio No · Contiene Nessuno · Peso netto 1000 g

Filtri di esclusione (passaggio 8)

Allergeni, indicati come ciò che un prodotto contiene («Contiene: glutine, frutta a guscio»), per filtri come «senza glutine» o «senza frutta a guscio». Shopify non può filtrare per ciò che manca; l’app lo deriva. Il cercatore li offre come caselle di spunta.

Blocchi che di solito sono adatti (passaggio 10)

Dettagli del prodotto (le sezioni del pacchetto iniziale), Tabella delle specifiche, Cercatore di prodotti con esclusioni, Anteprima rapida.

Set di esempio

• s1-spec-rows.csv80 · righe di specifica
• s1-spec-groups.csv20 · gruppi di specifiche
• s2-group-to-rows.csv80 · gruppi → righe
• s3-product-to-groups.csv20 · prodotti → gruppi

Scarica il set in ZIP

In un negozio reale (Broadstock)

Lusso e gioielleria

Sezioni del pacchetto iniziale (passaggio 5)

Composizione · Cura · Certificato · Spedizione e resi

Dati di compatibilità (passaggi 5 e 6)

Non si usano in questo settore. Salta il file di compatibilità nel passaggio 6; il Selettore di compatibilità e «Va bene?» non servono.

Righe di specifica tipiche

Materiale Oro giallo 18 kt · Cura Lucidare con un panno morbido · Certificato Incluso · Carati 0,30 ct · Misura anello 54

Filtri di esclusione (passaggio 8)

Metallo, per filtri come «senza nichel».

Blocchi che di solito sono adatti (passaggio 10)

Dettagli del prodotto (le sezioni del pacchetto iniziale), Tabella delle specifiche, Documenti (certificati), Cercatore di prodotti, Anteprima rapida.

Set di esempio

• s1-spec-rows.csv70 · righe di specifica
• s1-spec-groups.csv20 · gruppi di specifiche
• s1-documents.csv3 · documenti
• s2-group-to-rows.csv70 · gruppi → righe
• s3-product-to-groups.csv20 · prodotti → gruppi
• s3-product-to-documents.csv3 · prodotti → documenti

Scarica il set in ZIP

In un negozio reale (Broadstock)

I dodici passaggi, in quest’ordine

Seguili in quest’ordine. La pagina «Per iniziare» (Getting started) dell’app segue lo stesso ordine e segna ogni passaggio come «Fatto» (Done), «Da fare» (Open), «Non ancora» (Not yet) o «Non lo so» (Cannot tell); legge il tuo negozio, quindi ciò che lì manca manca davvero. La parte di riferimento sotto i passaggi spiega nel dettaglio il modello dei dati, ogni campo e le regole dell’import.

1. 01Installa l’app e apri «Per iniziare»

   Installa Shopatch Specfinder dallo Shopify App Store. L’app chiede accesso a prodotti, negozio online e dati personalizzati, e a nient’altro.

   Un clic sul nome dell’app nel tuo admin apre la «Panoramica» (Overview). La pagina «Per iniziare» (Getting started) elenca ogni passaggio e porta alla pagina in cui lo esegui.

   

   

2. 02Scegli il piano

   Free comprende tutti e nove i blocchi, il modello dei dati e i filtri ricavati. Full (29 USD ogni 30 giorni) aggiunge l’import CSV, i pacchetti iniziali e un selettore dei veicoli con fino a circa 1.400 veicoli invece di 50.

   «Piano» (Plan) → «Sottoscrivi a 29 USD ogni 30 giorni» (Subscribe) apre la pagina di approvazione di Shopify; l’importo compare sulla tua fattura Shopify. Per disdire non serve disinstallare, vedi la fine di questa guida.

   

3. 03Crea i campi

   «Configurazione» (Setup) → «Crea 13 definizioni» (Create 13 definitions). Un clic crea i sei tipi di record e i sette campi descritti nella parte di riferimento: in un negozio nuovo sono tredici definizioni. Appartengono al tuo negozio e restano anche se rimuovi l’app.

   Ripeterlo non fa danni: ciò che esiste resta intatto e viene indicato come «già presente». Se non manca nulla, il pulsante dice «Niente da fare, controlla comunque» (Nothing to do, check anyway).

   

4. 04Prima guarda un risultato (facoltativo)

   «Import» → «Creare dati di esempio» (Create example data) scrive due righe di specifica e due gruppi, li collega e li aggancia a un prodotto attivo. «Guardare il prodotto» (Look at the product) lo apre nella pagina del prodotto dell’admin di Shopify, dove il campo Specifiche è compilato.

   «Rimuovere i dati di esempio» (Remove example data again) cancella tutto. Ogni handle di esempio contiene la parola «example», quindi nessuno dei tuoi dati viene toccato.

   

   

   

5. 05Dai un nome ai dati di compatibilità e scegli un pacchetto iniziale

   «Configurazione» (Setup) → «Dai un nome ai tuoi dati di compatibilità» (Name your compatibility data): scegli le denominazioni del tuo settore (vedi la tua scheda) e fai clic su «Rinomina» (Rename). Marca, Modello, Motore per i veicoli; Marca, Serie, Modello per le stampanti; e così via. Cambiano solo le etichette: voci, collegamenti, filtri e link di filtro condivisi continuano a funzionare.

   «Configurazione» → «Pacchetto iniziale» (Starter pack): scegli il tuo settore e fai clic su «Anteprima» (Preview). Togli la spunta alle sezioni che non ti servono e rinomina quelle che vuoi chiamare diversamente, poi «Crea il pacchetto iniziale» (Create starter pack). Le sezioni compaiono nel blocco Dettagli del prodotto esattamente in quest’ordine, su ogni prodotto. Eseguire di nuovo un pacchetto non cancella mai una sezione; un’etichetta che modifichi viene sostituita. Per creare il pacchetto iniziale serve Full; l’anteprima funziona anche con il piano gratuito.

   

   

   

   Attenzione: I settori senza dati di compatibilità saltano la denominazione e passano direttamente al pacchetto iniziale.

6. 06Importa i tuoi dati

   Procedi con le tre sezioni della pagina «Import» nell’ordine: record, poi collegamenti tra record, poi l’assegnazione ai tuoi prodotti. I file del tuo settore sono nella sua scheda qui sopra. Le regole di ogni sezione sono in «Riferimento: le tre sezioni dell’import», il formato dei file in «Riferimento: formato CSV».

   

   Sezione 1: i record

   Scegli il «Tipo di record» (Record type), controlla il riquadro «Modello» (Template), scegli il file e fai clic su «Avvia l’import» (Start import). Gli errori compaiono subito sotto la sezione. Poi scorri fino a «Ultime esecuzioni» (Recent runs) e aspetta che la riga dica «fatto» (done).

   

   

   

   Attenzione: Dopo ogni import il tipo di record torna alla prima voce.

   Sezione 2: collegamenti tra record

   Scegli il file. Se la sua intestazione appartiene a un’altra sezione, l’app lo dice subito. Lascia spuntato «Mostrare soltanto, non scrivere» (Only show, write nothing), fai clic su «Leggi le assegnazioni» (Read assignments), controlla i numeri, togli la spunta e fai di nuovo clic su «Leggi le assegnazioni».

   

   

   Attenzione: «… non trovati e saltati» significa che i record non esistono ancora. Importali prima nella sezione 1.

   Sezione 3: l’assegnazione ai tuoi prodotti

   Scegli il «Campo di destinazione» (Target field), scegli il file, togli la spunta alla simulazione quando i numeri tornano e fai clic su «Leggi le assegnazioni». Ripeti per ogni campo: gruppi, compatibilità, documenti.

   

   Attenzione: Il campo di destinazione parte dalla prima voce. Controllalo prima di ogni file.

7. 07Controlla nell’admin di Shopify

   «Contenuti» → «Metaoggetti» (Content → Metaobjects) → apri un tipo di record per vederne le voci. «Prodotti» (Products) → un prodotto → il riquadro «Metacampi del prodotto» (Product metafields) mostra cosa gli è collegato.

   

   

   Attenzione: Dopo un import in blocco, la colonna «Voci» (Entries) nella panoramica dei metaoggetti può restare indietro per ore. Apri il tipo di record per vedere l’elenco reale.

8. 08Deriva i filtri

   «Filtri» (Filters) → «Rendere filtrabili le tue proprietà» (Make properties filterable) → «Anteprima» (Preview) → «Crea N filtri» (Create N filters), dove N è il numero delle proprietà. Ogni etichetta di riga diventa un campo filtrabile sul prodotto; i numeri diventano intervalli, quindi «almeno 120 W» trova 120, 180 e 250. Non devi impostare nessuna soglia.

   «Filtri di esclusione» (Exclusion filters): scegli una proprietà con pochi valori ricorrenti, come Materiale o Contiene, poi «Anteprima» e crea. Shopify non può filtrare per ciò che un prodotto non contiene; l’app deriva un campo «senza …» da ciò che contiene.

   Quando in seguito i prodotti cambiano, la pagina Filtri e «Per iniziare» indicano quante proprietà sono interessate, e con un clic le derivi di nuovo. Finché qualcosa non è aggiornato, l’app ti manda anche un’email, al massimo una volta al giorno.

   Un’esclusione che non ti serve più la togli nella stessa pagina sotto «Rimuovere le esclusioni» (Remove exclusions): l’anteprima mostra cosa sparisce, poi vengono tolti il campo derivato e i suoi valori. Le tue specifiche non vengono toccate.

   

   

   

   Attenzione: I dati di compatibilità per il selettore vengono salvati in automatico dopo un import; la pagina Filtri lo conferma nel riquadro «Albero di compatibilità» (Compatibility tree) con il numero di voci.

9. 09Aggiungi i filtri in Search & Discovery

   I filtri del negozio stanno nell’app gratuita Search & Discovery di Shopify, e nessuna app può crearli lì. La pagina Filtri elenca nel riquadro «I filtri funzionano nel negozio?» (Are the filters live in the shop?) ogni proprietà derivata che non ha ancora un filtro, con nome e chiave, un elenco da copiare con «Copiare l’elenco» (Copy the list) e il pulsante «Aprire Search & Discovery» (Open Search & Discovery).

   In Search & Discovery: Filtri → Aggiungi filtro (Filters → Add filter) → fonte «Metacampo prodotto» (Product metafield) → la chiave dell’elenco → Salva (Save). Il nome del filtro lo scegli tu, la chiave no. Aggiungi un filtro per ogni proprietà che vuoi far usare ai clienti.

   

   

   Attenzione: Finché il tuo negozio è protetto da password, l’app non vede quali filtri arrivano e lo dice («Non lo so») invece di tirare a indovinare.

10. 10Posiziona i blocchi

    «Per iniziare» (Getting started) → «Inserire il blocco» (Add the block) apre l’editor di temi con la tabella delle specifiche già nella tua pagina prodotto. Gli altri blocchi sono sotto «Aggiungi blocco» → «App» (Add block → Apps). Alla fine fai clic su «Salva» (Save). Ogni blocco e le sue impostazioni sono descritti più sotto.

    Per la compatibilità, metti il Selettore di compatibilità sopra «Va bene?» (Does it fit?): la risposta ha bisogno di un veicolo o di un dispositivo scelto.

    L’anteprima rapida è un incorporamento app per tutto il tema, non un blocco. «Attivare l’anteprima rapida» (Turn on Quick view) apre il suo interruttore in «Incorporamenti app» (App embeds); poi salva.

    

    

11. 11Controlla il tuo negozio

    I filtri di Search & Discovery compaiono nelle tue collezioni, l’anteprima rapida si apre dalle schede prodotto e nella pagina prodotto il cliente sceglie un veicolo e riceve una risposta chiara.

    

    

    

12. 12Traduci (facoltativo)

    Aggiungi una lingua in Impostazioni → Lingue (Settings → Languages). «Filtri» → «Apri Localizzazione» (Open Localization) porta a Translate & Adapt di Shopify: nomi dei filtri, valori dei record e tutto quello che hai scritto nei blocchi si traducono come qualsiasi altro contenuto del negozio.

    I campi che lasci vuoti in un blocco non hanno bisogno di traduzione: il blocco mostra il proprio testo nella lingua in cui il cliente sta leggendo.

    

Come si collegano i dati

Specfinder salva i tuoi dati come metaoggetti e metacampi del prodotto di Shopify. Sembra tecnico, ma l’idea è semplice: piccoli record che rimandano l’uno all’altro, e un prodotto che rimanda ai record che lo descrivono.

Una riga di specifica è una riga della tabella: etichetta, valore, unità, per esempio «Diametro · 300 · mm». Le righe si raccolgono in un gruppo di specifiche, per esempio «Dimensioni». Il prodotto rimanda ai suoi gruppi. Per questo l’ordine conta: le righe devono esistere prima che un gruppo possa elencarle, e i gruppi devono esistere prima che un prodotto possa rimandarvi.

Una destinazione di compatibilità è una cosa a cui un prodotto va bene: un veicolo, una stampante, un dispositivo. Il prodotto rimanda a ogni destinazione a cui va bene. Il Selettore di compatibilità e «Va bene?» leggono proprio questi collegamenti.

Un documento è una scheda tecnica, una dichiarazione o un manuale, come file caricato o come link. Il prodotto rimanda ai suoi documenti.

Le sezioni di dettaglio sono i titoli di blocchi di testo come Garanzia o Spedizione e resi, con un testo facoltativo valido per ogni prodotto. Un dettaglio prodotto è il testo di una sezione per un prodotto. Il prodotto rimanda ai suoi dettagli prodotto. Le sezioni le crea per te il pacchetto iniziale.

I codici (codice OE e codice produttore) sono semplici campi di testo sul prodotto. SKU e codice a barre vengono dalla variante del prodotto, come in qualsiasi negozio Shopify.

Perché l’ordine conta

1. Prima i record (sezione 1 dell’import): righe, gruppi, destinazioni di compatibilità, documenti. Nulla può rimandare a un record che non esiste ancora.
2. Poi i collegamenti tra record (sezione 2 dell’import): quali righe appartengono a quale gruppo. Se salti questo passaggio, un prodotto mostra una tabella delle specifiche vuota.
3. Poi i collegamenti ai prodotti (sezione 3 dell’import): quali gruppi, destinazioni e documenti appartengono a quale prodotto. Solo ora compare qualcosa nel tuo negozio.
4. Poi i filtri (passaggio 8), perché vengono derivati dai valori che ora i prodotti portano.

I tipi di record

Sei tipi di record, creati nel passaggio 3. Quattro arrivano da un file CSV nella sezione 1 dell’import. Gli altri due sono blocchi di testo e si gestiscono nell’admin. I nomi delle colonne di un file sono le chiavi dei campi nella prima colonna qui sotto, scritte esattamente così, in minuscolo e uguali in ogni lingua.

I campi prodotto

Il passaggio 3 crea anche questi campi. I campi prodotto sono fissati, quindi compaiono su ogni prodotto dell’admin nel riquadro Metacampi del prodotto.

I filtri derivati nel passaggio 8 aggiungono altri campi sotto specs (f_… per le proprietà, x_… per le esclusioni). Li scrive l’app; non li compili mai tu.

Le tre sezioni dell’import

La pagina Import ha una sezione per ogni tipo di file. È la riga di intestazione del file a decidere a quale sezione appartiene; l’app la legge appena scegli il file e ti avvisa se va da un’altra parte.

Formato CSV

L’app legge quello che scrivono Excel, Numbers, LibreOffice e Fogli Google. Queste sono le regole che applica.

File di esempio

Ogni file di questa pagina è stato letto con il parser dell’app e ne supera i controlli: colonne note, campi obbligatori compilati, handle univoci, e ogni collegamento nelle sezioni 2 e 3 rimanda a un handle della sezione 1. I nomi dei file iniziano con la sezione dell’import a cui appartengono. I contenuti sono in inglese, come il negozio demo.

Un modello per ogni tipo di caricamento

File piccoli che mostrano il formato di ogni caricamento con due o tre righe.

• s1-spec-rows.csvSezione 1, tipo di record Riga di specifica
• s1-spec-groups.csvSezione 1, tipo di record Gruppo di specifiche
• s1-compatibility-targets.csvSezione 1, tipo di record Veicolo / Stampante / Dispositivo
• s1-documents.csvSezione 1, tipo di record Documento
• s2-group-to-rows.csvSezione 2, campo di destinazione sp_spec_group.rows
• s3-product-to-groups.csvSezione 3, campo di destinazione specs.groups
• s3-product-to-targets.csvSezione 3, campo di destinazione fitment.vehicles
• s3-product-to-documents.csvSezione 3, campo di destinazione details.documents

Tutti i modelli in ZIP

Un set completo per il tuo settore

I dati completi di dieci prodotti per settore dal nostro negozio demo Broadstock, gli stessi che vedi nelle schermate della vetrina. I set si trovano nella scheda del tuo settore. ↑

Attenzione: Gli handle dei prodotti nei file della sezione 3 sono quelli di Broadstock. Nel tuo negozio sostituiscili con i tuoi handle o SKU, altrimenti l’app li segnala come non trovati.

I blocchi del tema

Otto blocchi e un incorporamento app. Tutti si aggiungono nell’editor di temi sotto Aggiungi blocco → App, e ognuno legge i campi descritti sopra. Ogni impostazione è elencata con le sue opzioni; i valori predefiniti sono indicati. I nomi seguono la lingua del tuo admin: qui trovi quelli italiani, come compaiono nell’editor di temi in italiano, e tra parentesi quelli inglesi delle immagini.

Tabella delle specifiche(Specification table)

Cosa mostra

La tabella delle specifiche del prodotto: i suoi gruppi con le relative righe e, se vuoi, un pulsante «Salva per dopo» per il confronto.

Dove va

Pagine prodotto.

Cosa gli serve

specs.groups compilato sul prodotto (sezioni dell’import da 1 a 3).

Impostazioni

Impostazione	Opzioni	A cosa serve
Titolo	testo libero
Livello di titolo	H2 (predefinito) · H3	Fa parte della struttura del documento, non è decorazione. Se la sezione attorno a questo blocco ha già un titolo, scegli H3: due H2 di fila sono un errore di struttura, e solo uno screen reader lo rivela.
Fonte	testo libero (predefinito: specs.groups)	Dove stanno le specifiche, come spazio_dei_nomi.chiave. Lascialo com’è, a meno che tu non le tenga altrove.
Mostra le unità	attivo / disattivo (predefinito: attivo)
Ordine delle righe	Come le hai inserite (predefinito) · Alfabetico	«Come le hai inserite» conserva l’ordine che hai dato alle righe, di solito quello che ha senso.
Gruppi
Mostra i titoli dei gruppi	attivo / disattivo (predefinito: attivo)
I gruppi si possono ripiegare	attivo / disattivo (predefinito: disattivo)	Conviene da circa sei gruppi in su. Funziona senza JavaScript, e tutto resta raggiungibile da tastiera.
Apri il primo gruppo	attivo / disattivo (predefinito: attivo)
Presentazione
Densità	Normale (predefinito) · Compatta
Quando non ci sono dati	Nascondi il blocco (predefinito) · Lascia lo spazio	Nascondere è il comportamento predefinito: una scatola vuota in un negozio finito sembra un errore, un blocco assente è al massimo una lacuna.
Tabella di confronto
Mostra il pulsante «Salva per dopo»	attivo / disattivo (predefinito: attivo)	Aggiunge il prodotto a un confronto che il cliente può aprire altrove.
Allineamento del pulsante	A sinistra (predefinito) · Centrato · A destra · Larghezza piena
Pagina di confronto	indirizzo	Dove porta il link «Vedi il confronto». Senza destinazione resta nascosto, perché un link che non porta da nessuna parte è peggio di nessun link.

Dettagli del prodotto(Product details)

Cosa mostra

Le sezioni di dettaglio del prodotto, come Garanzia e Spedizione e resi, a fisarmonica, a schede o come elenco aperto. I testi validi per tutto il negozio subentrano dove un prodotto non ne ha uno proprio.

Dove va

Pagine prodotto.

Cosa gli serve

Sezioni di dettaglio dal pacchetto iniziale; facoltativamente dettagli prodotto in details.slots.

Impostazioni

Impostazione	Opzioni	A cosa serve
Titolo	testo libero
Livello di titolo	H2 (predefinito) · H3	Fa parte della struttura del documento, non è decorazione. Se la sezione attorno a questo blocco ha già un titolo, scegli H3: due H2 di fila sono un errore di struttura, e solo uno screen reader lo rivela.
Disposizione	Fisarmonica (predefinito) · Schede · Elenco aperto
Apri la prima sezione	attivo / disattivo (predefinito: attivo)	Vale per la prima sezione che ha davvero contenuto. Così non resta mai chiusa solo perché su questo prodotto è vuota.
Ricorri al testo comune del negozio	attivo / disattivo (predefinito: attivo)	Sezioni come Resi o Garanzia dicono la stessa cosa su ogni prodotto. Scrivile una volta sulla sezione stessa; se un prodotto ha un testo proprio, vince quello.

Documenti(Documents)

Cosa mostra

I documenti del prodotto con titolo, tipo, lingua, versione, data e tipo di file. I PDF si aprono in una nuova scheda del browser, le immagini in una finestra.

Dove va

Pagine prodotto.

Cosa gli serve

details.documents compilato sul prodotto.

Impostazioni

Impostazione	Opzioni	A cosa serve
Titolo	testo libero
Livello di titolo	H2 (predefinito) · H3	Fa parte della struttura del documento, non è decorazione. Se la sezione attorno a questo blocco ha già un titolo, scegli H3: due H2 di fila sono un errore di struttura, e solo uno screen reader lo rivela.
Metacampo	testo libero (predefinito: details.documents)	Dove stanno i documenti, come spazio_dei_nomi.chiave, per esempio details.documents. Il blocco scopre da solo che forma hanno. Se i link mostrano nomi di file invece di nomi: dai al file un testo alternativo sotto Contenuti → File e diventa quello l’etichetta. Il negozio ci mette qualche minuto a recepirlo, mentre l’editor del tema lo mostra subito, quindi non guardare troppo presto.
Mostra la data di emissione	attivo / disattivo (predefinito: attivo)
Apri le immagini in una finestra	attivo / disattivo (predefinito: attivo)	Un’immagine in una scheda nuova finisce su fondo grigio e sembra un errore. I PDF e i link verso l’esterno continuano ad aprirsi in una scheda nuova. Lì il browser fa più di quanto potremmo ricostruire noi.

Codici(Part numbers)

Cosa mostra

SKU, codice produttore, codice OE e codice a barre, ognuno con un pulsante di copia, se vuoi. Le etichette si possono rinominare per settore.

Dove va

Pagine prodotto.

Cosa gli serve

SKU e codice a barre dalla variante; partno.mpn e partno.oem sul prodotto.

Impostazioni

Impostazione	Opzioni	A cosa serve
Titolo	testo libero
Livello di titolo	H2 · H3 (predefinito)	Fa parte della struttura del documento, non è decorazione. Se la sezione attorno a questo blocco ha già un titolo, scegli H3: due H2 di fila sono un errore di struttura, e solo uno screen reader lo rivela.
Campi
Lascia un’etichetta vuota e viene usata la dicitura consueta. Sovrascriverla è ciò che rende un solo blocco adatto a molti settori: «OEM» diventa «Codice produttore» per le stampanti e «Numero d’ordine» nei ricambi.
Mostra lo SKU	attivo / disattivo (predefinito: attivo)
Etichetta dello SKU	testo libero
Mostra l’MPN	attivo / disattivo (predefinito: attivo)
Etichetta dell’MPN	testo libero
Mostra l’OEM	attivo / disattivo (predefinito: attivo)
Etichetta dell’OEM	testo libero
Mostra il codice a barre (EAN/UPC)	attivo / disattivo (predefinito: disattivo)
Etichetta del codice a barre	testo libero
Presentazione
Disposizione	Uno per riga (predefinito) · Compatta	«Compatta» mette etichetta e codice sulla stessa riga. Bene con un codice, stretto con quattro.
Mostra i pulsanti di copia	attivo / disattivo (predefinito: attivo)
Stile del pulsante di copia	Testo (predefinito) · Icona	Come icona stanno più discreti accanto a lunghi elenchi di codici.

Va bene?(Does it fit?)

Cosa mostra

Risponde se questo prodotto va bene per ciò che il cliente ha scelto ed elenca tutto ciò a cui va bene.

Dove va

Pagine prodotto, sotto il Selettore di compatibilità.

Cosa gli serve

fitment.vehicles compilato sul prodotto e un Selettore di compatibilità nella stessa pagina o in una pagina visitata prima.

Impostazioni

Impostazione	Opzioni	A cosa serve
Risponde se questo prodotto va bene per ciò che il cliente ha scelto. Le due frasi le scrivi tu, ed è proprio questo che rende un solo blocco adatto a veicoli, stampanti e utensili insieme.
Quando va bene	testo libero	Scrivi {ziel} dove deve comparire la scelta del cliente. Se lo ometti, la scelta viene aggiunta in fondo.
Quando non va bene	testo libero	Scrivi {ziel} dove deve comparire la scelta del cliente. Se lo ometti, la scelta viene aggiunta in fondo.
Prima che il cliente abbia scelto
Dì comunque qualcosa	attivo / disattivo (predefinito: attivo)	Uno spazio vuoto sembra un errore. Un breve invito a scegliere di solito si legge meglio del silenzio.
Testo prima della scelta	testo libero
Presentazione
Stile	Riga di testo (predefinito) · Distintivo
Mostra tutto ciò a cui va bene	attivo / disattivo (predefinito: attivo)
L’elenco parte aperto	attivo / disattivo (predefinito: disattivo)	Va bene con un elenco corto. Con molte voci un elenco aperto spinge tutto il resto fuori dallo schermo, e il numero nella riga sopra risponde già quasi sempre alla domanda.
Elenco più lungo	5–100 (predefinito: 25)	Un elenco accorciato dice sempre quanti ne mancano. Senza, un cliente legge «va bene per questi 20» e ne conclude che il suo non c’è.

Selettore di compatibilità(Compatibility picker)

Cosa mostra

Il selettore passo dopo passo: fino a quattro livelli, il terzo è un intervallo come gli anni del modello. In modalità «Mostra la compatibilità su questo prodotto» risponde nella pagina prodotto; in modalità «Ricerca» mostra i prodotti che corrispondono.

Dove va

Qualsiasi pagina: pagine prodotto, collezioni, una landing page.

Cosa gli serve

Destinazioni di compatibilità; per la modalità Ricerca una collezione e un filtro di Search & Discovery su fitment.vehicles.

Impostazioni

Impostazione	Opzioni	A cosa serve
Titolo	testo libero
Livelli
Il selettore restringe passo dopo passo. Dai ai passi il nome di ciò che vendi: Marca → Modello → Anno → Motore per i veicoli, Marca → Serie → Modello per le stampanti, Marca → Sistema batteria → Utensile per l’elettroutensile. I livelli 3 e 4 si disattivano più sotto, se i tuoi dati non hanno quel passo.
Livello 1	testo libero
Livello 2	testo libero
Mostrare il livello 3	attivo / disattivo (predefinito: attivo)	Il livello a intervallo: i suoi record portano un «da» e un «a», come l’anno modello, e il selettore offre ogni passo intermedio. Disattivato = il selettore si ferma dopo il livello 2.
Livello 3: un intervallo	testo libero	Come si chiama questo passo per la clientela. Lascialo vuoto e segue la lingua del tuo negozio.
Mostrare il livello 4	attivo / disattivo (predefinito: attivo)	Un livello in più, con corrispondenza esatta. Disattivato = il selettore si ferma dopo il livello 3.
Livello 4	testo libero	Come si chiama questo passo per la clientela. Lascialo vuoto e segue la lingua del tuo negozio.
Comportamento
Modalità	Mostra la compatibilità su questo prodotto (predefinito) · Ricerca: mostra i prodotti che corrispondono	«Mostra la compatibilità» risponde se questo prodotto va bene per ciò che il cliente ha scelto. «Ricerca» mostra i prodotti che corrispondono alla sua scelta.
Collezione in cui cercare	scegli una collezione	Usato solo in modalità Ricerca. I risultati arrivano da questa collezione, filtrati sulla scelta del cliente. Serve un filtro corrispondente in Search & Discovery.
Testo del pulsante	testo libero	Usato solo in modalità Ricerca.
Mostra i risultati qui	attivo / disattivo (predefinito: attivo)	Tiene il cliente su questa pagina, una nuova selezione sostituisce semplicemente la precedente. Off = salto alla pagina della collezione.
Ricordare la scelta
Ricorda tra le pagine	attivo / disattivo (predefinito: attivo)	Resta solo nel browser, quindi è funzionale e non serve alcun banner di consenso. Disattivalo per i dispositivi condivisi, o se preferisci non memorizzare nulla. Il selettore continua a funzionare, dimentica soltanto alla pagina successiva.
Riga che mostra la scelta	testo libero	Scrivi {ziel} dove deve comparire la scelta del cliente. Se lo ometti, la scelta viene aggiunta in fondo.
Presentazione
Livello di titolo	H2 · H3 (predefinito)	Fa parte della struttura del documento, non è decorazione. Se la sezione attorno a questo blocco ha già un titolo, scegli H3: due H2 di fila sono un errore di struttura, e solo uno screen reader lo rivela.

Cercatore di prodotti(Product finder)

Cosa mostra

Una ricerca guidata sui tuoi filtri derivati: un menu a tendina per proprietà, campi numerici come «almeno», caselle «senza …», una fascia di prezzo facoltativa e i risultati subito sotto.

Dove va

Qualsiasi pagina, di solito una collezione o una landing page per settore.

Cosa gli serve

Filtri derivati (passaggio 8) e i filtri corrispondenti in Search & Discovery.

Impostazioni

Impostazione	Opzioni	A cosa serve
Titolo	testo libero
Livello di titolo	H2 (predefinito) · H3	Fa parte della struttura del documento, non è decorazione. Se la sezione attorno a questo blocco ha già un titolo, scegli H3: due H2 di fila sono un errore di struttura, e solo uno screen reader lo rivela.
Collezione in cui cercare	scegli una collezione	Da dove arrivano i risultati. Lascialo vuoto e il cercatore cerca nella collezione della pagina in cui si trova, o in tutti i prodotti se non ce n’è nessuna. Serve un filtro per proprietà in Search & Discovery.
Testo del pulsante	testo libero
Offri una fascia di prezzo	attivo / disattivo (predefinito: disattivo)	Aggiunge due campi numerici. Shopify filtra il prezzo da solo, quindi non servono né indice né configurazione. Lascialo disattivato se il tuo tema mostra già un proprio filtro di prezzo, altrimenti compare due volte.
Disposizione	Si adatta allo spazio (predefinito) · Tutti i campi della stessa larghezza · Sempre uno sotto l’altro	Il blocco misura la propria larghezza, quindi si impila già in una colonna stretta o sul telefono. Scegli «sempre» se vuoi la forma impilata anche dove c’è spazio. Una colonna laterale è possibile in Horizon, che lascia entrare le app nei suoi gruppi di layout. Dawn non offre quel posto, quindi lì il blocco sta sopra o sotto la griglia.
Passo dei campi di prezzo	numero	Di quanto si muovono le frecce a ogni clic. Lascialo vuoto e il blocco lo deduce dalla fascia di prezzo della collezione. Un negozio che vende intorno a 30 ottiene passi diversi da uno che vende intorno a 3000.
Mostra il numero di corrispondenze	attivo / disattivo (predefinito: attivo)	I temi di solito contano da soli nei risultati. Se il numero compare due volte, disattiva questo. I messaggi tipo «Senza Materiale sarebbero 4» restano in ogni caso.
Mostra i risultati qui	attivo / disattivo (predefinito: attivo)	Tiene il cliente su questa pagina, una nuova selezione sostituisce semplicemente la precedente. Off = salto alla pagina della collezione.
I numeri significano «almeno»	attivo / disattivo (predefinito: attivo)	Attivo: scegliere 120 W mostra anche 180 W e 250 W. Disattivo: solo il valore esatto.
Nascondi i valori sotto questo numero di prodotti	numero (predefinito: 2)	Un valore presente su un solo prodotto non è un filtro, è un collegamento a quel prodotto. 2 lo nasconde, 1 mostra tutto. Il conteggio avviene nella collezione di destinazione, non in tutto il negozio. Un valore presente su tutti i prodotti della collezione resta sempre nascosto: non può restringere nulla.
Offri esclusioni	attivo / disattivo (predefinito: attivo)	Aggiunge caselle «senza …» per ogni esclusione che hai derivato nell’app. Disattivalo se preferisci tenerle solo nella barra dei filtri del tema.
Mostrare subito la collezione	attivo / disattivo (predefinito: attivo)	Al caricamento il blocco mostra già tutti i prodotti della collezione di destinazione; restringere viene dopo. Disattivalo se sotto c’è una griglia di prodotti tua, altrimenti gli stessi prodotti compaiono due volte.

Tabella di confronto(Comparison table)

Cosa mostra

Prodotti uno accanto all’altro, riga per riga. I clienti aggiungono prodotti con «Salva per dopo» nella tabella delle specifiche o con il campo di ricerca.

Dove va

Pagine prodotto o una pagina di confronto dedicata.

Cosa gli serve

specs.groups sui prodotti che confronti.

Impostazioni

Impostazione	Opzioni	A cosa serve
Titolo	testo libero
Livello di titolo	H2 (predefinito) · H3	Fa parte della struttura del documento, non è decorazione. Se la sezione attorno a questo blocco ha già un titolo, scegli H3: due H2 di fila sono un errore di struttura, e solo uno screen reader lo rivela.
Includi sempre il prodotto attuale	attivo / disattivo (predefinito: attivo)	In una pagina prodotto, questo prodotto è sempre la prima colonna. Appena il cliente ne salva un altro, li vede subito uno accanto all’altro.
Mostra solo le differenze	attivo / disattivo (predefinito: disattivo)	Nasconde le righe in cui tutti i prodotti hanno lo stesso valore.
Lascia che i clienti scelgano i prodotti qui	attivo / disattivo (predefinito: attivo)	Aggiunge un campo di ricerca perché il blocco funzioni da solo, senza dover prima salvare un prodotto altrove.

Anteprima rapida(Quick view)

Cosa mostra

Un pulsante su ogni scheda prodotto che apre le specifiche del prodotto direttamente nell’elenco, sotto la scheda o in una finestra.

Dove va

Tutto il tema: Incorporamenti app nell’editor di temi.

Cosa gli serve

Il blocco Tabella delle specifiche nel tuo modello di prodotto, perché è da lì che arrivano i valori.

Impostazioni

Impostazione	Opzioni	A cosa serve
Mostra le specifiche di un prodotto direttamente nell’elenco, senza lasciare la pagina. Serve il blocco delle specifiche nel tuo template di prodotto, perché è da lì che arrivano i valori.
Pulsante sulla scheda	testo libero
Stile del pulsante	Il pulsante del tuo tema (predefinito) · Contorno semplice · ⓘ piccolo	«Il pulsante del tuo tema» aggiunge semplicemente la classe pulsante del tema, quindi appare come ogni altro pulsante del tuo negozio.
Quale pulsante del tema	Secondario (predefinito) · Primario	Usato solo con lo stile pulsante del tuo tema. Ovunque tranne che sotto la scheda viene ridotto, perché i pulsanti del tuo tema sono call to action a piena dimensione e si mangerebbero la scheda.
Dove si posiziona	Sull’immagine, in alto a destra · Sull’immagine, in alto a sinistra · Sull’immagine, in basso a destra · Sull’immagine, in basso a sinistra · Accanto al prezzo (predefinito) · Sotto la scheda
Come si apre	Sotto la scheda (predefinito) · Come finestra	«Sotto la scheda» occupa tutta la riga, così non si sposta nulla di lato. Se la griglia del tuo tema non lo consente, viene usata la finestra, in automatico e senza impostazioni.

Fatto, e come disdire

Quando non resta nulla da fare, la panoramica lo dice: «Tutto configurato» (Fully set up).

Per disdire non serve disinstallare. «Piano» → «Tornare al piano Free» (Switch back to Free) termina Full subito; la parte non usata del periodo ti viene accreditata. Le tue definizioni e i tuoi valori restano nel negozio, ogni blocco continua a funzionare e puoi riattivare Full in qualsiasi momento. Anche se disinstalli l’app, i campi e il loro contenuto restano nel tuo negozio.

Se qualcosa non torna

Serve ancora aiuto?

Scrivici indicando l’indirizzo del tuo negozio e quello che vedi sullo schermo. Rispondiamo in inglese e in tedesco.

Contatti