Redirects

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

For eksempel, hvis du har et selvstændigt produkt til én kategori, og du vil gøre det muligt for dine kunder at søge direkte efter produktsiden fra Search, uden at skulle forbi search-siden.

Denne guide vil blive delt op i to sektioner. Den første viser dig hvordan du opretter en Redirect til din butik, og anden del de supplerende trin, du skal følge, hvis du har en custom API-butik.

Oprettelse af Redirects #

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

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

3. Tilføj en eller flere forespørgsler, der skal udløse redirecten. Queries that match exactly vil omdirigere, hvis en bruger skriver netop dét ord eller udtryk, mens Queries that contain vil omdirigere, hvis ordet eller udtrykket indgår som en del af den samlede søgning.

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

API-opsætning #

Hvis du har integreret Clerk med API’et direkte, 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 være inkluderet i redirect-nøglen i svaret.

Eksempel:

# API-kald
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

# Svar
{
  "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 fungerer, er der stor sandsynlighed 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 din løsning.

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