Redirects

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

For eksempel, hvis du har et enkeltstående produkt til én kategori, og du vil gøre det muligt for dine kunder at søg direkte efter produktsiden fra search, uden at skulle gå forbi search page.

Denne guide vil være delt op i to sektioner. Den første viser dig hvordan du opretter en Redirect til din butik, og anden del viser yderligere trin, du skal følge, hvis du har en custom API store.

Redirects fungerer også med Omnisearch. Den bruger de samme matching-regler og sender besøgende til den konfigurerede URL, så en separat Omnisearch-opsætning er ikke nødvendig.

Oprettelse af Redirects #

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

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

3. Tilføj en eller flere forespørgsler, som skal udløse redirect. Queries that match exactly vil redirecte, hvis en bruger indtaster det nøjagtige ord eller sætning, mens Queries that contain vil redirecte, hvis ordet eller sætningen er en del af hele søgningen.

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

API Opsætning #

Hvis du har integreret Clerk direkte med API’et, vil redirect-linket blive returneret af endpoints search/predictive og search/search for enhver forespørgsel, 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 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 få prioritet. 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>