Passer au contenu principal
Si vous utilisez VTEX comme plateforme e-commerce, vous pouvez intégrer Topsort directement dans votre boutique VTEX pour offrir des emplacements publicitaires à vos vendeurs. Cette intégration est composée des applications suivantes :
  • Intégration Catalogue
  • Intégration Enchères (Sponsored Listings)
  • Intégration Événements
Ces applications fonctionnent ensemble pour synchroniser votre catalogue avec Topsort, afficher des produits sponsorisés dans les résultats de recherche et suivre les interactions utilisateur pour les rapports et l’optimisation.

​
Prérequis

  • Un compte VTEX avec accès administrateur.
  • Le VTEX IO Toolbelt installé et configuré.
  • Un compte Topsort avec une clé API Marketplace et une clé API Advanced.
Connectez-vous à votre compte VTEX : 
vtex login {VOTRE_NOM_DE_COMPTE}

​
Configuration de votre clé API

Installez l’application Topsort Services Settings : 
vtex install topsortpartnercl.services
Ensuite, configurez la clé API :
  1. Allez dans l’administration de votre espace de travail VTEX.
  2. Allez dans App > Gestion des applications et trouvez l’application services.
  3. Cliquez sur paramètres et ajoutez la clé API, puis cliquez sur Enregistrer.
Vérifiez l’installation en allant sur {{workspace__url}}/_v/ts/settings.

​
Importation du catalogue dans Topsort

Vous pouvez intégrer votre catalogue VTEX avec Topsort en utilisant des modèles de flux XML. Étapes de configuration :
  1. Naviguez vers Paramètres de la boutique > Canaux > Intégration XML dans votre admin VTEX
  2. Créez un nouveau modèle XML avec les champs de produits requis :
    • ID de produit, titre/nom, Marque, URL de l’image, Prix (tous requis)
    • Description, Chemin de catégorie, Code de référence SKU, EAN/code-barres (optionnel)
  3. Configurez la structure XML : 
<?xml version="1.0" encoding="UTF-8"?>
<feed>
  <entry>
    <id>product-id</id>
    <title>Nom du produit</title>
    <description>Description du produit</description>
    <productType>Catégorie &gt; Sous-catégorie</productType>
    <brand>Nom de la marque</brand>
    <link>https://store.com/product-url</link>
    <imageLink>https://store.com/image.jpg</imageLink>
    <price>99.99</price>
  </entry>
</feed>
  1. Générez et testez l’URL du flux : https://{votre-nom-d-espace-de-travail}.vtexcommercestable.com.br/XMLData/{nom-du-xml}.xml
  2. Contactez votre représentant Topsort pour configurer l’intégration du flux XML.
  1. Supprimez l’application native vtex search resolver :
vtex uninstall vtex.search-resolver
  1. Installez l’application Auction Integration :
vtex install topsortpartnercl.auctions@3.x
  1. Accédez au portail d’administration VTEX, naviguez vers Apps > Mes applications, et trouvez Topsort’s Auctions Integration.
  2. Configurez le nombre d’emplacements sponsorisés et cliquez sur Enregistrer.

​
Suivi des événements

L’application Events Integration suit les impressions, les clics et les achats. 
vtex install topsortpartnercl.events@1.1.2
Accédez au portail d’administration VTEX, naviguez vers Apps > Mes applications, et trouvez Topsort’s Events Integration.

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.