Logo

Perché le proprietà del carrello di Shopify sono importanti

avatar jayce 17 Aug 2026

Perché le proprietà del carrello di Shopify sono importanti

Shopify ha aggiornato il changelog degli sviluppatori il 2026-08-06 con un piccolo punto: gli eventi e le azioni standard del negozio ora supportano le proprietà del carrello. Questo aggiornamento non rappresenta una grande migrazione della versione API, ma rientra nel sistema di documentazione del 2026-07, e sarà notato da molti team che stanno sistemando l’esperienza di checkout e carrello.

In particolare, l’azione standard updateCart ora può aggiornare le proprietà del carrello; è stato anche aggiunto un nuovo evento shopify:cart:attributes-update. Ogni volta che viene avviato un aggiornamento delle proprietà del carrello, questo evento verrà attivato. Porterà con sé un nuovo insieme di attributi e una promessa di risultato, facilitando l’aggiornamento dell’interfaccia utente da parte del frontend; se il carrello rifiuta questa modifica, l’interfaccia può essere ripristinata.

Questo aggiornamento non sembra una grande funzionalità. Non modifica la pagina di checkout e non fornisce direttamente un ulteriore pulsante nel backend per i commercianti. Tuttavia, per i team che creano temi Shopify, strumenti di conversione e app personalizzate, colma una piccola lacuna nella sincronizzazione dello stato all’interno del carrello.

Distinguere due attributi

Prima di tutto, chiarire il concetto.

Le proprietà del carrello sono chiavi-valore personalizzate collegate al carrello. Gli esempi forniti nella documentazione dell’API Storefront di Shopify includono messaggi regalo, istruzioni speciali e note d’ordine. Non sono proprietà degli articoli. Le seconde sono generalmente legate a un singolo prodotto, come incisioni su anelli, taglie di magliette o colori delle confezioni regalo; le proprietà del carrello sono più simili a note aggiuntive per l’intero carrello.

Ad esempio, un sito indipendente che vende articoli per animali domestici con circa duecento SKU, ha 3 articoli nel carrello e il compratore desidera scrivere un biglietto di auguri, chiedendo di “consegnare venerdì pomeriggio alla reception, senza telefonare”. Queste informazioni non appartengono a uno SKU specifico, ma influenzano l’evasione dell’ordine. Metterle nelle proprietà del carrello è più naturale che inserirle in una riga di un prodotto.

Lo stesso vale per gli strumenti di marketing. Ad esempio, un’app quiz che chiede “Scopo dell’acquisto: regalo di compleanno / acquisto aziendale / uso personale” prima di aggiungere al carrello, questa scelta può influenzare i suggerimenti, le raccomandazioni e le soglie di spedizione gratuita nel carrello. Se questo valore può seguire stabilmente il carrello, l’app non deve fare avanti e indietro tra URL, localStorage e sessioni autogestite.

Una volta scritto, gli altri potrebbero non saperlo

Una frase chiave nel changelog di Shopify è: in precedenza, per modificare un attributo, era necessario chiamare manualmente l’API Storefront, e non c’era nulla che informasse la tua app che era cambiato.

L’API Storefront 2026-07 aveva già la mutazione cartAttributesUpdate. Richiede due parametri: cartId e attributes, dove attributes è un array di chiavi-valore, con un limite massimo di 250. Questa capacità non è nuova.

Il problema è la collaborazione.

La pagina del carrello spesso non è gestita da un’unica app. Il codice del tema potrebbe modificare il messaggio regalo, l’app di abbonamento potrebbe modificare le preferenze di consegna, l’app di upsell potrebbe modificare la fonte delle raccomandazioni, e un altro script di analisi potrebbe voler registrare l’intento dell’acquirente. Ogni strumento può scrivere attributi, ma non sa quando e cosa ha scritto l’altro, il che può facilmente portare a problemi come interfacce non aggiornate, stati sovrascritti e errori che non possono essere ripristinati.

Il valore di shopify:cart:attributes-update risiede qui. Permette che gli aggiornamenti degli attributi avviati da app, temi e altre app possano essere ascoltati. Il frontend può prima aggiornare in modo ottimista e poi decidere se mantenere in base alla promessa di risultato. Non è un pulsante di conversione, ma influenzerà molti dettagli attorno al pulsante di conversione.

L’impatto sulla conversione si nasconde in meno interruzioni

La conversione del carrello spesso si interrompe a causa di piccole interruzioni.

Il compratore sceglie l’imballaggio regalo, la pagina si aggiorna; inserisce le istruzioni di consegna, ma le perde passando al checkout; seleziona l’acquisto aziendale, ma le raccomandazioni del carrello mostrano ancora il normale retail; un’app scrive uno stato, un’altra app non lo riceve, costringendo l’utente a confermare di nuovo.

Questi problemi, presi singolarmente, non sembrano grandi bug, ma possono far sentire il compratore che il processo non è stabile. Con l’aggiornamento delle proprietà del carrello e il meccanismo degli eventi più fluido, temi e app possono trattare queste scelte come parte dello stato del carrello, piuttosto che ciascuno nascondere una copia.

Ad esempio, un sito di regali può mostrare in tempo reale “imballaggio regalo selezionato” nella pagina del carrello, e l’estensione del checkout può continuare a leggere lo stesso attributo; un negozio B2B può mostrare un avviso di ordine di acquisto in base a “purchase_order_required=true”; un negozio di alimenti in abbonamento può utilizzare “delivery_window=weekday_morning” per controllare le istruzioni di consegna. C’è un punto incerto: non è chiaro come ogni tema e app di terze parti debbano integrare l’evento, e non posso garantire l’efficacia per ogni tema reale. Ma la direzione è chiara: meno stati persi significano meno esitazioni.

Non considerarlo come un database, prestare attenzione ai confini di autorizzazione

La documentazione dell’API Attributes di Shopify ricorda anche un punto: se si desidera memorizzare dati personalizzati, Shopify consiglia di utilizzare i metafield del carrello. La ragione è molto pratica: i metafield hanno autorizzazioni di modifica e visualizzazione, e hanno spazi dei nomi riservati per le app, che possono prevenire letture e scritture casuali da parte di altre app.

Le proprietà del carrello sono condivise. La documentazione è chiara: tutte le estensioni e il negozio possono condividere queste proprietà, qualsiasi estensione può leggere o sovrascrivere le proprietà impostate da un’altra estensione.

Quindi è adatto a informazioni leggere, temporanee e poco sensibili del carrello. Messaggi regalo, istruzioni di consegna, fonti di promozione, scelta dell’imballaggio, sono tutte informazioni appropriate. Regole sui prezzi, privacy degli utenti, etichette di membri a lungo termine, valutazioni di rischio, non dovrebbero essere inserite a caso. Per ciò che richiede isolamento delle autorizzazioni, utilizzare i metafield del carrello; per dati permanenti a livello di ordine, considerare i metafield degli ordini o il successivo trattamento degli ordini.

I team di sviluppo possono ora affrontare tre piccole ma facilmente trascurabili questioni

Se stai creando un’app o un tema per Shopify, questo aggiornamento non richiede necessariamente di modificare immediatamente il codice, ma vale la pena di esaminarlo.

Controlla prima se ci sono scritture di attributi nel carrello. In particolare, nei luoghi in cui in precedenza si chiamava direttamente cartAttributesUpdate, verifica se dovrebbe essere migrato all’azione standard updateCart, o almeno ascoltare shopify:cart:attributes-update.

Controlla poi la visualizzazione dello stato. Qualsiasi UI sulla pagina del carrello che mostra “selezionato”, “compilato”, “applicato” deve confermare se l’interfaccia si sincronizzerà dopo che l’attributo è stato modificato da altre app.

Infine, controlla il ripristino. In caso di aggiornamento non riuscito, l’interfaccia non può rimanere bloccata nello stato di successo. Il nuovo evento fornisce una promessa di risultato, che può pulire l’aggiornamento ottimista e il ripristino in caso di errore.

Questo è il punto più pratico di questo piccolo aggiornamento: Shopify non ha inventato le proprietà del carrello, ma le ha rese più simili a uno stato del carrello che può essere collaborativo. Per i commercianti, non aumenterà automaticamente la conversione; per gli sviluppatori, riduce le possibilità di perdere le scelte degli utenti.

Riferimenti:

• Changelog degli sviluppatori di Shopify: Gli eventi e le azioni standard del negozio ora supportano le proprietà del carrello

• Shopify.dev: API Attributes

• Shopify.dev Storefront API: cartAttributesUpdate

Book Free 30-Min Call