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 búsqueda, sin pasar por la página de búsqueda.

Esta guía estará dividida en dos secciones. La primera es para mostrarte cómo crear un Redirect para tu tienda y la segunda parte son los pasos adicionales que deberás seguir si tienes una tienda con API personalizada.

Redirects también funciona con Omnisearch. Utiliza las mismas reglas de coincidencia y envía a los visitantes a la URL configurada, por lo que no es necesario configurar Omnisearch por separado.

Creando Redirects #

Configura primero la consulta, luego elige a dónde deberían dirigirse las búsquedas coincidentes.

1. Ve a Search > Redirects > New redirect.
2. En Query, selecciona Matches exactly o Contains. Matches exactly redirige solo la palabra o frase exacta. Contains redirige cuando el término es parte de una búsqueda más larga.
3. Ingresa los términos de consulta en el campo único. Agrega o elimina términos según sea necesario. El modo seleccionado se aplicará a estos términos.
4. Ingresa la URL de destino debajo de Query.
5. Haz clic en Save.

Configuración de API #

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

La URL de Redirect se incluirá 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"
}

Resolución de problemas #

Muchos scripts agregan funcionalidad a tu campo de búsqueda, por lo que si tu redirect no funciona, existe una gran posibilidad de que otro script esté sobrescribiendo la funcionalidad.

A continuación tienes un ejemplo de cómo puedes sobrescribir la funcionalidad existente para forzar que se prioricen tus redirects de Clerk. 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>