Come scrivere valori product_detail e product_highlight accettati da Google, con righe di feed d'esempio

L'attributo product_detail di Google accetta fino a 100 voci per prodotto, ciascuna lunga da 1 a 150 caratteri, mentre product_highlight richiede almeno 2 e consiglia da 4 a 6 brevi frasi sui vantaggi per articolo, secondo le specifiche ufficiali di Google su product detail e product highlight. Entrambi sono facoltativi, quindi la maggior parte dei feed li salta oppure incolla una tabella di specifiche che Merchant Center segnala come formattata male.

Google afferma che product_detail aiuta i prodotti a comparire nelle superfici AI come AI Mode, e a maggio 2026 ha aggiunto altri attributi conversazionali basati sulla stessa idea.

Questa guida è pensata per feed manager e agenzie che inviano dati di prodotto a Google Merchant Center. Alla fine sarai in grado di scrivere entrambi gli attributi in TSV e XML, fare l'escape dei caratteri che li rompono, evitare i contenuti vietati e assegnare un punteggio a una riga prima dell'invio.

A cosa servono product_detail e product_highlight

I due attributi si somigliano e spesso vengono compilati dalla stessa fonte, ma Google assegna loro compiti diversi. product_detail contiene specifiche tecniche e verificabili non coperte da un altro attributo: contenuto della confezione, connettività, ingredienti, requisiti di alimentazione, finitura, fragranza e fatti simili. product_highlight contiene brevi vantaggi di vendita scritti come frasi semplici.

Il nostro test rapido: se la riga sta in una tabella di specifiche con un'etichetta e un valore, è un product_detail. Se suona come una frase che direbbe un commesso in negozio, è un product_highlight. La specifica di Google sugli highlight fa la stessa distinzione e chiede di non ripetere l'uno nell'altro.

Le specifiche in sintesi

Questi sono i limiti così come Google li pubblica oggi. Google non indica alcuna proprietà schema.org per product_detail, quindi non viene letto dai dati strutturati del sito: deve essere presente nel feed.

Fonti: Google Merchant Center Help, Product detail [product_detail] e Product highlight [product_highlight].

Come scrivere product_detail in TSV, XML e Merchant API

Il formato è il punto in cui la maggior parte delle righe fallisce. Ogni dettaglio è composto da tre valori uniti da due due punti, nell'ordine nome della sezione, nome dell'attributo, valore dell'attributo. Google è esplicito: nei feed di testo ogni dettaglio deve avere due due punti, e fornire un numero di sottoattributi diverso da quello dichiarato nell'intestazione genera un problema di formato del sottoattributo non valido sotto "Richiede attenzione".

Intestazione TSV e singola cella

Dichiara i sottoattributi nell'intestazione della colonna, tra parentesi e separati da due punti. Una volta nominati nell'intestazione, i valori possono seguire nell'ordine che hai dichiarato. Senza dichiarazione, Google presume sezione, nome, valore.

product_detail(section_name:attribute_name:attribute_value)

Una cella con tre dettagli appare quindi così:

General:Brew type:Turkish coffee,General:Capacity:4 cups,Power:Rated power:1000 W

Se un dettaglio non ha una sezione, mantieni i due punti iniziali e lascia vuoto il primo campo:

:What's in the box?:"Machine,Measuring spoon,User manual"

Escape di due punti, virgole e virgolette

Le regole di Google sugli attributi tra virgolette si applicano agli attributi di gruppo come questo:

• Racchiudi tra virgolette doppie dritte qualsiasi valore di sottoattributo che contenga una virgola o due punti. Metti tra virgolette il singolo valore, non l'intero gruppo.
• Scrivi una virgoletta doppia letterale come due virgolette doppie. L'esempio di Google è "APS-C max. 12""" per un valore che termina con il simbolo del pollice.
• Non usare l'escape con backslash. Google legge il backslash come carattere letterale.
• I campi tra virgolette non sono supportati per le origini dati di Google Sheets. Per le origini file esistenti, i campi tra virgolette vanno attivati nella configurazione dell'origine dati.

XML

In XML ogni dettaglio è un elemento a sé con tre figli, quindi non serve alcun escape di due punti o virgole:

<g:product_detail><g:section_name>Materials</g:section_name><g:attribute_name>Body</g:attribute_name><g:attribute_value>Stainless steel, BPA-free plastic</g:attribute_value></g:product_detail>

Per le categorie ricche di specifiche, XML è il formato più sicuro perché le normali virgole e i due punti smettono di essere un rischio di parsing.

Merchant API

Tramite la Merchant API, ogni dettaglio è un oggetto ProductDetail con i campi sectionName, attributeName e attributeValue, come indicato nel riferimento del client API.

Come scrivere product_highlight

Gli highlight sono più semplici: una stringa per ogni highlight. In un feed di testo, separa gli highlight con virgole e racchiudi tra virgolette doppie ogni highlight che contiene una virgola o due punti. In XML, dai a ogni highlight il suo elemento <g:product_highlight>.

"Brews up to 4 cups in one cycle","Foam sensor stops brewing before the pot overflows","Switches off automatically after brewing","Stainless steel body wipes clean"

Limita ciascuno a un solo vantaggio. Google chiede un linguaggio professionale e grammaticalmente corretto, senza enfasi in maiuscolo, senza simboli e senza formulazioni promozionali.

Contenuti che Google non consente in nessuno dei due attributi

Gli errori di formattazione producono errori visibili. Quelli di contenuto sono più silenziosi: una riga può essere accettata e violare comunque le policy. Questa tabella riunisce i divieti di entrambe le specifiche.

Google aggiunge un'ulteriore regola facile da perdere: se invii file document_link che contengono già le stesse informazioni, non inserirle in questi attributi e lascia che Google le estragga dai documenti.

Esempio pratico: da una tabella di specifiche a righe accettate

Di seguito una riga tipica di un negozio che esporta le specifiche dei prodotti come un unico campo di testo libero. Il prodotto è una macchina elettrica per il caffè turco; il negozio vende in Turchia e, in inglese, nei mercati del Golfo.

Prima

product_detail: Brand: Acme, Power: 1000W, Material: Stainless Steel, Plastic, FREE SHIPPING, best turkish coffee maker cheap

Cinque problemi in una sola cella. I separatori sono misti, quindi il numero di due punti non corrisponde all'intestazione. "Stainless Steel, Plastic" non è tra virgolette, quindi la sua virgola spezza il dettaglio. Brand duplica l'attributo brand. "FREE SHIPPING" è testo sulla spedizione in maiuscolo. L'ultimo frammento è una stringa di parole chiave.

Dopo, feed in inglese

General:Brew type:Turkish coffee,General:Capacity:4 cups,Power:Rated power:1000 W,Materials:Body:"Stainless steel, BPA-free plastic",Safety:Automatic shut-off:Yes,:What's in the box?:"Machine,Measuring spoon,User manual"

Il brand è passato al suo attributo, la spedizione a shipping, le parole chiave sono state eliminate, i valori sono in maiuscolo da frase come raccomanda Google, e ogni valore con una virgola è tra virgolette. "Automatic shut-off: Yes" resta perché il produttore lo conferma; un campo che la tua piattaforma imposta di default su "No" non resterebbe.

Dopo, feed in turco

Google chiede che nomi di sezione, nomi di attributo e valori siano localizzati in ogni feed linguistico, quindi il feed turco ha la sua riga e non quella inglese:

Genel:Demleme türü:Türk kahvesi,Genel:Kapasite:4 fincan,Güç:Nominal güç:1000 W,Malzeme:Gövde:"Paslanmaz çelik, BPA içermeyen plastik",:Kutu içeriği:"Makine,Ölçü kaşığı,Kullanım kılavuzu"

Due note regionali per i team fuori dalla Turchia. Primo: mantieni le lettere turche. La raccomandazione di Google sull'ASCII è una preferenza, non un requisito, e la sua specifica sugli highlight consente esplicitamente le lettere accentate; traslitterare "Paslanmaz çelik" in "Paslanmaz celik" produce un errore di ortografia, in contrasto con le linee guida di Google su grammatica e ortografia. Secondo: se una regola trasforma questi valori in minuscolo o in maiuscolo da frase, serve una gestione delle maiuscole sensibile al locale, in modo che "İ" e "I" non diventino le lettere sbagliate, un problema che abbiamo trattato nella nostra guida alle maiuscole nei titoli in turco.

Come costruire i valori dal tuo catalogo

Compiliamo questi attributi in quattro passaggi, in quest'ordine.

1. Mappa prima le fonti strutturate. Elenca tutte le specifiche che la tua piattaforma già memorizza come coppie etichetta-valore, ad esempio una scheda specifiche, un metafield o un attributo ERP. Ogni coppia diventa un product_detail, con il gruppo di origine come section_name. Usa un livello di feed come le feed rules o un feed supplementare, così il catalogo di origine resta intatto e l'output per Google può differire da quello degli altri canali.
2. Rimuovi tutto ciò che appartiene a un altro attributo. Elimina le righe su brand, colore, taglia, materiale, prezzo e spedizione se sono già nei rispettivi attributi dedicati. Poi elimina ogni dettaglio il cui testo compare già nel titolo o nella descrizione.
3. Scrivi gli highlight a mano o con bozze AI riviste. Gli highlight sono il punto in cui l'arricchimento con AI aiuta di più e sbaglia di più. Un modello scriverà volentieri "Ideal gift for coffee lovers", che è promozionale, oppure inventerà una caratteristica che il prodotto non ha. Genera bozze solo da specifiche confermate e rivedile con la tabella dei divieti qui sopra.
4. Convalida lunghezza e sintassi prima dell'esportazione. Verifica che ogni dettaglio e ogni highlight sia di 150 caratteri o meno, che ogni dettaglio abbia esattamente due due punti non tra virgolette e che il numero di highlight per prodotto sia almeno 2.

Una griglia di punteggio da usare prima dell'invio

Valuta un campione di 20 righe per categoria. Ogni controllo è superato (1) o fallito (0), per un massimo di 10 per riga. Consideriamo 9 o 10 pronto, 7 o 8 da correggere e poi inviare, e qualsiasi valore inferiore il segnale che i dati di origine vanno sistemati prima che valga la pena inviare questi attributi.

Dove questa guida mostra i suoi limiti

Non sappiamo quanto questi attributi incidano su posizionamento o percentuale di clic. Google afferma che product_detail aiuta i prodotti a comparire per query pertinenti, anche in AI Mode, ma non pubblica alcun dato, e non abbiamo visto uno studio pubblico controllato. Diffida delle percentuali dei fornitori finché non sono accompagnate da un metodo.

Questa è una guida su Google. La specifica del feed prodotti di OpenAI non ha un campo generico chiave-valore per le specifiche né un campo per gli highlight; usa campi piatti come material, dimensions e weight, più una descrizione di 5.000 caratteri. Se invii anche quel feed, le tue specifiche vanno mappate in quei campi o nella descrizione. Per questa guida non abbiamo verificato gli equivalenti di Meta o TikTok.

Lascia fuori anche i nuovi attributi conversazionali, come question_and_answer e document_link, oltre alla regola sulla sovrapposizione descritta sopra. Diversi fornitori di feed, tra cui Channable e Productsup, hanno pubblicato guide alla mappatura di questi attributi prima di noi, e vale la pena leggerle se ti serve subito quel set.

Infine, se il tuo catalogo non ha specifiche strutturate, questo metodo non può crearle, e le bozze AI senza una fonte confermata sono esattamente ciò che la regola di Google "invia solo valori confermati" vuole evitare.

Domande frequenti

product_detail è obbligatorio in Google Merchant Center?

No. Google lo indica come facoltativo per ogni prodotto. Vale la pena aggiungerlo quando hai specifiche verificate che nessun altro attributo copre, perché Google afferma che aiuta i prodotti a comparire per query pertinenti, anche in AI Mode.

Quanti product highlight dovrei inviare?

Google ne richiede almeno 2, ne consente fino a 100 e ne consiglia da 4 a 6 per prodotto. Ogni highlight può contenere fino a 150 caratteri.

Perché Merchant Center dice che il mio product_detail ha un formato del sottoattributo non valido?

Il numero di sottoattributi in un valore non corrisponde all'intestazione, di solito perché a un dettaglio manca un due punti oppure una virgola o due punti non tra virgolette all'interno di un valore lo ha spezzato. Metti tra virgolette ogni valore che contiene questi caratteri e mantieni due due punti per dettaglio.

Devo usare i caratteri turchi in un feed turco?

Sì. Google accetta Unicode e raccomanda l'ASCII solo come preferenza, mentre le sue linee guida sugli highlight consentono le lettere accentate e chiedono un'ortografia corretta. Eliminare le lettere turche crea parole scritte male.

L'AI può scrivere i miei product highlight?

Può preparare delle bozze, ma solo a partire da specifiche che hai confermato, e ogni bozza va controllata per individuare formulazioni promozionali, confronti e caratteristiche inventate. Google vieta i primi due negli highlight, e una caratteristica inventata è semplicemente un dato di prodotto falso.

Google Sheets supporta i valori product_detail tra virgolette?

No. Le linee guida di Google sugli attributi tra virgolette indicano che i campi tra virgolette non sono supportati per le origini dati di Google Sheets, quindi i valori di specifica con virgole o due punti è meglio inviarli tramite un file TSV, XML o la Merchant API.

Controlla il tuo feed prima di aggiungere questi attributi

Questi attributi aiutano solo se i campi su cui si basano sono puliti. Analizza il tuo feed con lo strumento gratuito di audit del feed di prodotto per vedere completezza, qualità e problemi tecnici per prodotto prima di iniziare a scrivere dettagli e highlight.