Cet article est issu d'une série de guides sur la configuration d'une API pour votre marketplace dans Channable. Chaque étape de la configuration est primordiale pour garantir que vos données produits sont correctement alignées sur les exigences de la marketplace. Des instructions détaillées pour chaque étape peuvent être trouvées dans les articles suivants :
Pour plus d'informations sur Marketplaces V2, veuillez consulter cet article.
Les attributs sont des champs dans Channable et sur les marketplaces qui contiennent des informations spécifiques sur vos produits. S'assurer que les attributs dans Channable sont correctement remplis est crucial pour faire correspondre les données de vos produits avec les valeurs requises par la marketplace.
Alors que nous commençons le déploiement de Marketplaces V2 (cliquez ici pour en savoir plus), certaines de nos APIs Marketplace offrent déjà la possibilité de passer à la nouvelle version.
Nous avons combiné les deux étapes Construire et Attributs en une, ce qui permet d'avoir une interface plus intuitive. Dans cet article, nous expliquerons comment les deux versions des étapes fonctionnent et présenterons les différences.
Table des matières
Les différences
Dans Marketplaces V1, les étapes Construire et Attributs étaient séparées, ce qui entraînait un paramétrage plus fragmenté. Voici comment la nouvelle version de Marketplaces V2 fluidifie ce processus :
Étape Construire de Marketplace V1
- Objectif : L'ancienne étape Construire permettait de renseigner des attributs communs à tous les produits, tels que l'EAN, les prix et les titres. Ces attributs étaient applicables à toutes les catégories de produits.
- Exemple : Si vous répertoriez divers produits tels que des appareils électroniques et des vêtements, vous deviez saisir ici des attributs communs tels que le prix et le titre.
Étape Attributs de Marketplace V1
- Objectif : Cette étape est axée sur les attributs spécifiques à une catégorie qui varient selon le type de produit, comme la taille pour les vêtements ou les dimensions pour les meubles.
- Exemple : Pour les vêtements, vous deviez saisir des attributs spécifiques tels que la taille et la couleur, tandis que pour les meubles, vous deviez saisir les dimensions et le matériau.
Étape Construire de Marketplace V2
- Intégration : Combine les anciennes étapes Contruire et Attributs en une seule interface, ce qui simplifie le processus.
- Centralisation : Tous les attributs, qu'ils soient partagés ou spécifiques à une catégorie, sont gérés au même endroit, ce qui réduit la nécessité de passer d'une étape à l'autre.
- Indicateurs : Les indicateurs possèdent le code couleur suivant : les champs obligatoires sont en rose et les champs optionnels en jaune, ce qui permet d'identifier facilement les champs qui doivent être remplis.
-
Onglets : Divisés en "Attributs partagés" et "Attributs par catégorie" pour une meilleure organisation.
- Attributs partagés : S'appliquent à tous les produits, tels que l'EAN et le titre.
- Attributs par catégorie : Ils ne concernent que certaines catégories, comme la pointure pour les chaussures ou les dimensions pour les meubles.
Ci-dessous, vous pouvez sélectionner Marketplaces V2 ou V1 pour accéder à des instructions détaillées. Ces lignes directrices vous aideront à naviguer efficacement dans le processus.
Étape Construire de Marketplace V2
Au cours de l'étape Construire de Marketplace V2, vous configurez tous les attributs nécessaires pour vos produits, en veillant à ce que les données soient conformes aux exigences de la marketplace. Cette étape est cruciale pour des annonces produits correctes et pour éviter les erreurs.
Table des matières
Vue d'ensemble de l'étape Construire
L'étape Construire comporte une interface centralisée qui vous permet de gérer et de lier efficacement tous les attributs. Les indicateurs précisent les champs obligatoires en rose et les champs optionnels en jaune. Vous pouvez également utiliser le bouton "Masquer les champs optionnels" pour filtrer les champs non obligatoires et vous concentrer sur les données essentielles.
Cette page comporte deux onglets : attributs partagés et attributs par catégorie. Voici les différences entre ces deux types d'attributs :
Attributs partagés
Les attributs partagés s'appliquent à tous les produits, tels que l'EAN, les prix et les titres. Cet onglet offre une vue d'ensemble de ces attributs, ce qui vous permet de remplir les informations nécessaires pour tous les produits en une seule fois. Il s'agit par exemple d'informations générales telles que le pays d'origine.
Sections spécifiques par marketplace
En fonction de la marketplace, des sections supplémentaires se trouvent dans l'onglet "Attributs partagés" de l'étape Construire. Pour des conseils détaillés spécifiques à la marketplace, veuillez consulter l'article de la marketplace sur laquelle vous souhaitez diffuser vos produits.
Attributs par catégorie
Les attributs par catégorie ne sont pertinents que pour les produits appartenant à une catégorie spécifique. Par exemple, les attributs de taille pour les vêtements et les dimensions pour les meubles. Cet onglet organise ces attributs par catégorie, ce qui vous permet de les gérer et de les mettre en correspondance facilement. Il s'agit par exemple d'attributs tels que la taille ou la couleur des chaussures pour les catégories de chaussures. La présentation des catégories affiche la liste des catégories avec le nombre de produits dans chacune d'elles.
En utilisant efficacement l'étape Construire, vous pouvez vous assurer que toutes les données de vos produits sont correctement envoyées, répondant ainsi aux exigences de la marketplace et optimisant la qualité de vos anonnces produits.
Lier des attributs dans Channable
Comme expliqué dans la section "Vue d'ensemble de l'étape Construire", les attributs dans Channable sont divisés en deux types : les attributs partagés et les attributs par catégorie.
Différence entre les attributs partagés et les attributs par catégorie
Comme expliqué précédemment, compléter les attributs fonctionne presque de la même manière, avec les différences suivantes :
- Attributs partagés : Dans l'onglet des attributs partagés, ces valeurs restent constantes pour tous les produits (par exemple le pays d'origine).
- Attributs par catégorie : Ils se trouvent dans l'onglet des attributs par catégorie. Dans cet onglet, vous devez cliquer sur une catégorie spécifique pour obtenir une vue d'ensemble des attributs propres à la catégorie (par exemple la largeur de l'article).
Ajouter des valeurs statiques aux attributs
-
- Accédez à l'onglet des attributs par catégorie : Naviguez jusqu'à l'onglet des attributs que vous souhaitez remplir à l'étape Construire.
- Sélectionnez le champ : Cliquez sur l'en-tête du champ pour saisir une valeur statique.
- Saisissez la valeur : Saisissez la valeur statique requise (par exemple le pays d'origine).
- Sauvegardez les modifications : Utilisez le bouton "Sauvegarder" ou le bouton "Sauvegarder et prévisualiser" pour enregistrer vos modifications. Tous les produits auront désormais cette valeur statique.
Compléter les attributs avec des valeurs dynamiques
- Accédez à l'onglet des attributs par catégorie : Naviguez jusqu'à l'onglet des attributs que vous souhaitez remplir à l'étape Construire.
- Sélectionnez le champ : Cliquez sur le "+" (plus) pour ajouter un champ dynamique. Ce champ apparaît en bleu, ce qui indique qu'il est dynamique.
- Sauvegardez les modifications : Utilisez le bouton "Sauvegarder" ou le bouton "Sauvegarder et prévisualiser" pour enregistrer vos modifications.
Conseils supplémentaires
- Informations supplémentaires : Lorsque vous souhaitez remplir un attribut, cliquez sur le (i) situé à côté du champ pour obtenir de plus amples informations sur le type de valeur(s) requise(s) par la marketplace.
- Gestion des informations manquantes : Si les informations requises ne sont pas disponibles dans vos fiches produits, vous pouvez appliquer des règles au champ ou créer de nouveaux champs depuis la partie Installation et les remplir à l'aide de règles.
Une fois que vous avez rempli tous les attributs obligatoires, passez à l'étape Qualité de l'API. Cet onglet donne un aperçu de la quantité de données correctement remplies ou non. Dans cet article, nous détaillons tout ce qu'il faut connaitre sur cet étape.
FAQ
-
Que se passe-t-il si les champs obligatoires ne sont pas remplis ?
Les champs obligatoires (en rose) manquants entraîneront des erreurs lors de l'export, ce qui empêchera vos produits d'être diffusés.
-
Puis-je modifier des valeurs dynamiques après les avoir enregistrées ?
Oui, vous pouvez modifier les valeurs dynamiques. La valeur sera automatiquement modifiée lorsque vous l'aurez changée.
-
Comment gérer les erreurs courantes lors de l'étape Construire ?
Les erreurs courantes sont signalées par des champs marqués en rose. Vérifiez les exigences de la marketplace et assurez-vous que tous les champs obligatoires sont remplis correctement. Utilisez le bouton "Sauvegarder et prévisualiser" pour identifier et résoudre rapidement les problèmes.
Étape Attributs de Marketplace V1
À l'étape Attributs de votre API Marketplace V1, vous verrez apparaître le constructeur d'Attributs. Cette fonctionnalité est conçue pour offrir une vue d'ensemble détaillée des attributs disponibles par catégorie.
Il s'agit d'un outil important pour faire correspondre vos données produits avec les attributs requis par la marketplace à laquelle vous les envoyez.
Le fait de ne pas relier correctement ces données peut entraîner des erreurs dans vos annonces.
- Vue d'ensemble
- Gérer les catégories et renseigner les attributs
- Valeurs statiques
- Valeurs dynamiques
- Attributs complétés ?
Vue d'ensemble
À l'étape Attributs, vous trouverez une vue d'ensemble des catégories.
Cette vue d'ensemble présente une liste de toutes les catégories que vous avez définies à l'étape Catégories. Chaque catégorie est affichée individuellement, car elle possède son propre ensemble d'attributs.
Sur la droite, vous pouvez voir combien de produits se trouvent dans chaque catégorie. Les catégories de cette liste sont triées en fonction du nombre de produits qui leur sont attribués.
Gérer les catégories et renseigner les attributs
Si vous cliquez sur une catégorie, vous obtiendrez une vue d'ensemble de tous les produits et de leurs attributs dans cette catégorie spécifique.
Chaque attribut correspond à une colonne. Si un champ de la colonne est marqué en rouge, cela signifie que les données de l'attribut pour ce produit sont manquantes ou incorrectes (d'après la marketplace).
En cliquant sur l'en-tête de l'attribut que vous souhaitez remplir, une fenêtre s'ouvre.
Une fois sur cette fenêtre, quelques sections s'affichent.
- Valeur de l'attribut : C'est ici que vous indiquez la valeur statique ou dynamique.
- Description : La marketplace explique le type de valeur qu'elle souhaite associer à cet attribut.
- Exemple : Un court exemple de ce que pourrait être une valeur possible.
- Valeurs possibles : Si la marketplace n'autorise qu'un type de valeur spécifique, nous l'affichons ici.
Il est essentiel de mentionner que la valeur que vous ajoutez doit correspondre à 100 % à ce que les valeurs possibles affichent. Par exemple :
Comme vous pouvez le constater, "Pays Bas" n'était pas une valeur correcte pour cet attribut, mais "Pays-Bas" l'était.
Il est important de noter qu'une fois que vous liez une valeur (statique ou dynamique), cette valeur est complétée pour tous les produits de toutes les catégories.
Pour l'attribut "Pays d'origine", une valeur statique conviendrait parfaitement, car il est très probable que tous les produits proviennent du même pays d'origine.
En revanche, pour l'attribut "Taille de la chaussure", il est très probable que vous ayez des tailles différentes en fonction du produit, c'est pourquoi un champ dynamique est la meilleure solution !
Maintenant que nous avons expliqué comment remplir au mieux vos attributs, nous pouvons aborder la différence entre une valeur statique et une valeur dynamique.
Valeurs statiques
En cliquant sur l'en-tête de l'attribut et en remplissant la valeur (selon les valeurs possibles), puis en cliquant sur Sauvegarder, tous les produits auront désormais la valeur statique que vous venez de remplir.
Comme nous l'avons vu plus haut, ce n'est pas toujours la meilleure solution, car vous pouvez avoir besoin de valeurs différentes pour chaque produit. De plus, la valeur attendu par la marketplace dans un même champ peut varier d'une catégorie à l'autre.
Valeurs dynamiques
La valeur dynamique est celle que vous devrez probablement utiliser le plus souvent. Par "valeur dynamique", nous entendons un champ (dynamique) de vos produits.
Pour lier un champ dynamique : cliquez sur le caractère "+" (plus) et ajoutez le champ dynamique à votre attribut. Ce champ apparaîtra en bleu, indiquant qu'il est dynamique.
Si vous n'avez pas les bonnes informations dans le bon champ, vous pouvez appliquer des règles sur ce champ. Vous pouvez également choisir de créer un nouveau champ dans votre import et de remplir ces informations à l'aide de règles. Vous trouverez plus d'informations sur la création d'un champ dans cet article.
Attributs complétés ?
Une fois que vous avez rempli tous les attributs obligatoires pour vos produits, vous pouvez accéder à l'étape Résultats de votre API. À cette étape, vous pouvez voir une vue d'ensemble des produits qui sont sur le point d'être envoyés à la marketplace par le biais de votre API.
Si tout semble correct, allez à l'étape Paramètres de votre API, activez l'API et exécutez-la.