Datos de productos enriquecidos para páginas de descripción de productos

Las páginas de descripción de productos (PDP) les enseñan a los compradores sobre las características y los beneficios de tu producto antes de que completen su compra con Comprar con Google. Puedes crear PDP enriquecidas si subes datos de productos enriquecidos mediante Content API for Shopping. Los datos enriquecidos de productos incluyen información sobre sus características y beneficios, imágenes y variantes del producto.

Entre los beneficios adicionales de los datos de productos enriquecidos, se incluyen los siguientes:

  • Mejorar el descubrimiento de productos con descripciones más detalladas para ayudar a los clientes a encontrar productos que satisfagan sus necesidades
  • Proporciona información precisa del producto para aumentar la confianza de los clientes y que permita tomar decisiones de compra seguras.
  • Ayudar a mejorar la conversión, ya que transmite de manera más clara 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 creas productos con el método products.insert. En las siguientes secciones, se proporcionan cuerpos de solicitud parciales que contienen los atributos para el recurso products que conforman datos de productos enriquecidos. Para obtener una solicitud JSON completa, consulta Ejemplo: Sube 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. Para 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 proporcionada por el comercio.

Solicitud de muestra

"channel": "online",
"contentLanguage": "en",
"targetCountry": "US",
"feedLabel": "US",
"offerId": "1111111111"

Título del producto

Agregar 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. Si deseas conocer los lineamientos y requisitos adicionales para los títulos de los productos, consulta el artículo sobre 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 educar a los clientes sobre el producto de formas que las especificaciones y las imágenes no pueden hacerlo. Para conocer los lineamientos y requisitos adicionales de las descripciones de los productos, consulta description: 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

Para mejorar las páginas de descripción de tus productos, proporciona imágenes del producto mediante los atributos imageLink y additionalImageLinks. Te recomendamos que proporciones varias imágenes de alta calidad en las que se muestre el producto desde diferentes ángulos y en distintos contextos. Para obtener lineamientos y requisitos adicionales sobre las imágenes del producto, 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. Para conocer los lineamientos sobre cómo y cuándo agrupar productos, además de los requisitos y las prácticas recomendadas, consulta item_group_id: Definición.

Solicitud de muestra

"itemGroupId": "pixels"

Aspectos destacados del producto

En la sección de aspectos destacados del producto de una página de descripción, se muestra una lista breve y con viñetas de los detalles del producto junto a la imagen principal. Usa el atributo productHighlights para proporcionar una lista de artículos para la sección de aspectos destacados del producto. Recomendamos proporcionar al menos cinco aspectos destacados del producto. Para conocer lineamientos adicionales y requisitos sobre los 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 de una página de descripción del producto, se muestra información adicional del producto debajo de la imagen del producto (el diseño puede variar entre las páginas para computadoras de escritorio y 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. Recomendamos proporcionar al menos seis detalles del producto. Si deseas 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 usa identificadores únicos 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 a fin de que podamos identificar tu 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 presenta 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"
}