Redirects

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

Ad esempio, hai un prodotto autonomo per una categoria e vuoi rendere possibile ai tuoi clienti cercare direttamente la pagina del prodotto dalla ricerca, 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 illustra i passaggi aggiuntivi che dovrai seguire se hai uno store API personalizzato.

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

Creazione dei Redirects #

1. Vai su Search > Redirects > New redirect.

2. Inserisci l’URL del prodotto o di un’altra pagina a cui vuoi che i visitatori vengano indirizzati, premendo 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. Clicca 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 create.

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, è molto probabile che un altro script stia sovrascrivendo la funzionalità.

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