Redirects

Redirects ti consente di creare una connessione diretta tra una query o parola chiave e una specifica url. Quando puoi usarlo?

Ad esempio, hai un prodotto singolo per una categoria e vuoi permettere ai tuoi clienti di cercare direttamente la pagina del prodotto tramite Search, senza passare per la search page.

Questa guida sarà divisa in due sezioni. La prima ti mostrerà come creare un Redirect per il tuo store e la seconda parte i passaggi aggiuntivi che dovrai seguire se hai un custom API store.

Creating Redirects #

1. Vai su Search > Redirects > New redirect.

2. Inserisci l’URL del prodotto o della pagina a cui vuoi che i visitatori vengano inviati quando premono enter dopo aver effettuato una ricerca.

3. Aggiungi una o più query che devono attivare il redirect. Queries that match exactly effettuerà il redirect se un utente digita esattamente quella parola o frase, mentre Queries that contain effettuerà il redirect se la parola o la frase fa parte della ricerca completa.

4. Fai clic su Save & Close per applicare.

API Setup #

Se hai integrato Clerk direttamente con l’API, il link di redirect verrà restituito dagli endpoint search/predictive e search/search per qualsiasi query che corrisponde alle regole di Redirect che hai creato.

L’URL di Redirect sarà incluso nella chiave redirect della risposta.

Esempio:

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

Troubleshooting #

Molti script aggiungono funzionalità al tuo campo di ricerca, quindi se il tuo redirect non funziona, c’è una buona probabilità che un altro script stia sovrascrivendo la funzionalità.

Qui sotto trovi un esempio di come puoi sovrascrivere la funzionalità esistente per forzare la priorità dei tuoi Redirect di Clerk. Potrebbe essere necessaria una personalizzazione per il tuo 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>