Redirects

Leitet um ermöglicht es Ihnen, eine direkte Verbindung zwischen einem Abfrage oder einem Schlüsselwort und einem bestimmten url zu erstellen. Wann können Sie es verwenden?

Sie haben zum Beispiel ein eigenständiges Produkt für eine Kategorie und möchten Ihren Kunden die Möglichkeit geben, direkte Suche nach der Produktseite aus der Suche heraus, ohne über die Suchseite zu finden.

Dieser Leitfaden wird in zwei Abschnitte unterteilt sein. Der erste soll Ihnen wie man einen Redirect erstellt für Ihr Geschäft zeigen und der zweite Teil die zusätzliche Schritte, die Sie befolgen müssen, wenn Sie eine benutzerdefinierter API-Speicher haben.

Umleitungen erstellen #

1. Gehen Sie zu Search > Redirects > New redirect.

2. Einfügen der URL des Produkts oder anderer Seite, zu dem die Besucher weitergeleitet werden sollen, wenn sie nach der Suche auf enter drücken.

3. Fügen Sie eine oder mehrere Suchanfragen hinzu, die die Weiterleitung bewirken sollen. Queries that match exactly leitet weiter, wenn ein Benutzer genau dieses Wort oder diesen Satz eingibt, während Queries that contain weiterleitet, wenn das Wort oder der Satz Teil der vollständigen Suche ist.

4. Klicken Sie auf Save & Close, um sie anzuwenden.

API-Einrichtung #

Wenn Sie Clerk direkt in die API integriert haben, wird der Redirect-Link von den Endpunkten search/predictive und search/search für alle Abfragen zurückgegeben, die den von Ihnen erstellten Redirect-Regeln entsprechen.

Die Umleitungs-URL wird in den Schlüssel redirect der Antwort aufgenommen.

Beispiel:

# API Call
curl -X POST \
     -H 'Content-Type: application/json' \
     -d '{"key": "store_api_key",
          "query": "softball",
          "language": "english",
          "limit": 6,
          "visitor": "unique_visitor_id",
          "labels": ["Instant Search"]}' \
     http://api.clerk.io/v2/search/predictive

# Response
{
  "status": "ok",
  "query": "softball",
  "count": 2,
  "result": [
    37217,
    40058
    ],
  "hits": 2,
  "redirect": "https://www.thebaseballgeek.co.uk/softball"
}

Fehlersuche #

Viele Skripte fügen Ihrem Suchfeld Funktionen hinzu. Wenn Ihre Weiterleitung also nicht funktioniert, ist die Wahrscheinlichkeit groß, dass ein anderes Skript die Funktionen überschreibt.

Nachfolgend finden Sie ein Beispiel dafür, wie Sie bestehende Funktionen überschreiben können, um zu erzwingen, dass Ihre Clerk Weiterleitungen vorrangig behandelt werden. Möglicherweise ist eine Anpassung an Ihre Einrichtung erforderlich.

<script>
(function() {
input_selector = document.querySelector('#{{ content.id }}').dataset.instantSearch;
document.querySelectorAll(input_selector).forEach(input=>{
  input.addEventListener('keyup', function(event){
      {% if redirect %}
      var currentRedirect = '{{ redirect }}';
      {% else %}
      var currentRedirect = undefined;
      {% endif %}
      if(event.which == 13 || event.which == 'Enter'){
          if(currentRedirect != undefined){
              event.preventDefault();
              window.location.replace(currentRedirect);
          }
      }
  });
});
})();
</script>