Passer au contenu principal
Ce guide montre comment intégrer les résultats d’enchères Topsort avec votre index Algolia existant, permettant aux produits organiques et promus d’être listés dans le même flux. Algolia est un moteur de recherche puissant qui fournit des résultats rapides et pertinents pour naviguer dans les catalogues. En intégrant Algolia avec Topsort, nous pouvons synchroniser votre catalogue directement dans Topsort, sans avoir besoin d’intégrations de catalogue supplémentaires. L’intégration vous permettra également de prioriser les produits promus dans les résultats organiques retournés par Algolia. Consultez l’intégration Proxy de Topsort pour plus de détails.

​
Comment ça fonctionne

1

Prérequis

Pour intégrer Topsort avec Algolia, assurez-vous de respecter ces prérequis :
  • Votre catalogue de produits est stocké dans un index Algolia.
  • Vous interrogez Algolia en utilisant le SDK Algolia.
2

Créer une clé API

Créez une clé API Algolia avec les permissions suivantes : search, browse, listIndexes (des permissions supplémentaires comme addObject et deleteObject peuvent être nécessaires selon la façon dont vous gérez les mises à jour de votre index).
  • La permission browse permet le téléchargement de votre catalogue entier.
  • La permission listIndexes permet à Topsort de vérifier la date de dernière modification de l’index pour éviter les mises à jour inutiles
3

Partager les détails de l'index

Contactez le support Topsort et partagez le nom de votre index Algolia. Cela permet à Topsort de configurer et de commencer à importer votre catalogue.
4

Configurer le Proxy Topsort

Mettez à jour la configuration de votre SDK Algolia pour pointer vers le Proxy de Topsort. Cela permettra à Topsort de prioriser les produits promus dans les résultats organiques retournés par Algolia.
import algoliasearch from 'algoliasearch/lite';

const client = algoliasearch('YourApplicationID', 'YourWriteAPIKey', {
  hosts: [{ url: 'myslug-sandbox.topsort.workers.dev' }],
});
const index = client.initIndex('votre_nom_d_index');

​
Résultats d’enchères et suivi d’événements

Les produits promus priorisés dans la réponse du Proxy de Topsort auront un paramètre resolvedBidId qui identifie de manière unique l’enchère de ce produit. Vous pouvez l’utiliser pour marquer visuellement le produit comme “Promu” pour l’utilisateur final. Le resolvedBidId est également nécessaire pour identifier le gagnant de l’enchère lors du signalement des événements (impressions, clics, achats). Consultez notre documentation sur le suivi des événements pour plus de détails.