Cosa fa la mappatura in blocco
Alva Digital Downloads collega i file già presenti nello storage ai prodotti Shopify a partire da un singolo CSV. Apri la pagina Prodotti e clicca l'azione secondaria Bulk Product-File Mapping. La schermata è disponibile solo sui piani a pagamento — è disabilitata sul piano Free.
Cosa serve nel CSV
Il parser legge la riga di intestazione e abbina le colonne per nome, senza distinzione tra maiuscole e minuscole. Richiede una colonna PRODUCT_ID e almeno una colonna FILE_1. Le colonne delle varianti sono opzionali. L'ordine delle colonne non conta e puoi aggiungere tutte le colonne FILE_ e VARIANT_ che ti servono.
- PRODUCT_ID — l'ID prodotto Shopify. Usa il numero semplice (
1234567890) o la forma completagid://shopify/Product/1234567890. - FILE_1, FILE_2, … — ciascuna contiene il titolo di un file nello storage di Alva, eventualmente preceduto da
@(la@viene rimossa). Ogni riga ha bisogno di almeno un file. - VARIANT_1, VARIANT_2, … — ID variante Shopify opzionali. Ometterle per mappare alla variante predefinita su tutto il prodotto.
Come mappare i file in blocco
1. Apri la schermata di mappatura in blocco
Nella pagina Prodotti, clicca Bulk Product-File Mapping. La pagina si apre con una scheda di istruzioni — incluso un esempio di CSV completo — e un uploader drag-and-drop. Non c'è un template scaricabile; copia il layout dell'esempio nel tuo foglio di calcolo.
2. Crea e salva il CSV
Metti un prodotto per riga. Compila PRODUCT_ID con l'ID Shopify e ogni colonna FILE_ con il titolo di un file. Una riga semplice come 123456789,,,,@User Manual,, mappa un file alla variante predefinita di un prodotto. Salva il foglio come .csv.
La tabella di anteprima Bulk Product-File Mapping dopo il caricamento di un CSV. Mostra le quattro colonne — File, Product, Variants, Status — con 3–4 righe di esempio: badge verdi "success", una riga rossa "error" e un prodotto con un badge "Existing". Usa nomi di prodotto fittizi, nessun dato cliente reale.
3. Carica e controlla l'anteprima
Trascina il file nell'uploader. Alva verifica ogni titolo di file nello storage e convalida gli ID prodotto e variante su Shopify. L'anteprima elenca ogni riga con un badge Status — success, error o pending — e segnala i prodotti che hanno già mappature con un badge Existing.
4. Elabora le mappature
Clicca Process CSV. Le righe valide vengono salvate come mappature prodotto e le righe con errori vengono saltate. Se più del 30% delle righe non è valido, Alva blocca l'esecuzione. Al di sotto di quella soglia, una finestra di conferma ti indica quante righe verranno saltate prima di procedere.
5. Verifica la copertura
Dopo un'esecuzione riuscita, clicca View Products per tornare alla lista Prodotti. Ogni prodotto mostra il proprio conteggio di allegati, così puoi individuare qualsiasi prodotto che mostra ancora zero file. Correggi quelle righe e rieseguile con Retry failed mappings.
Domande frequenti
Apri il prodotto nell'admin Shopify e copia l'ID numerico alla fine dell'URL, come 1234567890. Alva accetta quel numero semplice o la forma completa gid://shopify/Product/1234567890 nella colonna PRODUCT_ID.
No. La schermata di mappatura in blocco mostra un esempio di CSV completo all'interno della scheda di istruzioni. Copia quel layout nel tuo foglio di calcolo — una colonna PRODUCT_ID più le colonne FILE_1, FILE_2 — invece di scaricare un file template.
Tramite il titolo del file nello storage di Alva, abbinato senza distinzione tra maiuscole e minuscole. Puoi anteporre al titolo un simbolo @, che Alva rimuove. Il file deve essere già caricato — la mappatura in blocco collega file esistenti, non li carica.
Le righe con errori vengono saltate e le righe valide vengono comunque salvate. Se più del 30 percento delle righe non è valido, Alva blocca l'intera esecuzione. Al di sotto, una finestra modale di conferma ti avverte quali righe verranno saltate prima dell'elaborazione.
Aggiungi le colonne VARIANT_1, VARIANT_2 e metti in ciascuna un ID variante Shopify. Le righe senza colonne variante vengono mappate alla variante predefinita e si applicano a tutto il prodotto. Non c'è limite al numero di colonne variante.
Vedi anche
È stato utile?
Ultimo aggiornamento 2026-06-01