En las páginas de descripción de productos (PDP), los compradores pueden descubrir las características y los beneficios de tus productos antes de comprarlos en Comprar con Google. Puedes crear PDP enriquecidas subiendo datos de productos enriquecidos mediante Content API for Shopping. Los datos enriquecidos del producto incluyen información sobre las características y los beneficios del producto, las variantes y las imágenes del producto.
Estos son algunos de los beneficios adicionales de los datos enriquecidos de productos:
- Proporcionar descripciones más detalladas de los productos para mejorar el descubrimiento de los productos y ayudar a los clientes a encontrar
- Proporcionar información precisa de los productos para tomar decisiones de compra seguras
- Ayudar a mejorar la conversión transmitiendo con mayor claridad el valor de un producto a los clientes
En esta guía, se explica cómo usar Content API para subir datos de productos enriquecidos cuando se crean productos con el método products.insert. En las siguientes secciones, se proporcionan cuerpos de solicitudes parciales que contienen los atributos del recurso products que componen los datos de productos enriquecidos. Para obtener una solicitud JSON completa, consulta Ejemplo: Cómo subir datos de productos enriquecidos con products.insert.
Atributos de ID del producto
El atributo id de un producto, también conocido como REST ID, es un identificador único que se deriva de los valores que proporcionas para los atributos channel, contentLanauge, feedLabel y offerId. Por ejemplo, online:en:US:1111111111. Si deseas obtener datos de productos enriquecidos, incluye valores para todos los atributos de ID del producto:
channel: "en línea" o "local"contentLanguage: Es el código de idioma de dos letras, como "en" o "fr".feedLabel: Es el código de idioma de dos letras, como "US" o "FR".offerId: Es una cadena de identificador único que proporciona el comercio.
Solicitud de muestra
"channel": "online",
"contentLanguage": "en",
"targetCountry": "US",
"feedLabel": "US",
"offerId": "1111111111"
Título del producto
Incluir detalles clave del producto, como información sobre la marca, el género, el tamaño y el color, en el atributo title ayuda a los clientes a determinar rápidamente si están mirando el producto correcto. Para ver los lineamientos y requisitos adicionales para los títulos de los productos, consulta Título: Definición.
Solicitud de muestra
"title": "Google Pixel 4 64GB Unlocked Smartphone 5.7' FHD Display 6GB RAM 4G Clear White"
Descripción del producto
Una descripción detallada del producto, proporcionada a través del atributo description, puede ayudar a informar a los clientes sobre el producto de una manera que las especificaciones y las imágenes no pueden. Para conocer los lineamientos y requisitos adicionales de las descripciones de los productos, consulta descripción: definición.
Solicitud de muestra
"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."
Imágenes del producto
Proporciona imágenes de productos mediante los atributos imageLink y additionalImageLinks para mejorar las páginas de descripción de tus productos. Te recomendamos que proporciones varias imágenes de alta calidad que muestren el producto desde diferentes ángulos y en diferentes contextos. Para obtener lineamientos y requisitos adicionales para las imágenes de productos, consulta image_link: Definición.
Solicitud de muestra
"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"
]
Variantes de producto
Puedes usar el atributo itemGroupId para definir grupos de productos para variantes de productos similares. Si deseas conocer los lineamientos sobre cómo y cuándo agrupar productos, así como los requisitos y las prácticas recomendadas, consulta item_group_id: Definición.
Solicitud de muestra
"itemGroupId": "pixels"
Aspectos destacados del producto
La sección de aspectos destacados del producto en una página de descripción del producto muestra una lista breve y con viñetas de los detalles del producto, junto a la imagen principal del producto. Usa el atributo productHighlights para proporcionar una lista de artículos para la sección de aspectos destacados del producto. Te recomendamos que proporciones al menos cinco aspectos destacados del producto. Para obtener lineamientos y requisitos adicionales de aspectos destacados del producto, consulta product_highlights: Definición.
Solicitud de muestra
"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"
]
Detalles del producto
En la sección de detalles del producto en la página de descripción del producto, se muestra información adicional debajo de la imagen del producto (el diseño puede variar en las páginas para computadoras de escritorio y para dispositivos móviles). Usa el atributo productDetails para proporcionar una lista de objetos de detalles del producto, cada uno de los cuales incluye un atributo sectionName, attributeName y attributeValue. Te recomendamos que proporciones al menos seis detalles del producto. Para obtener lineamientos y requisitos adicionales para los detalles del producto, consulta product_detail: Definición.
Solicitud de muestra
"productDetails": [
{
"sectionName": "General",
"attributeName": "Product Type",
"attributeValue": "Smartphone"
},
{
"sectionName": "Display",
"attributeName": "Resolution",
"attributeValue": "FHD Display 6GB RAM"
}
]
Identificadores únicos de producto (GTIN, marca, MPN)
Google utiliza identificadores únicos de producto para identificar los productos. Te recomendamos que proporciones un valor de GTIN para cada uno de tus productos. Si no proporcionas un GTIN, debes proporcionar valores para la marca y el MPN con el fin de que podamos identificar el producto. Para obtener más información sobre los tipos de identificadores, consulta Acerca de los identificadores únicos de productos.
Solicitud de muestra
"gtin": "842776114952",
"brand": "Google",
"mpn": "GA01188-US"
Ejemplo: Sube datos de productos enriquecidos con products.insert
En la siguiente muestra de JSON, se muestra un ejemplo de una solicitud de una llamada products.insert para subir datos de productos enriquecidos.
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"
}