Una pagina di descrizione del prodotto mette a disposizione degli acquirenti informazioni sulle caratteristiche e sui vantaggi del tuo prodotto prima che questi completino l'acquisto con Acquista su Google. Puoi creare pagine di dettaglio del prodotto avanzate caricando dati di prodotto avanzati tramite l'API Content for Shopping. I dati di prodotto avanzati includono informazioni sulle caratteristiche e sui vantaggi del prodotto, sulle varianti del prodotto e sulle immagini del prodotto.
Ulteriori vantaggi dei dati di prodotto avanzati includono:
- Migliorare la scoperta dei prodotti fornendo descrizioni più dettagliate per aiutare i clienti a trovare i prodotti che soddisfano le loro esigenze
- Aumentare la fiducia dei clienti fornendo informazioni sui prodotti accurate che consentano di prendere decisioni di acquisto consapevoli
- Contribuire a migliorare le conversioni comunicando in modo più chiaro il valore di un prodotto ai clienti
Questa guida spiega come utilizzare l'API Content per caricare dati di prodotto avanzati durante la creazione di prodotti utilizzando il metodo products.insert. Le
seguenti sezioni forniscono corpi delle richieste parziali contenenti gli attributi
della risorsa products
che compongono i dati di prodotto avanzati. Per una richiesta JSON completa, consulta
Esempio: caricamento di dati di prodotto avanzati utilizzando products.insert.
Attributi ID prodotto
L'attributo id di un prodotto, noto anche come REST ID, è un identificatore univoco derivato dai valori che fornisci per gli attributi channel, contentLanauge, feedLabel e offerId. Ad esempio,
online:en:US:1111111111. Per i dati di prodotto avanzati, includi valori per tutti gli attributi
ID prodotto:
channel: "online" o "locale"contentLanguage: il codice lingua di due lettere, ad esempio "en" o "fr".feedLabel: il codice lingua di due lettere, ad esempio "US" o "FR".offerId: una stringa identificatore univoca fornita dal commerciante
Richiesta di esempio
"channel": "online",
"contentLanguage": "en",
"targetCountry": "US",
"feedLabel": "US",
"offerId": "1111111111"
Titolo del prodotto
Inserire i dettagli chiave del prodotto, come informazioni su marca, genere, taglia e
colore, nell'attributo title aiuta i clienti a determinare rapidamente se
stanno esaminando il prodotto giusto. Per ulteriori linee guida e requisiti per
i titoli dei prodotti, consulta
Titolo: definizione.
Richiesta di esempio
"title": "Google Pixel 4 64GB Unlocked Smartphone 5.7' FHD Display 6GB RAM 4G Clear White"
Descrizione prodotto
Una descrizione avanzata del prodotto, fornita tramite l'attributo description, può aiutare
a informare i clienti sul prodotto in modi che le specifiche e le immagini
non possono. Per ulteriori linee guida e requisiti per le descrizioni dei prodotti, consulta
description: Definition.
Richiesta di esempio
"description": "The Google phone. MotionSense, an evolved camera, and the new
Google Assistant make Pixel 4 our most helpful phone yet. Studio-like photos.
Without the studio. Shoot without the flash. Capture rich detail and color, even
in the dark, with the next generation of Night Sight. Capture the cosmos. The
camera that can take photos of the Milky Way."
Immagini dei prodotti
Migliora le pagine di descrizione dei prodotti fornendo immagini dei prodotti tramite gli attributi
imageLink e additionalImageLinks. Ti consigliamo di fornire
più immagini di alta qualità che mostrino il prodotto da diverse angolazioni e in
diversi contesti. Per ulteriori linee guida e requisiti per le immagini
di prodotto, consulta
image_link: Definizione.
Richiesta di esempio
"imageLink": "https://example.com/gallery/500/image1.jpg",
"additionalImageLinks": [
"https://example.com/gallery/500/image2.jpg",
"https://example.com/gallery/500/image3.jpg",
"https://example.com/gallery/500/image4.jpg",
"https://example.com/gallery/500/image5.jpg"
]
Varianti dei prodotti
Puoi utilizzare l'attributo itemGroupId per definire gruppi di prodotti per le varianti di
prodotti simili. Per linee guida su come e quando raggruppare i prodotti, nonché
requisiti e best practice, consulta
item_group_id: definizione.
Richiesta di esempio
"itemGroupId": "pixels"
Caratteristiche principali del prodotto
La sezione delle caratteristiche principali del prodotto in una pagina di descrizione del prodotto mostra un breve elenco puntato dei dettagli del prodotto accanto all'immagine principale del prodotto. Utilizza l'attributo
productHighlights per fornire un elenco di elementi per la sezione
caratteristiche principali del prodotto. Ti consigliamo di fornire almeno cinque caratteristiche principali del prodotto. Per
ulteriori linee guida e requisiti per le caratteristiche principali del prodotto, consulta
caratteristiche principali del prodotto: definizione.
Richiesta di esempio
"productHighlights": [
"6GB RAM lets you enjoy multitasking conveniently",
"Touch screen feature offers user friendly interface",
"Its 16MP and 12MP rear cameras allow you capture high-quality pictures"
]
Dettagli del prodotto
La sezione dei dettagli del prodotto in una pagina di descrizione del prodotto mostra ulteriori
informazioni sul prodotto sotto l'immagine del prodotto (il layout può variare tra
le pagine desktop e mobile). Utilizza l'attributo productDetails per fornire un elenco
di oggetti di dettagli del prodotto, ognuno dei quali include un attributo sectionName,
attributeName e attributeValue. Ti consigliamo di fornire almeno
sei dettagli del prodotto. Per ulteriori linee guida e requisiti per i dettagli del prodotto, consulta product_detail: Definition.
Richiesta di esempio
"productDetails": [
{
"sectionName": "General",
"attributeName": "Product Type",
"attributeValue": "Smartphone"
},
{
"sectionName": "Display",
"attributeName": "Resolution",
"attributeValue": "FHD Display 6GB RAM"
}
]
Codici identificativi di prodotto univoci (GTIN, marca, MPN)
Google utilizza codici identificativi di prodotto univoci per identificare i prodotti. Ti consigliamo vivamente di fornire un valore GTIN per ciascuno dei tuoi prodotti. Se non fornisci un GTIN, devi fornire valori sia per marca sia per MPN in modo che possiamo identificare il tuo prodotto. Per ulteriori informazioni sui tipi di identificatori, consulta la sezione Informazioni sui codici identificativi di prodotto.
Richiesta di esempio
"gtin": "842776114952",
"brand": "Google",
"mpn": "GA01188-US"
Esempio: carica dati di prodotto avanzati con products.insert
Il seguente esempio JSON mostra una richiesta di chiamata products.insert
per il caricamento di dati di prodotto avanzati.
POST https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/products
{
"channel": "online",
"contentLanguage": "en",
"offerId": "pixel4",
"targetCountry": "US",
"feedLabel": "US",
"title": "Google Pixel 4 64GB Unlocked Smartphone 5.7' FHD Display 6GB RAM 4G Clear White",
"description": "The Google phone. Motion Sense, an evolved camera, and the new Google Assistant make Pixel 4 our most helpful phone yet. Studio-like photos. Without the studio. Shoot without the flash. Capture rich detail and color, even in the dark, with the next generation of Night Sight. Capture the cosmos. The camera that can take photos of the Milky Way.",
"imageLink": "https://example.com/gallery/500/image1.jpg",
"additionalImageLinks": [
"https://example.com/gallery/500/image2.jpg",
"https://example.com/gallery/500/image3.jpg",
"https://example.com/gallery/500/image4.jpg",
"https://example.com/gallery/500/image5.jpg"
],
"brand": "Google",
"googleProductCategory": "Electronics > Communications > Telephony > Mobile Phones",
"gtin": "842776114952",
"mpn": "GA01188-US",
"price": {
"currency": "USD",
"value": "549.99"
},
"salePrice": {
"currency": "USD",
"value": "549.99"
},
"productHighlights": [
"6GB RAM lets you enjoy multitasking conveniently",
"Touch screen feature offers user friendly interface",
"Its 16MP and 12MP rear cameras allow you capture high-quality pictures"
],
"productDetails": [
{
"sectionName": "General",
"attributeName": "Product Type",
"attributeValue": "Smartphone"
},
{
"sectionName": "Display",
"attributeName": "Resolution",
"attributeValue": "FHD Display 6GB RAM"
}
],
"availability": "in stock",
"condition": "new",
"includedDestinations": [
"Shopping Actions"
],
"excludedDestinations": [
"Shopping Ads"
],
"sellOnGoogleQuantity": 100,
"shippingLabel": "US_Test"
}