Cuadro de búsqueda de enlaces de sitio

Los cuadros de búsqueda de enlaces de sitio ofrecen a los usuarios una forma rápida de buscar en tu sitio web o aplicación directamente desde la página de resultados de búsqueda. En ellos, se implementan sugerencias en tiempo real y otras funciones.

La Búsqueda de Google puede mostrar automáticamente un cuadro para hacer búsquedas directas en tu sitio web cuando aparece como resultado de búsqueda sin que tengas que hacer nada. Ese cuadro de búsqueda usa tecnología de la Búsqueda de Google. Aun así, puedes añadir datos estructurados de WebSite para proporcionar información de forma explícita a Google y ayudarlo así a entender mejor tu sitio web.

Cómo implementar el cuadro de búsqueda de enlaces de sitios

A continuación se indican los pasos que debes seguir para que tu sitio web pueda aparecer con un cuadro de búsqueda en los resultados de la Búsqueda de Google:

  1. Instala un buscador que funcione en tu sitio web o aplicación Android.

    Las consultas de búsqueda de enlaces de sitio envían a los usuarios a la página de resultados de búsqueda de tu sitio web o aplicación, por lo que necesitas un buscador que funcione para usar esta función.

    • Sitios web: configura un buscador en tu sitio web. Con esta función, las consultas de los usuarios se reenvían a tu destino con la sintaxis especificada en tus datos estructurados. El buscador que uses debe admitir consultas codificadas en UTF-8.
    • Aplicaciones: consulta el artículo Descripción general de la Búsqueda del sitio web para desarrolladores de Android para obtener información sobre cómo implementar un buscador en tu aplicación. Tu aplicación Android debe admitir un objeto intent ACTION_VIEW de los resultados de búsqueda, con el URI de datos correspondiente especificado en la propiedad potentialAction.target de las etiquetas.
  2. Implementa el elemento de datos estructurados WebSite en la página de inicio de tu sitio. Para habilitar esta función, una aplicación debe tener un sitio web asociado, aunque el sitio web sea solo una página. Algunas directrices adicionales:
    • Añade estas etiquetas solo a la página principal y a ninguna otra página.
    • Especifica siempre un objeto SearchAction en el sitio web y, opcionalmente, otro si admite la búsqueda en aplicaciones. Siempre debes tener un objeto SearchAction en el sitio web, incluso si la aplicación es el destino preferido para las búsquedas. De este modo, aseguramos que si el usuario no está haciendo la búsqueda desde un teléfono Android o no tiene instalada tu aplicación Android, el resultado de la búsqueda se dirige a tu sitio web.
  3. Comprueba que tus datos estructurados sean correctos con la prueba de resultados enriquecidos
  4. Verifica que el buscador esté bien implementado. Para hacerlo, copia la URL WebSite.potentialAction.target de tus datos estructurados, cambia {search_term_string} por una consulta de prueba y navega a esa URL en un navegador web. Por ejemplo, si tu sitio web es example.com y quieres probar la consulta "kittens", deberías navegar a https://www.example.com/search/?q=kittens.
  5. Define una URL canónica preferida de la página principal de tu dominio con el elemento de enlace rel="canonical" en todas las variantes de la página principal. De esta forma, ayudas a que la Búsqueda de Google elija la URL correcta que debe aplicar a las etiquetas. El servidor debe admitir la codificación de caracteres UTF-8.
  6. En el caso de las aplicaciones, habilita los filtros del objeto intent adecuados para admitir la URL que especifiques en el destino de la aplicación de las etiquetas. Para ver un ejemplo sobre cómo crear filtros de objetos intent en las URL de Búsqueda de Google, consulta la página Firebase App Indexing para Android.

Ejemplo

A continuación proporcionamos un ejemplo de resultado de búsqueda de "Pinterest" en Google que devuelve un cuadro de búsqueda de enlaces de sitio en el sitio web de Pinterest:

Cuadro de búsqueda de enlaces de sitio en uso

A continuación se ofrece un ejemplo de etiquetas que implementaría un cuadro de búsqueda de enlaces de sitio que utiliza el buscador personalizado del sitio web:

JSON-LD

A continuación se muestra un ejemplo en JSON-LD:


<html>
  <head>
    <title>The title of the page</title>
    <script type="application/ld+json">
    {
      "@context": "https://schema.org",
      "@type": "WebSite",
      "url": "https://www.example.com/",
      "potentialAction": {
        "@type": "SearchAction",
        "target": "https://query.example.com/search?q={search_term_string}",
        "query-input": "required name=search_term_string"
      }
    }
    </script>
  </head>
  <body>
  </body>
</html>
Microdatos

A continuación se muestra un ejemplo en microdatos:


<div itemscope itemtype="https://schema.org/WebSite">
  <meta itemprop="url" content="https://www.example.com/"/>
  <form itemprop="potentialAction" itemscope itemtype="https://schema.org/SearchAction">
    <meta itemprop="target" content="https://query.example.com/search?q={search_term_string}"/>
    <input itemprop="query-input" type="text" name="search_term_string" required/>
    <input type="submit"/>
  </form>
</div>
  

A continuación se muestra un ejemplo de un sitio web y una aplicación en JSON-LD:

<html>
  <head>
    <title>The title of the page</title>
    <script type="application/ld+json">
    {
      "@context": "https://schema.org",
      "@type": "WebSite",
      "url": "https://www.example.com/",
      "potentialAction": [{
        "@type": "SearchAction",
        "target": "https://query.example.com/search?q={search_term_string}",
        "query-input": "required name=search_term_string"
      },{
        "@type": "SearchAction",
        "target": "android-app://com.example/https/query.example.com/search/?q={search_term_string}",
        "query-input": "required name=search_term_string"
      }]
    }
    </script>
  </head>
  <body>
  </body>
</html>

Directrices

Debes seguir estas directrices para que tu sitio web pueda aparecer como resultado enriquecido.

La Búsqueda de Google puede que añada un cuadro de búsqueda de enlaces de sitio a tu sitio web, incluso si no incluye los datos estructurados que se describen aquí. Sin embargo, puedes impedir que ocurra si añades esta metaetiqueta a tu página principal:

<meta name="google" content="nositelinkssearchbox" />

Definiciones de tipos de datos estructurados

Para que tu contenido pueda aparecer con un cuadro de búsqueda de enlaces de sitio, tienes que incluir las propiedades obligatorias.

Tipo de WebSite modificado

La Búsqueda de Google utiliza un tipo de datos estructurados de WebSite modificado en los cuadros de búsqueda de sitios web y aplicaciones. La definición completa de WebSite está en schema.org, aunque la Búsqueda de Google no sigue exactamente ese estándar. La descripción que se muestra a continuación es definitiva.

Propiedades obligatorias
potentialAction

Es la matriz de uno o dos objetos SearchAction

Este objeto describe el URI al que se envía la consulta y la sintaxis de la solicitud que se envía. Debes implementar una página web o un controlador intent que pueda recibir la solicitud y hacer una búsqueda adecuada en la cadena enviada. Si el usuario no está en una aplicación Android (o está en una. pero no ha especificado un destino de intent Android), el cuadro de búsqueda enviará la versión del sitio web de la consulta a la ubicación especificada; si el usuario está en un dispositivo Android y ha especificado un URI de intent Android, enviará ese objeto intent.

Siempre debes crear un sitio web SearchAction para habilitar el caso de búsqueda para ordenadores. Si también se admite la búsqueda de aplicaciones, puedes especificar un objeto SearchAction en la aplicación. Cada objeto SearchAction tiene estos miembros:

potentialAction.query-input

Text

Usa la cadena required name = search_term_string o cualquier marcador de posición que hayas utilizado en el objeto target.

potentialAction.target

Text

Una cadena con este formato: search_handler_uri {search_term_string}

Por ejemplo:

https://query.example.com/search?q={search_term_string}
search_handler_uri Si se trata de sitios web, es la URL del controlador que debe recibir y controlar las consultas de búsqueda; si son aplicaciones, es el URI del controlador de intent del buscador que debe controlar estas consultas.
search_term_string

Una cadena de marcador de posición que se reemplaza por la consulta de búsqueda del usuario cuando el usuario hace clic en el botón "Buscar" en el cuadro de búsqueda.

url

URL

Especifica la URL del sitio web que se busca. Define la página principal canónica del sitio web. Por ejemplo: https://www.example.org

Monitorizar resultados enriquecidos con Search Console

Search Console es una herramienta que te ayuda a monitorizar el rendimiento de tus páginas en la Búsqueda de Google. No hace falta que te registres en Search Console para que tu sitio web aparezca en los resultados de la Búsqueda de Google, pero, si lo haces, sabrás cómo lo ve Google y qué puedes hacer para mejorarlo. Te recomendamos que consultes Search Console en los siguientes casos:

  1. Después de implementar datos estructurados por primera vez
  2. Después de publicar plantillas nuevas o modificar el código
  3. Para analizar el tráfico periódicamente

Después de implementar datos estructurados por primera vez

Una vez que Google haya indexado tus páginas, puedes comprobar si hay algún problema en el informe de estado de resultados enriquecidos correspondiente. Lo ideal sería ver que aumenta el número de páginas válidas y que la cantidad de errores y advertencias se mantiene estable. Si detectas problemas en tus datos estructurados, haz lo siguiente:

  1. Corrige los errores.
  2. Inspecciona la URL en tiempo real para ver si el problema continúa.
  3. Solicita que se valide la corrección desde el informe de estado.

Después de publicar plantillas nuevas o modificar el código

Cuando hagas cambios importantes en tu sitio web, mira si se incrementa la cantidad de errores y advertencias de datos estructurados.
  • Si notas que hay más errores, quizá sea porque has implementado una plantilla que no funciona correctamente, o puede que tu sitio web esté interactuando con la plantilla que utilizas de un modo diferente e incorrecto.
  • Si notas que disminuye el número de elementos válidos sin que aumenten los errores, es posible que hayas dejado de insertar datos estructurados en tus páginas. Para saber cuál es la causa del problema, utiliza la herramienta de inspección de URLs.

Para analizar el tráfico periódicamente

Analiza el tráfico de la Búsqueda de Google con el informe de rendimiento. En él, verás con qué frecuencia aparece tu página como resultado enriquecido en la Búsqueda, cada cuánto hacen clic en ella los usuarios y cuál es la posición media que ocupa tu sitio web en los resultados de búsqueda. También puedes obtener automáticamente estos resultados con la API de Search Console.

Solucionar problemas

Si tienes problemas para implementar datos estructurados en tu contenido, a continuación se incluyen recursos que pueden resultarte útiles.