Vous êtes ici :
Référence des champs du flux de produits pour Google
Informations de référence pour les champs du flux de produits utilisés avec Google, notamment les champs obligatoires, les champs facultatifs et leurs correspondances par défaut avec les attributs B2C Commerce.
Fonctionnement des mappages par défaut
Le flux de produits pour Google utilise un système de mappage basé sur les données pour transformer les données produit B2C Commerce dans le format requis par Google. Lorsque B2C Commerce peut dériver une valeur à l’aide d’attributs B2C Commerce standard, il crée un mappage par défaut qui spécifie la façon dont la valeur est dérivée :
- Mappages de champs: Mappage direct à un seul attribut de produit B2C Commerce, tel qu’un nom, une marque ou un prix.
- Mappages dérivés: Calculez des valeurs à partir de plusieurs attributs ou appliquez des transformations, par exemple en supprimant le code HTML des descriptions ou en formatant les prix avec des codes de devise.
- Mappages constants: Utilisez une valeur fixe pour tous les produits.
- Mappages de secours: Mappez d’abord à l’attribut principal, puis revenez à une alternative si l’attribut principal est vide pour ce produit. Par exemple, title utilise name, revenant à masterProductName si name est vide.
Vous pouvez personnaliser les champs marqués comme pouvant être remplacés : Oui, dans Business Manager. Champs marqués comme pouvant être remplacés : Non sont gérés par le système et visibles dans le tableau Mappage des champs, mais vous ne pouvez pas modifier leurs mappages.
Mise en forme automatique des champs
B2C Commerce applique une mise en forme automatique aux valeurs des champs avant qu’elles ne soient écrites dans le flux. Cette mise en forme se produit que vous conserviez le mappage par défaut ou que vous le remplaciez par un attribut différent. Lorsque vous remplacez un mappage par défaut, vous n’avez pas besoin d’adapter les données de votre catalogue au format de Google : B2C Commerce se charge de la transformation.
La mise en forme s’applique comme suit :
- Dates de l’événement: Les valeurs de date et d’heure sont formatées selon la norme ISO 8601. Les dates non valides sont omises du flux.
-
Booléens: Les valeurs sont converties en
trueoufalse. - Chiffres: Les valeurs numériques sont mises en forme avec la précision requise (par exemple, des entiers sans décimales ou deux décimales pour les prix). Les valeurs non valides ou nulles sont omises.
- Prix: Les valeurs positives sont mises en forme à deux décimales près et concaténées avec le code de la devise.
- Descriptions: Les balises HTML sont supprimées du texte.
- Énumérations: Des valeurs telles que la disponibilité et age_group sont validées par rapport à des valeurs autorisées prédéfinies.
Héritage d’attributs personnalisés pour les variantes
Lorsque vous mappez un attribut personnalisé à un champ Google, B2C Commerce résout automatiquement les valeurs d’attribut pour les variantes de produits à l’aide de la chaîne d’héritage suivante :
- Variante du produit: B2C Commerce vérifie d’abord la valeur de l’attribut dans la variante du produit.
- Groupe de variations: Si la variante n’a pas la valeur de l’attribut, B2C Commerce vérifie le groupe de variations (le cas échéant).
- Produit maître: Si le groupe de variations n’a pas la valeur, B2C Commerce vérifie le produit maître.
Cette chaîne d’héritage garantit que les attributs personnalisés définis au niveau du maître ou du groupe de variations sont automatiquement hérités par les variantes sans qu’il soit nécessaire de saisir des données en double.
Éligibilité du produit
Deux couches contrôlent les produits qui apparaissent dans le flux :
- Règles de filtrage des produits: Règles d’inclusion et d’exclusion configurables qui déterminent quels produits sont envoyés à Google. Par défaut, les règles correspondent aux produits en ligne et recherchables, mais vous pouvez les ajuster. Voir Règles de filtrage des produits pour le flux de produits.
-
Exclusions automatiques: Quelles que soient vos règles de filtrage, B2C Commerce exclut toujours les éléments suivants du flux :
- Produits maîtres (les variantes sont exportées à la place)
- Groupes de variations (les variantes sont exportées à la place)
- Ensembles de produits. Les offres groupées, qui comportent des composants fixes, sont prises en charge et envoyées à Google en tant que produits autonomes.
Une fois qu’un produit est inclus dans le flux, vous pouvez contrôler davantage son emplacement dans Google en mappant les champs included_destination, excluded_destination et pause. Par exemple, utilisez excluded_destination pour empêcher un produit d’apparaître dans les annonces Shopping tout en le soumettant à des fiches gratuites. Voir le tableau Champs facultatifs.
Dérivation du prix catalogue
Le champ prix correspond au prix normal (catalogue) d’un produit. B2C Commerce n’a pas de concept intégré de « prix catalogue » ; Les équipes de boutique en ligne mettent en œuvre la tarification catalogue à l’aide de différentes stratégies de listes de prix. Pour s’adapter à cette variété, B2C Commerce calcule le prix catalogue du flux en deux étapes :
- Liste de prix sélectionnée. Si vous sélectionnez une liste de prix dans Liste de prix dans l’onglet Paramètres généraux, B2C Commerce utilise le prix de cette liste de prix. La liste déroulante contient uniquement les listes de prix actives et les prix dans la devise du flux. Si vous désactivez ultérieurement la liste de prix sélectionnée, reconfigurez la liste de prix catalogue pour qu’elle pointe vers une autre liste de prix.
-
Parcours de la liste de prix de vente. Si vous ne sélectionnez pas de liste de prix, B2C Commerce dérive le prix catalogue de la liste de prix soldés sélectionnée par le moteur de prix B2C Commerce pour le produit. Le moteur de prix évalue toutes les listes de prix applicables au produit, et pas seulement les listes actives, et renvoie le meilleur prix (le plus bas) avec sa liste de prix source. À partir de cette liste de prix de vente, B2C Commerce applique l’une des deux règles suivantes :
- Si la liste de prix soldes a une liste de prix parente, B2C Commerce guide la chaîne parente jusqu’à la racine et renvoie le prix de la liste de prix racine. Cela correspond au comportement par défaut des boutiques SFRA et SiteGenesis.
- Si la liste de prix soldes n’a pas de parente, B2C Commerce renvoie le prix maximum dans toutes les listes de prix applicables au produit. Cela correspond au comportement par défaut des boutiques PWA Kit.
La configuration d’une liste de prix catalogue dans l’onglet Paramètres généraux est le moyen le plus fiable de s’assurer que le prix catalogue de votre flux correspond à ce que les acheteurs voient sur votre boutique en ligne, en particulier pour les boutiques avec une logique de prix personnalisée, une tarification par zone ou des listes de prix multidevises.
Dérivation du prix de vente
Le champ sale_price correspond à l’attribut salePrice de B2C Commerce et à la devise configurée. La valeur salePrice n’est pas extraite d’une seule liste de prix : le moteur de prix B2C Commerce sélectionne le meilleur prix (le plus bas) parmi toutes les listes de prix applicables au produit, quelle que soit la hiérarchie de la liste de prix ou si une hiérarchie est configurée ou non.
Étant donné que le même moteur renseigne le prix affiché dans votre boutique en ligne, la valeur sale_price envoyée à Google correspond à ce que les acheteurs voient sur votre site.
Si le prix de vente résolu est égal au prix catalogue résolu (champ de prix ), B2C Commerce omet sale_price de l’entrée de flux de ce produit. Cela évite d’afficher un prix barré dans Google pour les produits qui ne sont pas en solde. Voir Dérivation du prix catalogue.
Si votre boutique en ligne utilise une logique de tarification personnalisée, telle que la sélection de listes de prix par zone ou par zone géographique, le calcul du prix de vente par défaut peut ne pas correspondre à ce que voient les acheteurs. Dans ce cas, la configuration d’une liste de prix catalogue dans l’onglet Paramètres généraux est le moyen le plus fiable d’aligner le flux sur votre boutique en ligne.
Champs obligatoires
Les champs suivants sont obligatoires pour une entrée de flux de produits valide. Les produits pour lesquels il manque des champs obligatoires sont toujours inclus dans le flux, mais Google peut rejeter ces lignes individuelles. Utilisez l’aperçu du flux de produits pour identifier les produits pour lesquels il manque des champs obligatoires et les corriger avant d’activer la synchronisation quotidienne des flux. Voir Aperçu du flux de produits.
| Champ Google | Type | Mappage SFCC par défaut | Description | Remplaçable |
|---|---|---|---|---|
| id | string | id (Identifiant du produit) | Identifiant unique du produit (SKU). Géré par B2C Commerce. Restez stable entre les mises à jour de flux. | Non |
| Titre | string | name, revient à masterProductName s’il est vide | Titre du produit. Évitez les textes promotionnels. | Oui |
| description | string | longDescription, revient à shortDescription (code HTML supprimé) s’il est vide | Description complète du produit. Les balises HTML sont automatiquement supprimées. | Oui |
| lien | string | productUrl (généré) | URL de la page des détails du produit. Généré à l’aide du nom d’hôte de la configuration Einstein. Pour les boutiques PWA Kit et les boutiques headless, configurez les formats d’URL séparément. Voir Configurer les formats d’URL pour le flux de produits. | Oui |
| image_link | string | Type d’affichage d’image sélectionné ou recherche de type d’affichage par défaut | URL de l’image principale du produit. Si vous sélectionnez un type d’affichage dans Type d’affichage d’image dans l’onglet Paramètres généraux, B2C Commerce utilise ce type d’affichage. Dans le cas contraire, B2C Commerce tente d’utiliser le type d’affichage « large » et revient au premier type d’affichage disponible. Étant donné que le fichier de secours peut sélectionner un type d’affichage inapproprié (par exemple, une vue d’échantillon), Salesforce recommande de sélectionner un type d’affichage spécifique. Utilisez des images haute résolution sans superpositions promotionnelles. | Oui |
| Disponibilité | string | Disponibilité (dérivée) | État des stocks. Valeurs dérivées de la mise en correspondance des niveaux de stock B2C Commerce avec les valeurs de disponibilité de Google : in_stock, out_of_stock, précommande, en souffrance. Géré par le système. |
Non |
| price | numéro | Combine le prix et la devise (liste de prix sélectionnée ou chemin solde-liste de prix) | Prix normal (liste) du produit avec code de devise, tel que « 15.00 USD ». Si vous sélectionnez une liste de prix dans Liste de prix dans l’onglet Paramètres généraux, B2C Commerce utilise cette liste de prix. Dans le cas contraire, B2C Commerce dérive le prix catalogue de la liste de prix de vente sélectionnée par le moteur de prix B2C Commerce. Voir Dérivation du prix catalogue. Seules les valeurs positives sont incluses. | Oui |
Champs facultatifs
Les champs suivants sont facultatifs et peuvent améliorer vos fiches produits dans Google. Les champs facultatifs sont omis du flux lorsque l’attribut mappé ou la valeur constante est vide. Les champs avec un mappage par défaut dérivent automatiquement leur valeur ; Les champs sans mappage par défaut (affichés par « (aucun) ») ne sont renseignés que lorsque vous mappez un attribut ou définissez une valeur constante ou un modèle.
| Champ Google | Type | Mappage SFCC par défaut | Description | Remplaçable |
|---|---|---|---|---|
| sale_price | numéro | Combine salePrice et la devise si un prix de vente est actif | Prix réduit avec code de devise, tel que « 10.00 USD ». B2C Commerce omet ce champ lorsque le prix de vente résolu est égal au prix résolu. Voir Calcul du prix de vente. | Oui |
| sale_price_effective_date | date | Combine salePriceStart et salePriceEnd | Plage de dates de prix de vente au format ISO 8601, par exemple « 2016-02-24T11:07+0100/2016-02-29T23:07+0100 ». | Oui |
| availability_date | date | enStockDate | Date à laquelle un produit en précommande devient disponible, par exemple « 2016-02-24T11:07+0100 ». | Oui |
| expiration_date | date | onlineTo | Date à laquelle le produit doit cesser d’apparaître dans les flux, par exemple « 2016-07-11T11:07+0100 ». | Oui |
| Marque | string | Marque | Marque. | Oui |
| GTIN | string | ean, revient à upc si EAN n’est pas disponible | Code GTIN (Global Trade Item Number) (UPC/EAN). Améliore l’appariement des produits. | Oui |
| No. d’article du fabricant | string | No. d’article du fabricant | Référence du fabricant. | Oui |
| identifier_exists | booléen | Calculé à partir du fait que le produit possède ou non des identifiants standard (EAN, UPC, MPN ou marque) | Indique si le produit possède des identificateurs standard. | Oui |
| is_bundle | booléen | Est évalué sur true lorsque bundleProductIds est renseigné |
Indique s’il s’agit d’une offre groupée. Géré par B2C Commerce. | Non |
| item_group_id | string | masterProductId (en anglais seulement) | Regroupe les variantes de produit qui partagent le même produit maître, par exemple « AB12345 ». | Oui |
| product_type | string | categoryPath (chemin d’accès complet) | Catégorie de produits définie par le marchand, telle que « Accueil > Femmes > Robes Maxi > Robes ». | Oui |
| google_product_category | string | (aucune) | Catégorie de produits définie par Google, telle que « Vêtements & , Accessoires > , Vêtements > , Vêtements > d’extérieur, Manteaux, & Vestes ». | Oui |
| additional_image_link | string | additionalImageLink | URL d’image supplémentaires pour une présentation plus riche. | Oui |
| lifestyle_image_link | string | (aucune) | URL de l’image Lifestyle. | Oui |
| mobile_link | string | (aucune) | URL de la page de destination optimisée pour les mobiles. | Oui |
| virtual_model_link | string | (aucune) | URL de la ressource Modèle virtuel (3D). | Oui |
| ads_redirect | string | (aucune) | URL utilisée pour rediriger le trafic des annonces, par exemple une URL qui inclut des paramètres de suivi. | Oui |
| couleur | string | (aucune) | Couleur du produit. | Oui |
| Matériel | string | (aucune) | Matières premières du produit, telles que le « cuir ». | Oui |
| pattern | string | (aucune) | Motif du produit, tel que « pois ». | Oui |
| taille | string | (aucune) | Taille du produit, telle que « XL ». | Oui |
| size_system | string | (aucune) | Système de taille, tel que « US ». | Oui |
| size_type | string | (aucune) | Type de taille, par exemple « normal ». | Oui |
| Sexe | string | (aucune) | Public visé, par exemple « masculin », « féminin » ou « unisexe ». | Oui |
| age_group | string | (aucune) | Groupe d’âge cible. Valeurs : nouveau-né, nourrisson, tout-petit, enfant, adulte. |
Oui |
| Adulte | booléen | (aucune) | Indique si le produit est destiné aux adultes. | Oui |
| État | string | (aucune) | L’état du produit, tel que « neuf », « d’occasion » ou « remis à neuf ». | Oui |
| Emballage multiple | numéro | (aucune) | Nombre de produits identiques dans un multipack défini par le marchand. | Oui |
| product_highlight | string | (aucune) | Un point fort clé du produit, tel que « Prend en charge des milliers d’applications ». | Oui |
| short_title | string | (aucune) | Titre abrégé utilisé dans les emplacements contraints, comme « Polo ». | Oui |
| structured_title | string | (aucune) | Titre structuré, y compris l’origine du titre, pour le contenu généré par l’IA. | Oui |
| structured_description | string | (aucune) | Description structurée, y compris l’origine de la description, pour le contenu généré par l’IA. | Oui |
| custom_label_0à custom_label_4 | string | (aucune) | Libellés personnalisés utilisés pour segmenter les produits à des fins de rapports et d’enchères, tels que « Saisonnier », « Liquidation » ou « Meilleures ventes ». | Oui |
| product_length, product_width product_height | numéro | (aucune) | Dimensions du produit avec l’unité, par exemple « 20 po ». | Oui |
| product_weight | numéro | (aucune) | Poids du produit avec l’unité, telle que « 3,5 lb ». | Oui |
| unit_pricing_measure | string | Combine unitQuantity et unitMeasure | Mesure et dimension du produit tel qu’il est vendu, par exemple « 1,5 kg ». | Oui |
| unit_pricing_base_measure | string | (aucune) | Mesure de base du produit pour le prix, par exemple « 100g ». | Oui |
| energy_efficiency_class | string | (aucune) | Classe d’efficacité énergétique, telle que « A+ ». | Oui |
| min_energy_efficiency_class | string | (aucune) | Classe d’efficacité énergétique la plus basse sur l’étiquette du produit, telle que « A+++ ». | Oui |
| max_energy_efficiency_class | string | (aucune) | Classe d’efficacité énergétique la plus élevée sur l’étiquette du produit, telle que « D ». | Oui |
| Certification de l' | string | (aucune) | Certification du produit, telle que « EC :EPREL :123456 ». | Oui |
| consumer_notice | string | (aucune) | Un avis aux consommateurs, tel qu’un avertissement de la Proposition 65. | Oui |
| cost_of_goods_sold | numéro | (aucune) | Coût des marchandises vendues avec le code de devise, tel que « 8,00 USD ». | Oui |
| auto_pricing_min_price | numéro | (aucune) | Prix minimum pour les remises automatisées, par exemple « 15,00 USD ». | Oui |
| maximum_retail_price | numéro | (aucune) | Prix de détail maximum (utilisé dans certaines régions, comme l’Inde), par exemple « 15,00 INR ». | Oui |
| Versement échelonné | string | (aucune) | Détails du paiement échelonné, par exemple « 6:30 EUR :199 EUR ». | Oui |
| subscription_cost | string | (aucune) | Détails du coût de l’abonnement, tels que « mois :12:35.00USD ». | Oui |
| loyalty_program | string | (aucune) | Avantages du programme de fidélité, tels que « my_loyalty_program :silver :10 USD ::10 ::free_member_shipping ». | Oui |
| promotion_id | string | (aucune) | Identifiant de promotion, tel que « ABC123 ». | Oui |
| Expédition | string | (aucune) | Détails des frais d’expédition, tels que « US :CA :Overnight :16.00 USD ». | Oui |
| free_shipping_threshold | string | (aucune) | Valeur minimale de commande pour la livraison gratuite, telle que « US :16.00 USD ». | Oui |
| carrier_shipping | string | (aucune) | Frais de port calculés par le transporteur, par exemple « US :80302 :USPS_MEDIA_MAIL :1:3:2:5 ». | Oui |
| shipping_label | string | (aucune) | Étiquette utilisée pour attribuer des règles d’expédition, telles que « périssable ». | Oui |
| shipping_length, shipping_width, shipping_height | numéro | (aucune) | Dimensions de l’emballage utilisées pour calculer les frais d’expédition, par exemple « 22 po ». | Oui |
| shipping_weight | numéro | (aucune) | Poids du colis utilisé pour calculer les frais d’expédition, par exemple « 3 kg ». | Oui |
| min_handling_time | numéro | (aucune) | Temps de traitement minimal du produit, tel que « 1 ». | Oui |
| max_handling_time | numéro | (aucune) | Temps maximal de traitement du produit, tel que « 3 ». | Oui |
| shipping_handling_business_days | string | (aucune) | Jours ouvrables où les commandes sont traitées, par exemple « US : du lundi au samedi ». | Oui |
| shipping_transit_business_days | string | (aucune) | Jours ouvrables lorsque les commandes sont en transit, par exemple « US : du lundi au samedi ». | Oui |
| ships_from_country | string | (aucune) | Pays d’origine duquel le produit est expédié. Utilise un code de pays ISO 3166 à 2 lettres, tel que « US ». | Oui |
| return_policy_label | string | (aucune) | Étiquette utilisée pour attribuer une politique de retour, telle que « 90 jours ». | Oui |
| included_destination | string | (aucune) | Destinations où le produit doit être inclus, telles que « Shopping_ads ». | Oui |
| excluded_destination | string | (aucune) | Destinations où le produit doit être exclu, telles que « Shopping_ads ». | Oui |
| shopping_ads_excluded_country | string | (aucune) | Pays exclus des annonces Shopping, par exemple « DE ». | Oui |
| mettre en pause | string | (aucune) | Suspend l’élément dans une destination, telle que « annonces ». | Oui |
| native_commerce | booléen | (aucune) | Indique si le produit est éligible au commerce natif, c’est-à-dire aux expériences d’achat qui se déroulent directement sur les surfaces de Google plutôt que sur votre boutique en ligne. Définissez ce booléen par produit pour contrôler l’éligibilité. Ce champ n’a pas de mappage par défaut, de sorte que les produits ne sont pas marqués comme éligibles à moins que vous ne les mappiez. | Oui |
| external_seller_id | string | (aucune) | Identifiant du vendeur pour les comptes multivendeurs, par exemple « SellerPublicName1991 ». | Oui |
| merchant_item_id | string | (aucune) | Identifiant de l’élément de checkout fourni par le marchand, tel que « some_checkout_item_id_1 ». | Oui |
Champs facultatifs supplémentaires (détail du produit)
Utilisez la section Champs facultatifs supplémentaires du tableau Mappage de champs pour envoyer des spécifications techniques ou d’autres attributs au champ product_detail de Google. Pour chaque entrée, mappez un attribut B2C Commerce et, éventuellement, indiquez un nom de section pour regrouper les détails associés. Cliquez sur Ajouter un attribut pour ajouter un autre détail au produit.
Le champ product_detail fournit aux acheteurs des informations lisibles et structurées sur des aspects d’un produit que d’autres champs ne couvrent pas, et il aide Google à faire apparaître vos produits dans les résultats de recherche et les expériences basées sur l’IA. Pour obtenir la liste complète des attributs acceptés et des exigences de mise en forme, consultez la section Détails du produit [product_detail] dans l’aide Google Merchant Center.
