Redirects

Redirects giver dig mulighed for at oprette en direkte forbindelse mellem en forespørgsel eller et nøgleord og en specifik url. Hvornår kan du bruge det?

For eksempel har du et enkeltstående produkt til en kategori, og du vil gerne gøre det muligt for dine kunder at søge direkte efter produktsiden fra søgningen, uden at gå via søgesiden.

Denne guide vil være opdelt i to afsnit. Det første viser dig hvordan du opretter en Redirect for din butik, og den anden del gennemgår de yderligere trin, du skal følge, hvis du har en specialtilpasset API-butik.

Redirects fungerer også med Omnisearch. Den bruger de samme matchregler og sender besøgende til den konfigurerede URL, så der er ikke behov for en separat Omnisearch-opsætning.

Oprettelse af Redirects #

Konfigurer først forespørgslen, og vælg derefter hvor de matchende søgninger skal føre hen.

1. Gå til Search > Redirects > New redirect.
2. I Query, vælg Matches exactly eller Contains. Matches exactly omdirigerer kun det præcise ord eller sætning. Contains omdirigerer, når udtrykket er en del af en længere søgning.
3. Indtast forespørgselsudtrykkene i det enkelte inputfelt. Tilføj eller fjern udtryk efter behov. Den valgte tilstand gælder for disse udtryk.
4. Indtast destinations-URL’en under Query.
5. Klik på Save.

API Opsætning #

Hvis du har integreret Clerk direkte med API’en, bliver redirect-linket returneret af endpoints search/predictive og search/search for alle forespørgsler, der matcher de Redirect-regler, du har oprettet.

Redirect-URL’en vil være inkluderet i redirect-nøglen i svaret.

Eksempel:

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

Fejlfinding #

Mange scripts tilføjer funktionalitet til dit søgefelt, så hvis din redirect ikke virker, er der en god chance for, at et andet script overskriver funktionaliteten.

Nedenfor er et eksempel på, hvordan du kan overskrive eksisterende funktionalitet for at tvinge dine Clerk redirects til at blive prioriteret. Det kan kræve tilpasning til dit setup.

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