Ti trovi qui:
Riferimento ai campi del feed di prodotto per Google
Informazioni di riferimento per i campi del feed dei prodotti utilizzati con Google, inclusi i campi obbligatori, i campi facoltativi e le relative mappature predefinite agli attributi di B2C Commerce.
Funzionamento delle mappature predefinite
Il feed dei prodotti di Google utilizza un sistema di mappatura basato sui dati per trasformare i dati di prodotto di B2C Commerce nel formato richiesto da Google. Quando è in grado di derivare un valore utilizzando gli attributi standard di B2C Commerce, B2C Commerce crea una mappatura predefinita che specifica la modalità di derivazione del valore:
- Mappature dei campi: Mappare direttamente a un singolo attributo di prodotto B2C Commerce, ad esempio nome, marca o prezzo.
- Mappature derivate: È possibile calcolare i valori da più attributi o applicare trasformazioni, ad esempio rimuovendo il codice HTML dalle descrizioni o formattando i prezzi con i codici di valuta.
- Mappature costanti: Utilizzare un valore fisso per tutti i prodotti.
- Mappature di fallback: Mappare prima all'attributo principale, quindi eseguire il fallback su un'alternativa se l'attributo principale è vuoto per quel prodotto. Ad esempio, il titolo utilizza il nome, ricorrendo a masterProductName se il nome è vuoto.
È possibile personalizzare i campi contrassegnati come Sostituibili: Sì in Business Manager. Campi contrassegnati come sovrascrivibili: No sono gestiti dal sistema e visibili nella tabella Mappatura campi, ma non è possibile modificarne le mappature.
Formattazione automatica dei campi
B2C Commerce applica la formattazione automatica ai valori dei campi prima che vengano scritti nel feed. Questa formattazione avviene indipendentemente dal fatto che si mantenga la mappatura predefinita o la si sostituisca con un attributo diverso. Quando si sostituisce una mappatura predefinita, non è necessario adattare i dati del catalogo in modo che corrispondano al formato di Google: la trasformazione è gestita da B2C Commerce.
La formattazione si applica come segue:
- Date: I valori di data e dataora sono formattati in ISO 8601. Le date non valide vengono omesse dal feed.
-
Booleani: I valori vengono convertiti in
trueofalse. - Numeri: I valori numerici vengono formattati con la precisione richiesta (ad esempio, numeri interi senza decimali o due posizioni decimali per i prezzi). I valori non validi o null vengono omessi.
- Prezzi: I valori positivi vengono formattati con due cifre decimali e concatenati con il codice della valuta.
- Descrizioni: I tag HTML vengono rimossi dal testo.
- Enumerazioni: Valori quali disponibilità e age_group vengono convalidati in base ai valori consentiti predefiniti.
Ereditarietà degli attributi personalizzati per le varianti
Quando si esegue la mappatura di un attributo personalizzato a un campo Google, B2C Commerce risolve automaticamente i valori degli attributi per le varianti di prodotto utilizzando la seguente catena di ereditarietà:
- Prodotto variante: B2C Commerce controlla innanzitutto il valore dell'attributo nella variante di prodotto.
- Gruppo di variazioni: Se la variante non ha il valore dell'attributo, B2C Commerce controlla il gruppo di variazioni (se pertinente).
- Prodotto principale: Se il valore non è valido per il gruppo di variazioni, B2C Commerce controlla il prodotto principale.
Questa catena di ereditarietà garantisce che gli attributi personalizzati definiti a livello di master o di gruppo di variazioni vengano ereditati automaticamente dalle varianti senza richiedere l'immissione di dati duplicati.
Idoneità del prodotto
I prodotti visualizzati nel feed sono controllati da due livelli:
- Regole di filtro prodotto: Regole di inclusione ed esclusione configurabili che determinano quali prodotti vengono inviati a Google. Per impostazione predefinita, le regole corrispondono a prodotti online e ricercabili, ma è possibile modificarle. Vedere Regole di filtro dei prodotti per il feed dei prodotti.
-
Esclusioni automatiche: Indipendentemente dalle regole di filtro, B2C Commerce esclude sempre dal feed:
- Prodotti principali (le varianti vengono invece esportate)
- Gruppi di variazioni (le varianti vengono invece esportate)
- Set di prodotti. I bundle con componenti fissi sono supportati e vengono inviati a Google come prodotti autonomi.
Dopo che un prodotto è stato incluso nel feed, puoi controllare ulteriormente la sua posizione in Google mappando i campi included_destination, excluded_destination e pausa. Ad esempio, puoi utilizzare excluded_destination per escludere un prodotto dagli annunci Shopping e allo stesso tempo inviarlo alle schede gratuite. Vedere la tabella Campi facoltativi.
Derivazione del prezzo di listino
Il campo prezzo viene mappato al prezzo normale (di listino) di un prodotto. B2C Commerce non dispone di un concetto di "prezzo di listino" incorporato; I team di storefront implementano i prezzi di listino utilizzando diverse strategie per i listini prezzi. Per soddisfare questa varietà, B2C Commerce ricava il prezzo di listino del feed in due passaggi:
- Listino prezzi di listino selezionato. Se si seleziona un listino prezzi in Listino prezzi di listino nella scheda Impostazioni generali, B2C Commerce utilizza il prezzo di tale listino. Il menu a discesa contiene solo i listini prezzi attivi e i cui prezzi sono espressi nella valuta del feed. Se in seguito si disattiva il listino prezzi selezionato, riconfigurare il listino prezzi di listino in modo che punti a un listino prezzi diverso.
-
Percorso del listino prezzi di vendita. Se non si seleziona un listino prezzi di listino, B2C Commerce ricava il prezzo di listino dal listino prezzi di vendita selezionato dal motore di ricerca B2C Commerce per il prodotto. Il motore prezzi valuta tutti i listini prezzi applicabili al prodotto, non solo quelli attivi, e restituisce il prezzo migliore (più basso) insieme al relativo listino prezzi di origine. Da tale listino prezzi di vendita, B2C Commerce applica una delle due regole seguenti:
- Se il listino prezzi di vendita ha un listino prezzi padre, B2C Commerce segue la catena principale fino alla radice e restituisce il prezzo dal listino prezzi radice. Questo corrisponde al comportamento predefinito degli storefront SFRA e SiteGenesis.
- Se il listino prezzi di vendita non ha un listino prezzi principale, B2C Commerce restituisce il prezzo massimo in tutti i listini prezzi applicabili per il prodotto. Questo corrisponde al comportamento predefinito degli storefront PWA Kit.
L'impostazione del listino prezzi di listino nella scheda Impostazioni generali è il modo più affidabile per garantire che il prezzo di listino nel feed corrisponda a ciò che gli acquirenti vedono nello storefront, in particolare per gli storefront con logica di determinazione dei prezzi personalizzata, prezzi basati su zone o listini multivaluta.
Derivazione del prezzo di vendita
Il campo sale_price viene mappato all'attributo salePrice di B2C Commerce più la valuta configurata. Il valore salePrice non viene ricavato da un singolo listino prezzi: il motore prezzi di B2C Commerce seleziona il prezzo migliore (più basso) tra tutti i listini prezzi applicabili per il prodotto, indipendentemente dalla gerarchia del listino prezzi o dalla configurazione di una gerarchia.
Poiché il prezzo visualizzato nello storefront è popolato dallo stesso motore, il valore sale_price inviato a Google corrisponde a ciò che gli acquirenti vedono sul sito.
Se il prezzo scontato risolto è uguale al prezzo di listino risolto (campo prezzo ), B2C Commerce omette sale_price dalla voce del feed del prodotto. In questo modo si evita di mostrare un prezzo barrato in Google per i prodotti che non sono in saldo. Vedere Derivazione del prezzo di listino.
Se lo storefront utilizza una logica di determinazione dei prezzi personalizzata, ad esempio la selezione del listino prezzi in base alla zona o in base all'area geografica, il calcolo del prezzo scontato predefinito potrebbe non corrispondere a quello visualizzato dagli acquirenti. In questi casi, l'impostazione del listino prezzi di listino nella scheda Impostazioni generali è il modo più affidabile per allineare il feed allo storefront.
Campi obbligatori
I seguenti campi sono obbligatori per una voce di feed di prodotto valida. I prodotti a cui mancano i campi obbligatori sono comunque inclusi nel feed, ma Google potrebbe rifiutare le singole righe. Utilizza l'anteprima del feed di prodotto per identificare i prodotti con campi obbligatori mancanti e correggerli prima di attivare la sincronizzazione giornaliera dei feed. Vedere Anteprima del feed di prodotto.
| Campo Google | Tipo | Mappatura SFCC predefinita | Descrizione | Sostituibile |
|---|---|---|---|---|
| id | string | id (ID prodotto) | Identificatore univoco del prodotto (SKU). Gestito da B2C Commerce. Mantieni stabile tutti gli aggiornamenti dei feed. | No |
| Titolo | string | name, fallback a masterProductName se vuoto | Titolo del prodotto. Evita il testo promozionale. | Sì |
| description | string | longDescription, torna a shortDescription (HTML rimosso) se vuoto | Descrizione completa del prodotto. I tag HTML vengono rimossi automaticamente. | Sì |
| Collegamento | string | productUrl (generato) | URL pagina dettagli prodotto. Generato utilizzando il nome host della configurazione di Einstein. Per PWA Kit e gli storefront headless, configurare i pattern URL separatamente. Vedere Configurazione dei formati URL per il feed di prodotto. | Sì |
| image_link | string | Tipo di visualizzazione immagine selezionato o ricerca del tipo di visualizzazione predefinito | URL dell'immagine principale del prodotto. Se si seleziona un tipo di visualizzazione in Tipo di visualizzazione immagine nella scheda Impostazioni generali, B2C Commerce utilizza tale tipo di visualizzazione. In caso contrario, B2C Commerce tenta di utilizzare il tipo di visualizzazione "large" e utilizza il primo tipo di visualizzazione disponibile. Poiché il fallback può selezionare un tipo di visualizzazione non adatto (ad esempio una vista campione), Salesforce consiglia di selezionare un tipo di visualizzazione specifico. Usa immagini ad alta risoluzione senza sovrapposizioni promozionali. | Sì |
| Disponibilità | string | Disponibilità (derivata) | Stato delle scorte. Valori ricavati dalla mappatura dei livelli di inventario di B2C Commerce ai valori di disponibilità di Google: in_stock, out_of_stock, preordine, backorder. Gestito dal sistema. |
No |
| price | number | Combina prezzo e valuta (listino prezzi di listino selezionato o percorso listino prezzi di vendita) | Prezzo standard (di listino) del prodotto con codice valuta, ad esempio "15,00 USD". Se si seleziona un listino prezzi in Listino prezzi nella scheda Impostazioni generali, B2C Commerce utilizza tale listino prezzi. In caso contrario, B2C Commerce ricava il prezzo di listino dal listino prezzi di vendita selezionato dal motore di ricerca di B2C Commerce. Vedere Derivazione del prezzo di listino. Sono inclusi solo i valori positivi. | Sì |
Campi facoltativi
I seguenti campi sono facoltativi e possono migliorare le schede di prodotto su Google. I campi facoltativi vengono omessi dal feed quando l'attributo mappato o il valore costante è vuoto. I campi con una mappatura predefinita ricavano automaticamente il loro valore; I campi senza una mappatura predefinita (visualizzati come "(Nessuno)") vengono popolati solo quando si esegue la mappatura di un attributo o si imposta un valore o un modello costante.
| Campo Google | Tipo | Mappatura SFCC predefinita | Descrizione | Sostituibile |
|---|---|---|---|---|
| sale_price | number | Combina salePrice e valuta se è attivo un prezzo scontato | Prezzo scontato con codice valuta, ad esempio "10.00 USD". B2C Commerce omette questo campo quando il prezzo scontato risolto è uguale al prezzo risolto. Vedere Derivazione del prezzo di vendita. | Sì |
| sale_price_effective_date | data | Combina salePriceStart e salePriceEnd | Intervallo di date dei prezzi di vendita in formato ISO 8601, ad esempio "2016-02-24T11:07+0100/2016-02-29T23:07+0100". | Sì |
| availability_date | data | inStockDate | Data in cui un prodotto in preordine diventa disponibile, ad esempio "2016-02-24T11:07+0100". | Sì |
| expiration_date | data | onlineTo | Data in cui il prodotto non deve più comparire nei feed, ad esempio "2016-07-11T11:07+0100". | Sì |
| Marchio | string | Marchio | Nome brand. | Sì |
| gtin | string | ean, ripiega su upc se l'EAN non è disponibile | Global Trade Item Number (UPC/EAN). Migliora l'abbinamento dei prodotti. | Sì |
| Mpn | string | Mpn | Numero di parte del produttore. | Sì |
| identifier_exists | booleano | Calcolato in base al fatto che il prodotto disponga di identificatori standard (EAN, UPC, MPN o marca) | Indica se il prodotto dispone di identificatori standard. | Sì |
| is_bundle | booleano | Restituisce true quando bundleProductIds è popolato |
Indica se il prodotto è un bundle. Gestito da B2C Commerce. | No |
| item_group_id | string | masterProductId | Raggruppa le varianti di prodotto che condividono lo stesso prodotto principale, ad esempio "AB12345". | Sì |
| product_type | string | categoryPath (percorso completo) | Categoria di prodotto definita dal commerciante, ad esempio "Home > Donna > Abiti > Maxi Abiti". | Sì |
| google_product_category | string | (nessuna) | Categoria di prodotto definita da Google, ad esempio "Abbigliamento & , Accessori > , Abbigliamento, > Capispalla > , Cappotti, & Giacche". | Sì |
| additional_image_link | string | additionalImageLink | URL di immagini aggiuntivi per una presentazione più ricca. | Sì |
| lifestyle_image_link | string | (nessuna) | URL dell'immagine dello stile di vita. | Sì |
| mobile_link | string | (nessuna) | URL pagina di destinazione ottimizzato per i dispositivi mobili. | Sì |
| virtual_model_link | string | (nessuna) | URL risorsa modello virtuale (3D). | Sì |
| ads_redirect | string | (nessuna) | URL utilizzato per reindirizzare il traffico degli annunci, ad esempio uno che include parametri di monitoraggio. | Sì |
| color | string | (nessuna) | Colore del prodotto. | Sì |
| Materiale | string | (nessuna) | Materiali primari del prodotto, come la "pelle". | Sì |
| pattern | string | (nessuna) | Modello del prodotto, ad esempio "a pois". | Sì |
| size | string | (nessuna) | Taglia del prodotto, ad esempio "XL". | Sì |
| size_system | string | (nessuna) | Sistema di taglie, ad esempio "US". | Sì |
| size_type | string | (nessuna) | Tipo di taglia, ad esempio "normale". | Sì |
| Genere | string | (nessuna) | A chi è destinato il genere, ad esempio "maschio", "femmina" o "unisex". | Sì |
| age_group | string | (nessuna) | Fascia d'età target. Valori: neonato, neonato, bambino, bambini, adulto. |
Sì |
| per adulto | booleano | (nessuna) | Indica se il prodotto è adatto agli adulti. | Sì |
| Condizione | string | (nessuna) | Condizione del prodotto, ad esempio "nuovo", "usato" o "ricondizionato". | Sì |
| Confezione multipla | number | (nessuna) | Numero di prodotti identici in una confezione multipla definita dal commerciante. | Sì |
| product_highlight | string | (nessuna) | Un'evidenziazione chiave del prodotto, ad esempio "Supporta migliaia di app". | Sì |
| short_title | string | (nessuna) | Un titolo breve utilizzato in posizionamenti vincolati, ad esempio "Polo". | Sì |
| structured_title | string | (nessuna) | Titolo strutturato, inclusa l'origine del titolo, per i contenuti generati dall'intelligenza artificiale. | Sì |
| structured_description | string | (nessuna) | Descrizione strutturata, inclusa l'origine della descrizione, per i contenuti generati dall'intelligenza artificiale. | Sì |
| custom_label_0–custom_label_4 | string | (nessuna) | Etichette personalizzate utilizzate per segmentare i prodotti per i report e le offerte, ad esempio "Stagionali", "Saldi o "BestSeller". | Sì |
| product_length, product_width, product_height | number | (nessuna) | Dimensioni del prodotto con unità, ad esempio "20 pollici". | Sì |
| product_weight | number | (nessuna) | Peso del prodotto con unità, ad esempio "3,5 lb". | Sì |
| unit_pricing_measure | string | Combina unitQuantity e unitMeasure | Misura e dimensione del prodotto venduto, ad esempio "1,5 kg". | Sì |
| unit_pricing_base_measure | string | (nessuna) | L'unità di misura di base del prodotto per il prezzo, ad esempio "100 g". | Sì |
| energy_efficiency_class | string | (nessuna) | Classe di efficienza energetica, come "A+". | Sì |
| min_energy_efficiency_class | string | (nessuna) | Classe di efficienza energetica più bassa sull'etichetta del prodotto, ad esempio "A+++". | Sì |
| max_energy_efficiency_class | string | (nessuna) | Classe di efficienza energetica più elevata sull'etichetta del prodotto, ad esempio "D". | Sì |
| Certificazione | string | (nessuna) | Certificazione di prodotto, ad esempio "EC:EPREL:123456". | Sì |
| consumer_notice | string | (nessuna) | Un avviso per i consumatori, ad esempio un avviso della Proposition 65. | Sì |
| cost_of_goods_sold | number | (nessuna) | Costo della merce venduta con codice valuta, ad esempio "8,00 USD". | Sì |
| auto_pricing_min_price | number | (nessuna) | Prezzo minimo per gli sconti automatici, ad esempio "15,00 USD". | Sì |
| maximum_retail_price | number | (nessuna) | Prezzo di vendita al dettaglio massimo (utilizzato in alcune regioni, come l'India), ad esempio "15,00 INR". | Sì |
| rata | string | (nessuna) | Dettagli del pagamento rateale, ad esempio "6:30 EUR:199 EUR". | Sì |
| subscription_cost | string | (nessuna) | Dettagli sul costo dell'abbonamento, ad esempio "mese:12:35,00 USD". | Sì |
| loyalty_program | string | (nessuna) | Vantaggi del programma fedeltà, ad esempio "my_loyalty_program:silver:10 USD::10::free_member_shipping". | Sì |
| promotion_id | string | (nessuna) | Identificativo della promozione, ad esempio "ABC123". | Sì |
| Spedizione | string | (nessuna) | Dettagli delle spese di spedizione, ad esempio "US:CA:Overnight:16.00 USD". | Sì |
| free_shipping_threshold | string | (nessuna) | Valore minimo dell'ordine per la spedizione gratuita, ad esempio "US:16.00 USD". | Sì |
| carrier_shipping | string | (nessuna) | Spedizione calcolata dal corriere, ad esempio "US:80302:USPS_MEDIA_MAIL:1:3:2:5". | Sì |
| shipping_label | string | (nessuna) | Etichetta utilizzata per assegnare le regole di spedizione, ad esempio "deperibile". | Sì |
| shipping_length, shipping_width, shipping_height | number | (nessuna) | Dimensioni del pacco utilizzate per calcolare la spedizione, ad esempio "22 pollici". | Sì |
| shipping_weight | number | (nessuna) | Peso del pacco utilizzato per calcolare la spedizione, ad esempio "3 kg". | Sì |
| min_handling_time | number | (nessuna) | Tempo minimo di manipolazione del prodotto, ad esempio "1". | Sì |
| max_handling_time | number | (nessuna) | Tempo massimo di manipolazione del prodotto, ad esempio "3". | Sì |
| shipping_handling_business_days | string | (nessuna) | Giorni lavorativi in cui vengono gestiti gli ordini, ad esempio "US:Lun-Sab". | Sì |
| shipping_transit_business_days | string | (nessuna) | Giorni lavorativi in cui gli ordini sono in transito, ad esempio "US:Lun-Sab". | Sì |
| ships_from_country | string | (nessuna) | Paese da cui viene spedito il prodotto. Utilizza il codice Paese ISO 3166 di 2 lettere, ad esempio "US". | Sì |
| return_policy_label | string | (nessuna) | Etichetta utilizzata per assegnare una politica di restituzione, ad esempio "90 giorni". | Sì |
| included_destination | string | (nessuna) | Destinazioni in cui il prodotto deve essere incluso, ad esempio "Shopping_ads". | Sì |
| excluded_destination | string | (nessuna) | Destinazioni in cui il prodotto deve essere escluso, ad esempio "Shopping_ads". | Sì |
| shopping_ads_excluded_country | string | (nessuna) | Paesi esclusi dagli annunci Shopping, ad esempio "IT". | Sì |
| Pausa | string | (nessuna) | Mette in pausa l'elemento in una destinazione, ad esempio "annunci". | Sì |
| native_commerce | booleano | (nessuna) | Indica se il prodotto è idoneo per il commercio nativo, ovvero esperienze di acquisto che si svolgono direttamente all'interno delle piattaforme Google anziché nello storefront. Impostare questo valore booleano per prodotto per controllare l'idoneità. Questo campo non ha una mappatura predefinita, pertanto i prodotti non vengono contrassegnati come idonei a meno che non vengano mappati. | Sì |
| external_seller_id | string | (nessuna) | Identificativo del venditore per gli account con più venditori, ad esempio "NomePubblicoVenditore1991". | Sì |
| merchant_item_id | string | (nessuna) | Identificatore dell'oggetto del checkout fornito dal commerciante, ad esempio "some_checkout_item_id_1". | Sì |
Campi facoltativi aggiuntivi (dettagli prodotto)
Utilizza la sezione Campi facoltativi aggiuntivi della tabella Mappatura campi per inviare specifiche tecniche o altri attributi al campo product_detail di Google. Per ogni voce, mappare un attributo B2C Commerce e, facoltativamente, specificare un nome di sezione per raggruppare i dettagli correlati. Fare clic su Aggiungi attributo per aggiungere un altro dettaglio di prodotto.
Il campo product_detail fornisce agli acquirenti informazioni leggibili e strutturate su aspetti di un prodotto che altri campi non coprono e aiuta Google a far emergere i tuoi prodotti nelle esperienze di ricerca e basate sull'intelligenza artificiale. Per l'elenco completo degli attributi accettati e dei requisiti di formattazione, consulta Dettagli prodotto [product_detail] nella Guida di Google Merchant Center.
