Loading
Guida introduttiva a B2C Commerce
Riferimento ai campi del feed di prodotto per Google

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 true o false.
  • 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à:

  1. Prodotto variante: B2C Commerce controlla innanzitutto il valore dell'attributo nella variante di prodotto.
  2. Gruppo di variazioni: Se la variante non ha il valore dell'attributo, B2C Commerce controlla il gruppo di variazioni (se pertinente).
  3. 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:

  1. 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.
  2. 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.
Nota
Nota Se il prezzo di listino risolto è uguale al prezzo scontato, B2C Commerce compila solo il campo prezzo e 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.

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.

Avvertenza
Avvertenza Se per più del 30% dei tuoi prodotti mancano i campi obbligatori, Google potrebbe rifiutare l'intero feed. Verificare che i dati del catalogo siano completi prima di attivare la sincronizzazione giornaliera dei feed.
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.

 
Caricamento
Salesforce Help | Article