Redirects

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

Ad esempio, hai un prodotto standalone per una categoria e vuoi permettere ai tuoi clienti di cercare direttamente la pagina 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 negozio e la seconda parte riguarda i passaggi aggiuntivi da seguire se hai uno store API custom.

I Redirects funzionano anche con Omnisearch. Utilizza le stesse regole di corrispondenza e invia i visitatori all’URL configurato, quindi non è necessaria una configurazione separata di Omnisearch.

Creazione dei Redirects #

Configura prima la query, quindi scegli dove dovrebbero portare le ricerche corrispondenti.

1. Vai su Search > Redirects > New redirect.
2. In Query, seleziona Matches exactly o Contains. Matches exactly reindirizza solo la parola o frase esatta. Contains reindirizza quando il termine è parte di una ricerca più lunga.
3. Inserisci i termini della query nel campo singolo. Aggiungi o rimuovi termini secondo necessità. La modalità selezionata si applica a questi termini.
4. Inserisci l’URL di destinazione sotto Query.
5. Clicca su Save.

Configurazione API #

Se hai integrato Clerk con l’API direttamente, il link di reindirizzamento verrà restituito dagli endpoint search/predictive e search/search per tutte le query che corrispondono 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"
}

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

Di seguito un esempio di come puoi sovrascrivere la funzionalità esistente per forzare la priorità dei tuoi redirect di Clerk. Potrebbe richiedere personalizzazione per 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>