Specifica per il feed di inventario locale dei prodotti

Il feed di inventario locale dei prodotti è un elenco dei prodotti che vendi in ciascun negozio. Alcuni attributi sono necessari per tutti gli articoli, altri sono richiesti per determinati tipi di articoli, mentre altri ancora sono consigliati.

Nota: se non specifichi un attributo obbligatorio per un articolo, tale articolo potrebbe non essere visualizzato nei risultati; non specificare gli attributi consigliati, invece, potrebbe influire negativamente sul rendimento dell'annuncio. 

Feed completi e incrementali

Il prezzo e la quantità dell'inventario possono variare di frequente e in modo diverso da negozio a negozio. Per aggiornare rapidamente i dati di inventario, puoi utilizzare i feed incrementali.

• Feed di inventario locale dei prodotti (completo): invialo giornalmente includendovi l'intero inventario. Il tipo di feed è "inventario locale dei prodotti".

• Feed di inventario locale dei prodotti (incrementale): se il prezzo e/o la quantità degli articoli di ciascun negozio cambia durante il giorno, invia a più riprese nel corso della giornata soltanto gli articoli che sono cambiati con i dettagli aggiornati. Il tipo di feed è "aggiornamento inventario locale dei prodotti".

Il feed di aggiornamento dell'inventario locale dei prodotti viene elaborato più rapidamente rispetto al feed completo, consentendoti di offrire annunci di prodotti disponibili localmente con informazioni più aggiornate. Per rendere il tuo feed incrementale:

1. Accedi al tuo account Merchant Center. 
2. Dopo aver selezionato Prodotti dal pannello di navigazione a sinistra, fai clic su Feed. 
3. Seleziona il feed da modificare, quindi fai clic su Impostazioni. 
4. Seleziona la casella con la dicitura "Conserva gli articoli non più inclusi nel feed".

Inviare feed di inventario locale dei prodotti

Tipo di file: il feed di inventario locale dei prodotti è disponibile solo nel formato file di testo delimitato da tabulazioni o tramite API.

Nota: i file XML sono ora ufficialmente supportati per questo tipo di feed.

Registrazione di un nuovo feed: per registrare un nuovo feed di dati dovrai seguire la procedura standard, selezionando "inventario locale dei prodotti" o "aggiornamento inventario locale dei prodotti" come tipo di feed.

Importante: alcuni attributi nella specifica del feed di inventario locale dei prodotti contengono spazi e trattini bassi. Per assicurarti di inviare attributi con caratteri e spaziatura corretti, segui le linee guida qui sotto per il tuo tipo di file:

• Feed delimitati da tabulazioni: gli spazi sono obbligatori. Se l'attributo comprende trattini bassi, utilizza uno spazio anziché "_".
• API XML o JSON: sono necessari i trattini bassi, che vengono poi convertiti in spazi vuoti dopo la ricezione.

Riepilogo dei requisiti per gli attributi

	Attributo	Requisiti per l'invio
Dati di inventario obbligatori	store_code [codice_negozio] id [id] quantity [quantità] price [prezzo]	Obbligatori per tutti i prodotti. Nota: l'attributo store code [codice_negozio] fa distinzione tra maiuscole e minuscole e deve corrispondere ai codici negozio inseriti nel tuo account Google My Business. Se stai implementando la funzionalità vetrina locale ospitata dal commerciante (implementazione completa), devi inviare l'attributo relativo al prezzo nel feed di inventario locale dei prodotti. Il prezzo deve corrispondere al prezzo visualizzato nella pagina di destinazione.
Dati di inventario facoltativi	sale_price [prezzo_scontato] sale_price_effective_date [decorrenza_prezzo_scontato] availability [disponibilità]	Si consiglia di utilizzare questi attributi adattandoli a ciascun articolo del feed per fornire maggiori dettagli su prezzi, quantità e informazioni sulla disponibilità. Se stai implementando una delle versioni della funzionalità vetrina locale ospitata dal commerciante, la disponibilità nel feed di inventario locale dei prodotti deve corrispondere alla disponibilità visualizzata nella pagina del tuo sito web.
Dati facoltativi per il ritiro in negozio	pickup_method [metodo_di_ritiro] pickup_sla [contratto_di_servizio_per_il_ritiro]	Si consiglia di utilizzare questi attributi adattandoli a tutti gli articoli del feed che possono essere ritirati in negozio.

Dati di inventario obbligatori

Questi attributi descrivono i dati di inventario di base per ciascun articolo e negozio.

codice negozio - L'ID negozio da Google My Business

Un codice alfanumerico univoco per ogni negozio locale. Utilizza gli stessi codici negozio che hai fornito nel tuo account Google My Business.

Quando includerlo: obbligatorio per tutti gli articoli.

Tipo	Stringa
Esempio	5198

Nota: l'attributo codice negozio fa distinzione tra maiuscole e minuscole e deve corrispondere ai codici negozio inseriti nel tuo account Google My Business.

id - An identifier of the item

A unique alphanumeric product identifier for an item across all stores.

If you sell the same item in multiple stores, the same id appears for multiple store codes. You should include one id per store and use quantity to indicate how many of each item is in stock in that store.

If you have multiple feeds of the same type for one country, IDs of items within different feeds must still be unique. If your SKUs are unique across your inventory and meet the requirements below, we suggest you use your SKUs for this attribute.

When to include: Required for all items.

Type	String
Example	421486

Important:

• Use the same id values in both your local products and local product inventory feeds.
• Starting and trailing whitespaces and carriage returns (0x0D) are removed.
• Each sequence of carriage return (0x0D) and whitespace characters (Unicode characters with the whitespace property) is replaced by a single whitespace (0x20).
• Only valid unicode characters are accepted; this excludes the following characters:
  • control characters (except carriage return 0x0D)
  • function characters
  • private area characters
  • surrogate pairs
  • non assigned code points (in particular any code point larger than 0x10FFFF)
• Once an item is submitted, the id can't change when you update your data feed or be used for a different product at a later point in time.
• Only include products that are available for purchase in stores.

quantity - The number of items in stock

The number of items in stock for the store. If you submit items that are temporarily out of stock, include a value of "0" for this attribute.

When to include: Required for all items.

Type	Integer
Example	4

Important:

• Google considers "in stock" items to be those with 3+ availability, "limited availability" to be 1-2, and "out of stock" to be 0. 
• For local inventory ads, the number expressed in quantity may be a placeholder representing availability.

price - Price of the item

The regular price of your item. If you submit price here and in the local products feed, this price will override the price in the local products feed for the associated store.

When to include: Required for all items.

Type	Number (Currency is automatically assigned based on the country where the store is located.)
Example	299.99

Important:

• This attribute is required in either the local products feed for national default pricing or in this feed for any store-specific overrides.

Dati di inventario facoltativi

Puoi usare questi attributi per fornire ulteriori informazioni su prezzo, quantità e disponibilità degli articoli.

sale price - Advertised sale price of the item

The advertised temporary sale price that denotes a store-specific override of the 'price' attribute in this feed and the local products feed.

We recommend submitting the sale price effective date attribute for any items with sale prices, as this will determine when your sale price should be live. If the sale price effective date isn't submitted, the sale price will be in effect for that item for as long as it is submitted in your feed.

Type	Number
Example	279.99

 

Note: Any price value submitted in an incremental feed won't automatically remove a sale price value from a previous feed. To remove a sale price using the incremental feed, include an expired value in the sale price effective date attribute.

sale price effective date - Date range during which an item is on sale

The dates during which the advertised sale price is effective.

Note: Time zone is optional [YYYY-MM-DDThh:mm:ss[Z|(+|-)hh:mm]. If time zone is absent, Google assumes the local time zone for each store. Additionally, note that we are using 24h time for the hours values.

Learn more about sales price definitions.

Type	Text (string), ISO8601, with start and end dates separated by a forward slash (/)
Example	UTC example: 2009-07-19T17:00:00Z/2009-07-27T05:00:00Z PST example: 2009-07-19T09:00:00-08:00/2009-07-26T21:00:00-08:00

availability - Availability status of the item

• 'in stock': Indicates that the item is in stock at your local store.
• 'out of stock': Indicates that the item is out stock at your local store.
• 'limited availability': Indicates that only a few items are left in stock at your local store.
• 'on display to order': Indicates that the item is on display to order at your local store (e.g. a refrigerator that needs to be shipped from a warehouse). For items on display to order, submit the value 'on display to order' along with the value "1" for the quantity attribute.

Important:

• Google considers "in stock" items to be those with 3+ availability, "limited availability" to be 1-2, and "out of stock" to be 0. 
• If you use a different value, your item won't be processed. The value you provide for this attribute may or may not appear in Google Shopping results as submitted.

Note: You should only submit items that are out of stock if they have the availability attribute with the value ‘out of stock’ and the quantity attribute with the value "0."

Type	Text (string). Must be one of the 4 accepted values: 'in stock,' 'out of stock,' 'limited availability,' and 'on display to order'
Example	in stock

 

Dati facoltativi per il ritiro in negozio

Aggiungi questi attributi al feed di inventario locale dei prodotti per fornire i dati di ritiro relativi a un determinato negozio oppure aggiungili al feed dei prodotti locali per ciascun articolo in cui i valori siano veri in tutti i negozi (ad es. un cliente può ritirare il televisore XYZ in tutti i tuoi negozi su territorio nazionale).

pickup_method [metodo_di_ritiro]: opzione di ritiro dell'articolo in negozio

Specifica l'opzione di ritiro dell'articolo:

• "acquistare": l'intera transazione avviene online.
• "prenotare": l'articolo viene prenotato online e la transazione avviene in negozio.
• "spedizione in negozio": l'articolo viene acquistato online e spedito in un negozio locale dove il cliente può ritirarlo.
• "non supportato": per questo articolo non è disponibile il ritiro in negozio.

Tipo	Testo (stringa). Deve trattarsi di uno dei tre valori accettati: "acquistare", "prenotare" o "non supportato"
Esempio	buy

pickup_SLA [contratto_di_servizio_per_il_ritiro]: tempistiche per il ritiro dell'articolo in negozio

Indica la data prevista in cui un ordine sarà pronto per il ritiro, in relazione a quando viene effettuato l'ordine.

• "stesso giorno": indica che l'articolo è disponibile per il ritiro il giorno stesso in cui l'ordine è stato effettuato, soggetto a orari limite.
• "giorno successivo": indica che l'articolo è disponibile per il ritiro il giorno successivo a quello in cui è stato effettuato l'ordine.
• "1 giorno": indica che l'articolo verrà spedito in un negozio, dove il cliente potrà ritirarlo nel giro di 1 giorno.
• "2 giorni:": indica che l'articolo verrà spedito in un negozio, dove il cliente potrà ritirarlo nel giro di 2 giorni.
• "3 giorni:": indica che l'articolo verrà spedito in un negozio, dove il cliente potrà ritirarlo nel giro di 3 giorni.
• "4 giorni:": indica che l'articolo verrà spedito in un negozio, dove il cliente potrà ritirarlo nel giro di 4 giorni.
• "5 giorni:": indica che l'articolo verrà spedito in un negozio, dove il cliente potrà ritirarlo nel giro di 5 giorni.
• "6 giorni:": indica che l'articolo verrà spedito in un negozio, dove il cliente potrà ritirarlo nel giro di 6 giorni.
• "7 giorni:": indica che l'articolo verrà spedito in un negozio, dove il cliente potrà ritirarlo nel giro di 7 giorni.
• "più settimane": indica che l'articolo verrà spedito in un negozio, dove il cliente potrà ritirarlo dopo un periodo superiore a una settimana.

Tipo	Testo (stringa). Deve essere uno dei 2 valori accettati: "same day" o "next day"
Esempio	stesso giorno