Passer au contenu principal
Un flux de produits vous permet de partager votre catalogue avec Topsort, de synchroniser les données et de maintenir les campagnes à jour. Pendant le processus d’intégration, vous pouvez nous fournir l’URL de votre flux de produits et nous veillerons à ce que votre catalogue reste à jour. Notre plateforme prend en charge plusieurs formats :
  • Spécification des données de produits Google.
  • Valeurs séparées par des tabulations (TSV).
  • Valeurs séparées par des virgules (CSV).
Topsort récupère les données d'un flux de produits
Si votre catalogue de produits se trouve déjà sur une plateforme tierce comme Algolia ou VTEX, nous pouvons nous intégrer directement avec eux pour les mises à jour et la synchronisation, en veillant à ce que les informations sur les produits soient exactes. Pour des instructions détaillées sur la configuration de ces connexions et les exigences spécifiques pour chaque plateforme, veuillez vous référer à la section “Intégrations tierces - Partenaires” de notre documentation.

​
Spécification des données de produits Google

Partagez votre catalogue avec Topsort en utilisant des flux de produits Google existants. Nous prenons en charge la Spécification des données de produits Google.

​
TSV et CSV

Nous prenons en charge le partage de votre catalogue en utilisant des flux TSV et CSV. Les instructions de cette section s’appliquent aux deux formats.
Quel format devez-vous utiliser ?Nous vous recommandons d’utiliser TSV plutôt que CSV. CSV est plus sujet aux erreurs en raison des virgules souvent présentes dans les données du catalogue.Si le nom de votre produit ou le nom de votre catégorie contient des virgules, vous devez utiliser TSV.

​
Colonnes prises en charge

NomRequisPar défautDescription
idoui-Identifiant unique pour chaque produit.
activenontrueSi le produit peut faire partie de campagnes ou d’enchères. Les produits inactifs seront retirés des campagnes existantes.
titleoui-Nom du produit
category.0.nameoui-Nom de catégorie de la catégorie principale pour ce produit.
category.0.idnonSlug du nom de catégorieID de la catégorie principale pour ce produit.
vendor.0.nameoui si n’utilise pas seller_name-Vendeur du produit. C’est l’entité qui a son propre budget pour faire la publicité de ce produit et qui concurrence d’autres vendeurs.
vendor.0.idoui si n’utilise pas seller_nameSlug du nom du vendeurID du vendeur de ce produit.
seller_nameoui si n’utilise pas vendor.0.nameNom du vendeur du produit, même valeur que vendor.0.name.
google_product_categoryouiCatégories fournies au format de taxonomie Google.
pricenon-Prix du produit.
image_linknon-URL vers une image du produit.
availabilitynon-Statut de stock. Doit être in stock, out of stock ou preorder.
descriptionnon-Description détaillée du produit.
Les catégories peuvent être fournies de plusieurs façons. Mais une seule est requise. Vous pouvez associer un produit à plusieurs catégories et vendeurs. Voir la section ci-dessous.

​
Exemples de fichiers

​
Exemple TSV utilisant vendor.0.name

id	name	description	vendor.0.id	vendor.0.name	vendor.0.image_link	category.0.id	category.0.name	category.1.id	category.1.name	image_link	price	availability
1293	Masque vert	Masque vert pour éliminer les imperfections, utiliser de nuit ou de jour	1710000087	Derma Laboratories		10000087	Soins de la peau	61	Beauté & Santé	https://i.postimg.cc/0QxMWmbd/shampoo.png	23935.29	out of stock
1302	Gel nettoyant	N/A	17829100	Shiny Laboratories		10000087	Soins de la peau			https://i.postimg.cc/0QxMWmbd/shampoo.png	16050.42	in stock

​
Exemple CSV utilisant vendor.0.name

id,name,description,vendor.0.id,vendor.0.name,vendor.0.image_link,category.0.id,category.0.name,category.1.id,category.1.name,image_link,price,availability
1293,Masque vert,"Masque vert pour éliminer les imperfections, utiliser de nuit ou de jour",1710000087,Derma Laboratories,,10000087,Soins de la peau,61,Beauté & Santé,https://i.postimg.cc/0QxMWmbd/shampoo.png,23935.29,out of stock
1302,Gel nettoyant,N/A,17829100,Shiny Laboratories,,10000087,Soins de la peau,,,https://i.postimg.cc/0QxMWmbd/shampoo.png,16050.42,in stock

​
Plusieurs catégories et vendeurs

Les produits peuvent être associés à plusieurs catégories et/ou vendeurs. Comme vous l’avez peut-être remarqué, les colonnes de catégorie et de vendeur contiennent des indices. Vous pouvez ajouter des colonnes supplémentaires de catégorie et/ou de vendeur tant que vous augmentez l’indice de manière appropriée. Par exemple, un produit avec trois catégories et deux vendeurs aurait au moins ces colonnes : 
category.0.id
category.1.id
category.2.id
vendor.0.id
vendor.1.id

​
Format de taxonomie Google

Alternativement, vous pouvez utiliser le format de taxonomie de Google comme noms de catégories. Cela vous permet de décrire des relations hiérarchiques plus complexes. Par exemple, cette hiérarchie : 
Apparel & Accessories > Clothing > Dresses
Résultera en trois catégories : 
[
  {
    "id": "apparal-and-accessories",
    "name": "Apparel & Accessories"
  },
  {
    "id": "clothing",
    "name": "Clothing",
    "parentId": "apparal-accessories"
  },
  {
    "id": "dresses",
    "name": "Dresses",
    "parentId": "clothing"
  }
]

​
Hébergement de votre flux de produits

Votre flux de produits doit être continuellement accessible à Topsort afin que nous puissions maintenir nos données à jour. Nous pouvons actuellement accéder aux flux de produits publics ou aux flux protégés par l’autorisation HTTP de base. De plus, utilisez les en-têtes de réponse ETag pour nous aider à déterminer si un flux de produits a été mis à jour depuis la dernière récupération.

​
Suppression de produits

Les produits peuvent être “supprimés en douceur” en définissant la propriété active sur false. Cela peut être fait à la fois via l’API et via le flux de produits. Les produits inactifs ne seront pas inclus dans les nouvelles campagnes ou enchères et seront retirés de toutes les campagnes actives dont ils font partie. Pour supprimer définitivement des produits du système de Topsort, utilisez l’API.

​
Slugs générés

Lorsque les catégories ou les vendeurs n’ont pas d’ID, nous en générons un à la volée.
Préférez utiliser des ID explicitesIl est recommandé de fournir les ID explicitement dans votre flux de produits, ces ID sont utilisés comme références lors de la gestion des campagnes et des enchères.Si vous utilisez des ID générés, vous devrez utiliser le même algorithme côté marketplace pour créer ces références.
Ces ID utilisent un slug dérivé du nom. Un slug est une chaîne formatée en kebab case qui convient à l’inclusion dans les URL. Par exemple, Hello world devient hello-world. Le format est basé sur la bibliothèque npm slugify.

Besoin d'aide avec votre intégration Topsort ?

Parlez-nous, l'équipe d'ingénierie des intégrations.Contactez-nous via votre canal de messagerie dédié ou à support@topsort.com.Si vous n'êtes pas encore client, planifiez une démo avec notre équipe de vente.