Cuadro de búsqueda de vínculos a sitios

La Búsqueda de Google puede mostrar un cuadro de búsqueda específico para buscar dentro de tu sitio web cuando aparece como un resultado de la búsqueda. Ese cuadro de búsqueda se desarrolló con la tecnología de la Búsqueda de Google. Sin embargo, si deseas usar tu propio motor de búsqueda para desarrollar el cuadro de búsqueda o si deseas que los resultados de la búsqueda también incluyan una app para dispositivos móviles asociada, puedes hacerlo usando datos estructurados incorporados en el sitio web.

Los usuarios de la Búsqueda a menudo ingresan el nombre de la marca o la URL de una app o un sitio conocidos solo para realizar una búsqueda más detallada una vez que llegan al destino. Por ejemplo, los usuarios que buscan pines de pizza en Pinterest escriben Pinterest o pinterest.com en la Búsqueda  de Google, ya sea desde Google app o el navegador web, luego cargan el sitio o app de Android y, por último, buscan pizzas. El cuadro de búsqueda proporciona a los usuarios una forma rápida de buscar en tu sitio o app de manera inmediata en la página de los resultados de la búsqueda. Además, implementa sugerencias en tiempo real y otras funciones.

Ejemplo

A continuación, se incluye un ejemplo de un resultado de la búsqueda para "Pinterest" en Google que muestra un cuadro de búsqueda de vínculos a sitios para el sitio web de Pinterest:

Cuadro de búsqueda de vínculos a sitios utilizado

A continuación, se incluye un lenguaje de marcado de ejemplo que implementaría un cuadro de búsqueda de vínculos a sitios que usa el motor de búsqueda personalizado del sitio web:

JSON-LD

Aquí tienes un ejemplo en JSON-LD con la herramienta de prueba de datos estructurados:

Microdatos

Aquí tienes un ejemplo en microdatos con la herramienta de prueba de datos estructurados:

Aquí tienes un ejemplo de un sitio y una app en JSON-LD con la herramienta de prueba de datos estructurados:

Lineamientos

Además de los lineamientos generales para datos estructurados, estos lineamientos adicionales se aplican al lenguaje de marcado de cuadros de búsqueda de vínculos a sitios.

Sigue estos pasos para configurar un cuadro de búsqueda para el sitio o app:

  1. Instala un motor de búsqueda que funcione en tu sitio web o app de Android.

    Las búsquedas de vínculos a sitios envían al usuario a la página de resultados de búsqueda de tu sitio o app, por eso necesitas un motor de búsqueda que funcione.

    • Sitios web: Configura un motor de búsqueda que funcione en tu sitio web o app de Android. Esta función reenvía la búsqueda del usuario a tu orientación usando la sintaxis especificada en los datos estructurados. El motor de búsqueda debería admitir búsquedas con codificación UTF-8.
    • Apps: Consulta Descripción general de la búsqueda en el sitio para programadores de Android para obtener información sobre cómo implementar un motor de búsqueda en la app. La app de Android debería admitir un intent ACTION_VIEW de los resultados de la búsqueda, con el URI de los datos correspondiente especificado en la propiedad potentialAction.target del lenguaje de marcado.
  2. Implementa el elemento de los datos estructurados de WebSite en la página principal del sitio. Una app debe tener un sitio web asociado para habilitar esta función, aun si el sitio web es una sola página. A continuación, se incluyen algunos lineamientos adicionales:
    • Agrega este lenguaje de marcado solo a la página principal y a ninguna otra página.
    • Especifica siempre una SearchAction para el sitio web y alternativamente otra si se admite la búsqueda en apps. Siempre debes tener una SearchAction para el sitio web aun si la app es la orientación de búsqueda preferida; de esa forma, se garantiza que, si el usuario no está realizando la búsqueda desde un teléfono Android o no tiene instalada la app para Android, el resultado de la búsqueda envíe a los usuarios a tu sitio web.
  3. Verifica los datos estructurados con la herramienta de prueba de datos estructurados.
  4. Para verificar la implementación del motor de búsqueda, copia la URL de WebSite.potentialAction.target de los datos estructurados, reemplaza search_term_string con una búsqueda de prueba y abre esa URL en un navegador web. Por ejemplo, si tu sitio web es ejemplo.com y quieres probar la búsqueda "gatos", irías a https://www.example.com/search/?q={kittens}.
  5. Establece una URL canónica preferida para la página principal del dominio con el elemento de vínculo rel="canonical" en todas las variantes de la página principal. Esto ayuda a que la Búsqueda de Google seleccione la URL correcta para el lenguaje de marcado. El servidor debe admitir caracteres con codificación UTF-8.
  6. Para apps, habilita los filtros de intent adecuados para admitir la URL que especificaste en la orientación de app del lenguaje de marcado. Si quieres ver un ejemplo sobre cómo crear filtros de intent para las URL de la Búsqueda de Google, consulta Indexación de aplicaciones de Firebase para Android.

La Búsqueda de Google puede elegir agregar un cuadro de búsqueda al sitio aun si no se incluyen los datos estructurados que se describen aquí. Sin embargo, es posible prevenir este comportamiento agregando la siguiente metaetiqueta a la página principal:

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

De esa forma, se inhabilitará el cuadro de búsqueda de vínculos a sitios como parte del rastreo y procesamiento normales que hace el robot de Google en la página. Esto puede tardar un par de semanas en función del sitio y otros factores.

Definiciones de tipos de datos estructurados

Debes incluir las propiedades obligatorias a fin de que tu contenido sea apto para aparecer como resultado enriquecido. También puedes incluir las propiedades recomendadas para agregar más información sobre tu contenido, lo que podría brindar una mejor experiencia del usuario.

WebSite de tipo modificado

La Búsqueda de Google usa un tipo de datos estructurados WebSite modificados para los cuadros de búsqueda del sitio web y la app. Puedes encontrar la definición completa de WebSite en schema.org, aunque la Búsqueda de Google se desvía ligeramente del estándar. La descripción incluida a continuación es definitiva.

Propiedades obligatorias
potentialAction

Matriz de uno o dos objetos de SearchAction

Este objeto describe el URI al que se enviará la búsqueda y la sintaxis de la solicitud que se envía. Debes implementar un controlador de página web o intent que pueda recibir la solicitud y ejecutar una búsqueda adecuada en el string enviado. Si el usuario no usa una app de Android (o usa una app de Android, pero no especificó una orientación de intent de Android), el cuadro de búsqueda enviará la versión del sitio web de la búsqueda a la ubicación especificada; si el usuario usa un dispositivo Android y especificó un URI de intent de Android, se enviará ese intent.

Siempre debes crear un SearchAction de sitio web para habilitar el caso de búsqueda de escritorio. Si también se admite la búsqueda de app, además puedes especificar un objeto SearchAction para la app. Cada objeto SearchAction tiene los siguientes miembros:

potentialAction.query-input

Text

Usa el string literal required name = search_term_string o cualquier marcador de posición que hayas usado en target.

potentialAction.target

Text

Un string con este formato: search_handler_uri?q={search_term_string}

Por ejemplo:

https://query.example.com/search?q={search_term_string}
search_handler_uri Para sitios web, la URL del controlador que debe recibir y manejar la búsqueda; para apps, el URI del controlador del intent para el motor de búsqueda que debe realizar las búsquedas.
search_term_string

Un string del marcador de posición que se reemplaza con la 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 en el que se realiza la búsqueda. Está configurada en la página principal canónica del sitio. Por ejemplo: https://www.example.org

Enviar comentarios sobre…