Redirects

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

Ad esempio, hai un prodotto autonomo per una categoria e vuoi rendere possibile ai tuoi clienti di cercare direttamente la pagina del prodotto dalla search, senza passare dalla search page.

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

I Redirects funzionano anche con Omnisearch. Usa le stesse regole di corrispondenza e invia i visitatori alla URL configurata, quindi non è necessaria una configurazione separata di Omnisearch.

Creazione dei Redirects #

1. Vai su Search > Redirects > New redirect.

2. Inserisci la URL del prodotto o della pagina a cui vuoi che i visitatori vengano inviati, quando premono enter dopo la ricerca.

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

4. Fai clic su Save & Close per applicare.

Configurazione API #

Se hai integrato Clerk direttamente tramite API, il link di redirect verrà restituito dagli endpoint search/predictive e search/search per tutte le query che corrispondono alle regole di Redirect che hai creato.

La URL di Redirect sarà inclusa 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"
}

Risoluzione dei problemi #

Molti script aggiungono funzionalità al tuo campo di ricerca, quindi se il tuo redirect non funziona, è probabile 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 redirect di Clerk. Potrebbe essere necessaria una personalizzazione secondo la tua configurazione.

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