Redirects

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

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

Diese Anleitung ist in zwei Abschnitte unterteilt. Der erste Abschnitt zeigt Ihnen, wie Sie einen Redirect für Ihren Shop erstellen, und im zweiten Teil finden Sie die zusätzlichen Schritte, die Sie befolgen müssen, wenn Sie einen benutzerdefinierten API-Store haben.

Redirects funktionieren auch mit Omnisearch. Es verwendet die gleichen Übereinstimmungsregeln und leitet Besucher zur konfigurierten URL weiter, sodass keine separate Omnisearch-Einrichtung erforderlich ist.

Redirects erstellen #

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

2. Fügen Sie die URL des Produkts oder einer anderen Seite ein, zu der Besucher beim Drücken von enter nach der Suche weitergeleitet werden sollen.

3. Fügen Sie eine oder mehrere Abfragen hinzu, die den Redirect auslösen sollen. Queries that match exactly leitet weiter, wenn ein Benutzer genau dieses Wort oder diese Phrase eingibt, während Queries that contain weiterleitet, wenn das Wort oder die Phrase Teil der gesamten Suchanfrage ist.

4. Klicken Sie auf Save & Close, um die Aktion anzuwenden.

API-Einrichtung #

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

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

Fehlerbehebung #

Viele Skripte fügen Ihrem Suchfeld zusätzliche Funktionen hinzu. Wenn Ihr Redirect also nicht funktioniert, besteht eine gute Chance, dass ein anderes Skript die Funktionalität überschreibt.

Nachfolgend finden Sie ein Beispiel dafür, wie Sie bestehende Funktionen überschreiben können, um Ihre Clerk-Redirects zu priorisieren. Es kann Anpassungen für Ihre Konfiguration 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>