Redirects

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

For eksempel, hvis du har et særskilt produkt for én kategori, og du ønsker at 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 delt op i to sektioner. Den første viser dig hvordan du opretter en Redirect for din butik, og den anden del er de yderligere trin, du skal følge, hvis du har en custom API store.

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 #

1. Gå til Search > Redirects > New redirect.

2. Indsæt URL’en på det produkt eller den side, du vil have, at besøgende skal blive sendt til, når de trykker på enter efter en søgning.

3. Tilføj en eller flere forespørgsler, der skal udløse redirecten. Queries that match exactly vil lave en redirect, hvis en bruger skriver netop dette ord eller denne sætning, mens Queries that contain vil lave en redirect, hvis ordet eller sætningen indgår som en del af den fulde søgning.

4. Klik på Save & Close for at gemme det.

API Setup #

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

Redirect-URL’en vil blive 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 dit redirect ikke virker, er der en god chance for, at et andet script overskriver funktionaliteten.

Herunder er et eksempel på, hvordan du kan overskrive eksisterende funktionalitet for at sikre, at dine Clerk redirects bliver prioriteret. Det kan kræve tilpasning til din opsætning.

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