Cuadro de búsqueda de enlaces de sitios

Los cuadros de búsqueda de enlaces de sitio ofrecen a los usuarios una forma rápida de buscar en tu sitio 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.

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 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 sitios envían a los usuarios a la página de resultados de búsqueda de tu sitio 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 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 principal 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, aunque la aplicación sea tu destino preferido de búsqueda. 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 la implementación del buscador. Para ello, copia la URL WebSite.potentialAction.target de tus datos estructurados, cambiando {search_term_string} con una consulta de prueba y navegando a esa URL en un navegador web. Por ejemplo, si tu sitio web es example.com y quieres probar la consulta "gatitos", 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 de intents 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 intents en las URLs 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 sitios en el sitio web de Pinterest:

Ejemplo de uso de un cuadro de búsqueda de enlaces de sitios

A continuación se ofrece un ejemplo de etiquetas que implementaría un cuadro de búsqueda de enlaces de sitios 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 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 pueda aparecer como resultado enriquecido.

Puede que la Búsqueda de Google añada un cuadro de búsqueda de enlaces de sitios a tu sitio, 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 sitios, 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 que se busca. Define la página principal canónica del sitio. 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. Al hacer el análisis periódico del tráfico

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, o puede que tu sitio esté interactuando con la plantilla que utilizas de un modo diferente que no es adecuado.
  • Si notas que hay menos elementos válidos, pero no hay más 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.

Al hacer el análisis periódico del tráfico

Consulta el informe de rendimiento para analizar el tráfico de tus páginas en la Búsqueda de Google. 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.