Redirects

Las redirecciones te permiten 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 deseas que tus clientes puedan buscar directamente la página del producto desde la búsqueda, sin pasar por la página de búsqueda.

Esta guía se dividirá en dos secciones. La primera es mostrarte cómo crear una redirección para tu tienda y la segunda parte los pasos adicionales que tendrás que seguir si tienes una tienda API personalizada.

Creando Redirecciones #

1. Ve a Buscar > Redirecciones > Nueva redirección.

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

3. Agrega una o más consultas que deberían causar la redirección. Consultas que coinciden exactamente redirigirá si un usuario escribe esa palabra o frase exacta, mientras que Consultas que contienen redirigirá si la palabra o frase es parte de la búsqueda completa.

4. Haz clic en Guardar y cerrar para aplicarlo.

Configuración de API #

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

La URL de redirección se incluirá en la clave redirect de la respuesta.

Ejemplo:

# Llamada a la 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": ["Búsqueda Instantánea"]}' \
     http://api.clerk.io/v2/search/predictive

# Respuesta
{
  "status": "ok",
  "query": "softball",
  "count": 2,
  "result": [
    37217,
    40058
    ],
  "hits": 2,
  "redirect": "https://www.thebaseballgeek.co.uk/softball"
}

Solución de Problemas #

Muchos scripts añaden funcionalidad a tu campo de búsqueda, así que si tu redirección no funciona, hay una buena posibilidad de que otro script esté sobrescribiendo la funcionalidad.

A continuación se muestra un ejemplo de cómo puedes sobrescribir la funcionalidad existente para forzar que tus redirecciones de Clerk sean priorizadas. Puede requerir personalización para 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>