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 dettagliati tramite l'API Content for Shopping. Questi dati includono informazioni sulle funzionalità e sui vantaggi del prodotto, sulle varianti e sulle immagini del prodotto.
Ulteriori vantaggi delle informazioni dettagliate sul prodotto 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 accurate sui prodotti che permettono di prendere decisioni di acquisto
- 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 delle richieste parziali contenenti gli attributi per la risorsa products che costituiscono 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 che deriva dai valori che fornisci per gli attributi channel, contentLanauge, feedLabel e offerId. Ad esempio, online:en:US:1111111111. Per i dati di prodotto dettagliati, includi i 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 di identificatore univoco fornito 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, come informazioni su brand, genere, taglia e colore, nell'attributo title aiuta i clienti a determinare rapidamente se stanno guardando il prodotto giusto. Per linee guida e requisiti aggiuntivi per i titoli dei prodotti, vedi 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 esaustiva del prodotto, fornita tramite l'attributo description, può aiutare i clienti a informare i clienti del prodotto in modi diversi da specifiche e immagini. Per ulteriori linee guida e requisiti per le 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. Consigliamo di fornire più immagini di alta qualità che mostrano il prodotto da diverse angolazioni e in contesti diversi. Per linee guida e requisiti aggiuntivi per le immagini prodotto, consulta la sezione link immagine: 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 le varianti di
prodotti simili. Per le linee guida su come e quando raggruppare i prodotti, nonché sui requisiti e sulle best practice, consulta la sezione 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 con i 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
linee guida e requisiti aggiuntivi 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 nella pagina di descrizione del prodotto mostra ulteriori informazioni sul prodotto sotto l'immagine prodotto (il layout può variare a seconda che si tratti di pagine desktop o per dispositivi mobili). Utilizza l'attributo productDetails per fornire un elenco
di oggetti dei dettagli del prodotto, ciascuno dei quali include un attributo sectionName,
attributeName e attributeValue. Ti consigliamo di fornire almeno
sei dettagli del prodotto. Per linee guida e requisiti aggiuntivi per i dettagli del prodotto, vedi 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 valori sia per brand che per MPN in modo che possiamo identificare il tuo prodotto. Per scoprire di più sui tipi di identificatori, consulta Informazioni sui codici identificativi di prodotto.
Richiesta di esempio
"gtin": "842776114952",
"brand": "Google",
"mpn": "GA01188-US"
Esempio: caricare 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"
}