Redirects

Redirects ermöglicht es Ihnen, eine direkte Verbindung zwischen einer Abfrage oder einem Schlüsselwort und einer bestimmten URL herzustellen. Wann können Sie es verwenden?

Zum Beispiel haben Sie ein eigenständiges Produkt für eine Kategorie, und Sie möchten es Ihren Kunden ermöglichen, direkt nach der Produktseite aus der Suche zu suchen, ohne die Suchseite zu durchlaufen.

Dieser Leitfaden wird in zwei Abschnitte unterteilt. Der erste zeigt Ihnen, wie Sie einen Redirect für Ihren Shop erstellen, und der zweite Teil die zusätzlichen Schritte, die Sie befolgen müssen, wenn Sie einen benutzerdefinierten API-Shop haben.

Erstellen von Redirects #

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

2. Fügen Sie die URL des Produkts oder einer anderen Seite ein, zu der Besucher gesendet werden sollen, wenn sie enter nach der Suche drücken.

3. Fügen Sie eine oder mehrere Abfragen hinzu, die den Redirect auslösen sollten. Queries that match exactly leitet um, wenn ein Benutzer dieses genaue Wort oder diesen genauen Ausdruck eingibt, während Queries that contain umleitet, wenn das Wort oder der Ausdruck Teil der vollständigen Suche ist.

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

API-Setup #

Wenn Sie Clerk direkt mit der 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 Redirect-URL wird im redirect-Schlüssel der Antwort enthalten sein.

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 Ihrer Suchleiste Funktionen hinzu, sodass, wenn Ihr Redirect nicht funktioniert, die Wahrscheinlichkeit groß ist, dass ein anderes Skript die Funktionalität überschreibt.

Im Folgenden finden Sie ein Beispiel, wie Sie vorhandene Funktionen überschreiben können, um sicherzustellen, dass Ihre Clerk-Redirects priorisiert werden. Es kann Anpassungen für Ihr Setup erfordern.

<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>