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 le endpoint Afiliados. Veuillez contacter votre représentant Topsort pour obtenir de l’aide avec la configuration.
  1. Supprimez l’application native VTEX Search Resolver. Topsort utilise un fork du dernier Search Resolver de VTEX—même comportement de base, mais augmenté avec la logique d’enchères de Topsort. Si elle n’est pas désinstallée, les applications entreront en conflit :
vtex uninstall vtex.search-resolver
  1. Installez l’application Auction Integration :
vtex install topsortpartnercl.auctions
  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
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.