Redirects

I reindirizzamenti ti permettono di creare una connessione diretta tra una query o parola chiave e un url specifico. 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 ricerca, senza passare per la pagina di ricerca.

Questa guida sarà divisa in due sezioni. La prima è per mostrarti come creare un reindirizzamento per il tuo negozio e la seconda parte i passaggi aggiuntivi che dovrai seguire se hai un negozio API personalizzato.

Creazione di Reindirizzamenti #

1. Vai a Search > Redirects > New redirect.

2. Inserisci l’URL del prodotto o di un’altra pagina a cui vuoi che i visitatori vengano inviati, quando premendo enter dopo la ricerca.

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

4. Clicca Save & Close per applicarlo.

Impostazione API #

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

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

Esempio:

# Chiamata API
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

# Risposta
{
  "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 reindirizzamento non funziona, c’è una buona possibilità che un altro script stia sovrascrivendo la funzionalità.

Di seguito è riportato un esempio di come puoi sovrascrivere la funzionalità esistente per forzare i tuoi reindirizzamenti Clerk a essere prioritizzati. 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>