Redirects

Redirects te permite crear una conexión directa entre una consulta o palabra clave y una url específica. ¿Cuándo puedes usarlo?

Por ejemplo, tienes un producto independiente para una categoría, y quieres que tus clientes puedan buscar directamente la página del producto desde la search, sin pasar por la search page.

Esta guía se divide en dos secciones. La primera muestra cómo crear un Redirect para tu tienda y la segunda parte los pasos adicionales que deberás seguir si tienes una API store personalizada.

Creating Redirects #

1. Ve a Search > Redirects > New redirect.

2. Inserta la URL del producto u otra página a la que quieres que los visitantes sean enviados, cuando presionen enter después de buscar.

3. Añade una o más consultas que deben causar el redirect. Queries that match exactly redirigirá si un usuario escribe esa palabra o frase exacta, mientras que Queries that contain redirigirá si la palabra o frase es parte de la búsqueda completa.

4. Haz clic en Save & Close para aplicarlo.

API Setup #

Si has integrado Clerk directamente con la API, el enlace de redirect será devuelto por los endpoints search/predictive y search/search para cualquier consulta que coincida con las reglas de Redirect que creaste.

La URL del Redirect estará incluida en la clave redirect de la respuesta.

Ejemplo:

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

Muchos scripts añaden funcionalidad a tu campo de búsqueda, así que si tu redirect no funciona, es muy probable que otro script esté sobrescribiendo la funcionalidad.

A continuación tienes un ejemplo de cómo puedes sobrescribir la funcionalidad existente para forzar que tus redirects de Clerk tengan prioridad. Es posible que requiera personalización según tu configuración.

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