Suchcenter

Ein Suchcenter in Ihre Website einbinden

Eine Suchcenter-ID läuft über ein Runtime-Skript in eine Suchoberfläche auf einer Webseite
Eine Suchcenter-ID läuft über ein Runtime-Skript in eine Suchoberfläche auf einer Webseite

Verwenden Sie den generierten Embed code, wenn das Suchcenter auf einer Seite erscheinen soll, die Sie selbst verwalten. Die Einbettung benötigt die Seekdown-Runtime, einen Container und die srch-…-ID des Suchcenters.

Die öffentliche Einbettung hinzufügen

Die dokumentierte Struktur lautet:

<script src="https://saas.seekdown.ai/js/seekdown-assistant.js"></script>

<div id="seekdown-assistant-root"></div>

<script>
  document.addEventListener('DOMContentLoaded', function () {
    if (window.skdwn && window.skdwn.startAssistant) {
      skdwn.startAssistant({
        assistantId: 'srch-your-search-center-id',
        accessToken: ''
      });
    }
  });
</script>

Ersetzen Sie die Beispiel-ID durch den Wert aus dem generierten Snippet Ihres Suchcenters. Ein leeres Zugriffstoken ist nur für ein öffentliches Suchcenter mit der Authentifizierung None geeignet.

Bewusst platzieren

Fügen Sie den Container dort ein, wo das Sucherlebnis erscheinen soll. Geben Sie der Seite genug Breite für die Ergebniskarten und testen Sie die Höhe sowohl nach einer kurzen als auch nach einer langen Antwort.

Fügen Sie dieselbe Container-ID nicht zweimal auf einer Seite ein. Die Runtime zielt auf #seekdown-assistant-root.

Ein Suchcenter-Ergebnis mit Antwort und Quellenkarten-Layout auf einer breiten Seite
Ein Suchcenter-Ergebnis mit Antwort und Quellenkarten-Layout auf einer breiten Seite

Die Implementierung prüfen

Eingabe oder AktionErwartetes ErgebnisSo prüfen Sie es
Seite ladenDie Suchoberfläche erscheint im ContainerDie Browserkonsole auf Skriptfehler prüfen
Einen Vorschlag wählenDie Anfrage wird ausgeführtGewählten Text und Ergebnis bestätigen
Eine bekannte Frage stellenKorrekte Antwort und Dokumente erscheinenMit der erwarteten Quelle vergleichen
Eine Quellenkarte öffnenDie Originalseite öffnet sichZiel und belegenden Text prüfen
Fenstergröße ändernDie Oberfläche bleibt nutzbarSchmale und breite Viewports testen

Eine leere Einbettung analysieren

Prüfen Sie in dieser Reihenfolge die Runtime-URL, die Container-ID, die Suchcenter-ID und den Initialisierungsaufruf. Bei einem privaten Suchcenter prüfen Sie außerdem das Zugriffstoken und Allowed origins.

Verwenden Sie das kopierte Snippet, statt IDs aus einer öffentlichen URL zu rekonstruieren. Ist anonymer Zugriff nicht angemessen, richten Sie ein privates Suchcenter ein, bevor Sie die Einbettung veröffentlichen.