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 nach der Produktseite zu suchen, ohne die Suchseite zu durchlaufen.

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 behandelt die zusätzlichen Schritte, die Sie befolgen müssen, wenn Sie einen Custom API Store haben.

Redirects funktionieren auch mit Omnisearch. Es werden die gleichen Matching-Regeln verwendet und die Besucher zur konfigurierten URL weitergeleitet, sodass keine separate Omnisearch-Konfiguration nötig ist.

Redirects erstellen #

Konfigurieren Sie zuerst die Abfrage und wählen Sie anschließend das Ziel für übereinstimmende Suchen.

1. Gehen Sie zu Search > Redirects > New redirect.
2. Wählen Sie in Query entweder Matches exactly oder Contains aus. “Matches exactly” leitet nur bei dem exakten Wort oder der exakten Phrase weiter. “Contains” leitet weiter, wenn der Begriff Teil einer längeren Suche ist.
3. Geben Sie die Abfragebegriffe im einzelnen Eingabefeld ein. Fügen Sie Begriffe hinzu oder entfernen Sie sie nach Bedarf. Der ausgewählte Modus gilt für diese Begriffe.
4. Geben Sie die Ziel-URL unter “Query” ein.
5. Klicken Sie auf Save.

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

Fehlerbehebung #

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

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