Redirects

Redirects ermöglicht es dir, eine direkte Verbindung zwischen einer Suchanfrage oder einem Keyword und einer bestimmten URL herzustellen. Wann kannst du es nutzen?

Beispielsweise besitzt du ein Einzelprodukt für eine Kategorie und möchtest deinen Kunden ermöglichen, direkt von der Suche aus auf die Produktseite zuzugreifen, ohne die Suchergebnisseite aufzurufen.

Diese Anleitung ist in zwei Abschnitte unterteilt. Der erste Teil zeigt dir, wie du einen Redirect für deinen Shop erstellst, und der zweite Teil beschreibt die zusätzlichen Schritte, die du durchführen musst, wenn du einen Custom API Store verwendest.

Redirects funktionieren ebenfalls mit Omnisearch. Es werden dieselben Matching-Regeln verwendet und Besucher werden zur konfigurierten URL weitergeleitet, daher ist keine separate Omnisearch-Konfiguration nötig.

Creating Redirects #

1. Gehe zu Search > Redirects > New redirect.

2. Füge die URL des Produkts oder einer anderen Seite ein, auf die die Besucher weitergeleitet werden sollen, wenn sie nach dem Suchen enter drücken.

3. Füge eine oder mehrere Suchanfragen hinzu, die den Redirect auslösen sollen. Queries that match exactly leitet weiter, wenn ein Nutzer genau dieses Wort oder diesen Ausdruck eingibt, während Queries that contain dann weiterleitet, wenn das Wort oder der Ausdruck Teil der gesamten Suche ist.

4. Klicke auf Save & Close, um die Einstellungen zu übernehmen.

API Setup #

Wenn du Clerk direkt mit der API integriert hast, wird der Redirect-Link von den Endpunkten search/predictive und search/search für alle Suchanfragen zurückgegeben, die den erstellten Redirect-Regeln entsprechen.

Die Redirect-URL ist im Response im Schlüssel redirect enthalten.

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

Troubleshooting #

Viele Skripte erweitern das Suchfeld um neue Funktionalitäten. Wenn dein Redirect nicht funktioniert, besteht eine hohe Wahrscheinlichkeit, dass ein anderes Skript die Funktionalität überschreibt.

Nachfolgend findest du ein Beispiel, wie du bestehende Funktionen überschreiben kannst, um sicherzustellen, dass deine Clerk-Redirects Priorität haben. Es kann sein, dass Anpassungen für dein Setup erforderlich sind.

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