Zum Hauptinhalt springen
Diese Anleitung zeigt, wie Sie Topsort-Auktionsergebnisse mit Ihrem bestehenden Algolia-Index integrieren, sodass organische und beworbene Produkte im selben Ablauf aufgelistet werden können. Algolia ist eine leistungsstarke Suchmaschine, die schnelle und relevante Ergebnisse für die Navigation in Katalogen liefert. Durch die Integration von Algolia mit Topsort können wir Ihren Katalog direkt mit Topsort synchronisieren, ohne zusätzliche Katalogintegrationen zu benötigen. Die Integration ermöglicht es Ihnen auch, beworbene Produkte in den von Algolia zurückgegebenen organischen Ergebnissen zu priorisieren. Weitere Details finden Sie in der Proxy-Integration von Topsort.

​
Funktionsweise

1

Voraussetzungen

Um Topsort mit Algolia zu integrieren, stellen Sie sicher, dass Sie diese Voraussetzungen erfüllen:
  • Ihr Produktkatalog ist in einem Algolia-Index gespeichert.
  • Sie fragen Algolia mit dem Algolia SDK ab.
2

API Key erstellen

Erstellen Sie einen Algolia API Key mit den folgenden Berechtigungen: search, browse, listIndexes (zusätzliche Berechtigungen wie addObject und deleteObject können je nach Verwaltung Ihrer Index-Updates erforderlich sein).
  • Die browse-Berechtigung ermöglicht das Herunterladen Ihres gesamten Katalogs.
  • Die listIndexes-Berechtigung ermöglicht es Topsort, das letzte Änderungsdatum des Index zu überprüfen, um unnötige Updates zu vermeiden.
3

Index-Details teilen

Kontaktieren Sie den Topsort-Support und teilen Sie Ihren Algolia-Indexnamen mit. Dies ermöglicht es Topsort, Ihren Katalog zu konfigurieren und mit dem Import zu beginnen.
4

Topsort Proxy konfigurieren

Aktualisieren Sie Ihre Algolia SDK-Konfiguration, um auf den Proxy von Topsort zu verweisen. Dies ermöglicht es Topsort, beworbene Produkte in den von Algolia zurückgegebenen organischen Ergebnissen zu priorisieren.
import algoliasearch from 'algoliasearch/lite';

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

​
Auktionsergebnisse und Ereignisverfolgung

Die beworbenen Produkte, die in der Antwort des Topsort-Proxy priorisiert werden, haben einen resolvedBidId-Parameter, der die Auktion dieses Produkts eindeutig identifiziert. Sie können ihn verwenden, um das Produkt für den Endbenutzer visuell als “Beworben” zu kennzeichnen. Die resolvedBidId wird auch benötigt, um den Auktionsgewinner beim Melden von Ereignissen (Impressionen, Klicks, Käufe) zu identifizieren. Weitere Details finden Sie in unserer Dokumentation zur Ereignisverfolgung.