Una pagina di descrizione del prodotto mette a disposizione degli acquirenti informazioni sulle funzionalità e sui vantaggi del tuo prodotto prima che questi completino l'acquisto con Acquista su Google. Puoi creare pagine di descrizione del prodotto dettagliate caricando dati di prodotto avanzati tramite l'API Content for Shopping. I dati avanzati di prodotto includono informazioni sulle caratteristiche e sui vantaggi del prodotto, sulle varianti del prodotto e sulle immagini del prodotto.
Ulteriori vantaggi dell'analisi dei dati di prodotto avanzati includono:
- Migliorare la scoperta dei prodotti fornendo descrizioni più dettagliate per aiutare i clienti a trovare prodotti che
- Aumentano la fiducia dei clienti fornendo informazioni accurate sul prodotto per poter prendere decisioni di acquisto sicure
- Contribuire a migliorare le conversioni comunicando più chiaramente 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 con il metodo products.insert. Le seguenti sezioni forniscono corpi di richieste parziali contenenti gli attributi per la risorsa products che compongono dati avanzati di prodotto. 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 da te forniti per gli attributi channel, contentLanauge, feedLabel e offerId. Ad esempio,
online:en:US:1111111111. Per i dati di prodotto avanzati, includi i valori per tutti gli attributi ID prodotto:
channel: "online" o "locale"contentLanguage: il codice della lingua di due lettere, ad esempio "en" o "fr"feedLabel: il codice della lingua di due lettere, ad esempio "US" o "FR"offerId: una stringa identificatore univoco fornita dal commerciante
Richiesta di esempio
"channel": "online",
"contentLanguage": "en",
"targetCountry": "US",
"feedLabel": "US",
"offerId": "1111111111"
Titolo del prodotto
L'inserimento dei dettagli chiave del prodotto, ad esempio informazioni su marca, genere, taglia e colore, nell'attributo title aiuta i clienti a determinare rapidamente se stanno guardando il prodotto giusto. Per ulteriori linee guida e requisiti relativi ai 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 del prodotto dettagliata, fornita tramite l'attributo description, può
aiutare i clienti a conoscere il prodotto in modi che le specifiche e le immagini
non possono fare. Per ulteriori linee guida e requisiti relativi alle descrizioni dei prodotti, consulta
descrizione: definizione.
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
contesti diversi. Per ulteriori linee guida e requisiti relativi alle immagini dei prodotti, consulta la pagina 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 del prodotto
Puoi utilizzare l'attributo itemGroupId per definire gruppi di prodotti per varianti di
prodotti simili. Per linee guida su come e quando raggruppare i prodotti, nonché sui requisiti e sulle best practice, consulta item_group_id: definizione.
Richiesta di esempio
"itemGroupId": "pixels"
Caratteristiche principali del prodotto
La sezione Caratteristiche principali del prodotto nella 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 articoli per la sezione delle caratteristiche principali del prodotto. Ti consigliamo di fornire almeno cinque caratteristiche principali del prodotto. Per
ulteriori linee guida e requisiti relativi alle caratteristiche principali del prodotto, consulta
product_highlights: 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 nella pagina di descrizione del prodotto mostra ulteriori informazioni sul prodotto sotto l'immagine del prodotto (il layout potrebbe variare in base alle pagine per computer desktop e dispositivi mobili). Utilizza l'attributo productDetails per fornire un elenco
di oggetti dettagli prodotto, ciascuno 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: definizione.
Richiesta di esempio
"productDetails": [
{
"sectionName": "General",
"attributeName": "Product Type",
"attributeValue": "Smartphone"
},
{
"sectionName": "Display",
"attributeName": "Resolution",
"attributeValue": "FHD Display 6GB RAM"
}
]
Codici identificativi di prodotto (GTIN, marca, MPN)
Google utilizza i codici identificativi di prodotto per identificare i prodotti. Ti consigliamo vivamente di fornire un valore GTIN per ciascuno dei tuoi prodotti. Se non fornisci un GTIN, devi fornire i valori sia per l'attributo brand che per l'MPN per consentirci di identificare il tuo prodotto. Per ulteriori informazioni sui tipi di identificatori, consulta Informazioni sui codici identificativi di prodotto.
Richiesta di esempio
"gtin": "842776114952",
"brand": "Google",
"mpn": "GA01188-US"
Esempio: carica dati di prodotto dettagliati con products.insert
Il seguente esempio JSON mostra un esempio di richiesta di una 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"
}