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 dies verwenden?

Zum Beispiel haben Sie ein Einzelprodukt für eine Kategorie und möchten es Ihren Kunden ermöglichen, direkt von der Suche auf die Produktseite zu gelangen, ohne die Search-Seite zu passieren.

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

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 weitergeleitet werden sollen, wenn sie nach der Suche enter drücken.

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 vollständigen Suche ist.

4. Klicken Sie auf Save & Close, um dies zu übernehmen.

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 Abfragen 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 Funktionen hinzu. Falls Ihr Redirect nicht funktioniert, besteht eine hohe Wahrscheinlichkeit, dass ein anderes Skript die Funktionalität überschreibt.

Im Folgenden finden Sie ein Beispiel dafür, wie Sie die bestehende Funktionalität überschreiben können, um Ihre Clerk Redirects zu priorisieren. Es könnte eine Anpassung an Ihre Umgebung 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>