Importer des données produit enrichies pour les pages de description des produits

Une page de description de produit permet aux acheteurs de découvrir les caractéristiques et les avantages de votre produit avant d'effectuer leur achat sur Shopping Actions. Vous pouvez créer des pages de description détaillées en important des données produit enrichies via Content API for Shopping. Ces données incluent des informations sur les caractéristiques, les avantages et les variantes du produit, ainsi que des images.

Les données produit enrichies permettent également :

  • d'améliorer la visibilité des produits en fournissant des descriptions plus détaillées, qui aident les clients à trouver les produits dont ils ont besoin ;
  • de renforcer la confiance de vos clients en leur proposant des informations précises sur les produits, grâce auxquelles ils peuvent prendre des décisions d'achat éclairées ;
  • d'accroître le nombre de conversions en mettant clairement en avant la valeur de vos produits auprès des clients.

Ce guide vous explique comment utiliser Content API pour importer des données produit enrichies lorsque vous créez des produits à l'aide de la méthode products.insert. Les sections suivantes fournissent des corps de requête partiels contenant les attributs de la ressource products qui constituent des données produit enrichies. Pour consulter une requête JSON complète, accédez à la section Exemple : Importer des données produit enrichies à l'aide de la méthode products.insert.

Attributs d'ID produit

L'attribut id d'un produit, également appelé REST ID, est un identifiant unique dérivé des valeurs que vous fournissez pour les attributs channel, contentLanauge, targetCountry et offerId. Exemple : online:en:US:1111111111. Afin de fournir des données produit enrichies, renseignez des valeurs pour tous les attributs d'ID produit :

  • channel : "online" ou "local"
  • contentLanauge : code de langue à deux lettres, tel que "en" ou "fr"
  • targetCountry : code de pays à deux lettres, tel que "US" ou "FR"
  • offerId : chaîne d'identifiant unique fournie par le marchand

Exemple de requête

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

Titre du produit

L'attribut title fournit des informations clés sur le produit (marque, sexe, taille, couleur, etc.) et permet aux clients de déterminer rapidement s'ils consultent le bon produit. Pour obtenir des consignes supplémentaires et connaître les exigences liées aux titres de produits, consultez l'article title [titre] : définition.

Exemple de requête

"title": "Google Pixel 4 64GB Unlocked Smartphone 5.7' FHD Display 6GB RAM 4G Clear White"

Description du produit

Une description détaillée du produit, renseignée grâce à l'attribut description, vous permet de fournir des informations supplémentaires sur le produit, qui ne peuvent pas être incluses dans les caractéristiques ni dans les images. Pour obtenir des consignes supplémentaires et connaître les exigences liées aux descriptions des produits, consultez l'article description [description] : définition.

Exemple de requête

"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."

Images du produit

Améliorez les pages de description de vos produits en fournissant des images via les attributs imageLink et additionalImageLinks. Nous vous recommandons d'ajouter plusieurs images de haute qualité montrant le produit sous différents angles et dans différents contextes. Pour obtenir des consignes supplémentaires et connaître les exigences liées aux images de produits, consultez l'article image_link [lien_image] : définition.

Exemple de requête

"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 du produit

Vous pouvez utiliser l'attribut itemGroupId afin de définir des groupes de produits pour des variantes de produits similaires. Pour savoir quand et comment regrouper des produits, et pour connaître les exigences et les bonnes pratiques liées aux groupes de produits, consultez l'article item_group_id [identifiant_groupe_d'articles] : définition.

Exemple de requête

"itemGroupId": "pixels"

Points forts du produit

La section "Points forts du produit", qui s'affiche à côté de l'image principale sur la page de description d'un produit, proposer une courte liste des caractéristiques du produit. Utilisez l'attribut productHighlights pour fournir une liste d'éléments pour cette section. Nous vous recommandons de renseigner au moins cinq points forts. Pour obtenir des consignes supplémentaires et connaître les exigences liées aux points forts des produits, consultez l'article product_highlight [point_fort_produit] : définition.

Exemple de requête

"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"
  ]

Informations détaillées sur le produit

La section "Informations détaillées sur le produit" s'affiche sous l'image du produit sur sa page de description et fournit des informations supplémentaires (la mise en page de cette section peut être différente si vous la consultez sur un ordinateur ou sur un mobile). Utilisez l'attribut productDetails pour fournir une liste d'informations détaillées sur le produit. Chaque élément doit comprendre les attributs sectionName, attributeName et attributeValue. Nous vous recommandons de fournir au moins six éléments d'informations détaillées sur le produit. Pour obtenir des consignes supplémentaires et connaître les exigences liées aux informations détaillées sur le produit, consultez l'article product_detail [détail_produit] : définition.

Exemple de requête

  "productDetails": [
    {
      "sectionName": "General",
      "attributeName": "Product Type",
      "attributeValue": "Smartphone"
    },
    {
      "sectionName": "Display",
      "attributeName": "Resolution",
      "attributeValue": "FHD Display 6GB RAM"
    }
  ]

Codes produit uniques (code GTIN, marque et référence fabricant)

Google utilise des codes produit uniques pour identifier les produits. Nous vous recommandons vivement d'indiquer un code GTIN pour chacun de vos produits. Si vous ne fournissez pas de code GTIN, vous devez renseigner la marque et la référence fabricant du produit afin que nous puissions l'identifier. Pour en savoir plus sur les différents types d'identifiants, consultez l'article À propos des codes produit uniques.

Exemple de requête

"gtin": "842776114952",
"brand": "Google",
"mpn": "GA01188-US"

Exemple : Importer des données produit enrichies à l'aide de la méthode products.insert

La requête JSON ci-dessous est un exemple de requête pour un appel products.insert permettant d'importer des données produit enrichies.

POST https://www.googleapis.com/content/v2.1/{merchantId}/products
{
  "channel": "online",
  "contentLanguage": "en",
  "offerId": "pixel4",
  "targetCountry": "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"
}