Datos estructurados de cuadros de búsqueda de enlaces de sitios (WebSite)

Los cuadros de búsqueda de enlaces de sitios ofrecen a los usuarios una forma rápida de buscar directamente en tu sitio o aplicación desde la página de resultados de búsqueda. En ellos, se incluyen 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.

Si en la Búsqueda de Google ya aparece un cuadro de búsqueda de enlaces de tu sitio, puedes añadir datos estructurados de WebSite para controlar determinados aspectos de ese cuadro.

Importante: Google no garantiza que se muestre un cuadro de búsqueda de enlaces de sitios en los resultados de búsqueda. Asimismo, aunque utilices etiquetas de cuadro de búsqueda de enlaces de sitios, no aumentará la probabilidad de que aparezca uno. Para ver una lista con motivos habituales por los que es posible que Google no muestre tus datos estructurados en los resultados de búsqueda, consulta las Directrices generales de datos estructurados.

Cómo implementar un 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 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.
   • Si ya estás implementando datos estructurados de WebSite para la función de nombres de sitios, asegúrate de anidar las propiedades del nombre del sitio en el mismo nodo. Es otras palabras, evita crear un bloque de datos estructurados WebSite adicional en tu página principal, si es posible.
   • Especifica siempre un objeto SearchAction en el sitio web y, si quieres, uno adicional si admite la búsqueda en aplicaciones. Debes tener un objeto SearchAction en el sitio web aunque el destino preferido de las búsquedas sea tu aplicación. De este modo, te aseguras de que, si un usuario no busca desde un teléfono Android o no tiene instalada tu aplicación Android, el resultado de la búsqueda dirige a tu sitio web.
   • Consulta más información sobre dónde insertar datos estructurados en una página en función del formato que uses.
   ¿Usas un CMS? Quizá te resulte más fácil usar un complemento que esté integrado en tu CMS.
   ¿Usas JavaScript? Consulta cómo generar datos estructurados con JavaScript.
3. Sigue las directrices.
4. Valida tu código con la prueba de resultados enriquecidos.
5. Verifica la implementación de tu buscador. Para ello, copia la URL WebSite.potentialAction.target de tus datos estructurados, cambia {search_term_string} por una consulta de prueba y ve 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.
   Nota: En este documento, usamos q como clave del parámetro de URL de {search_term_string}, pero en los componentes de consulta de tus URLs puedes utilizar cualquier cadena que se permita en RFC 3986. Por ejemplo, podrías tener cheesey_query={search_term_string} sin problema.
6. 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.
7. 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 la Búsqueda de Google, consulta la página Firebase App Indexing para Android.
8. Crea varias páginas que incluyan tus datos estructurados y comprueba cómo las ve Google con la herramienta de inspección de URLs. Asegúrate de que Google pueda acceder a tu página y de que no esté bloqueada por un archivo robots.txt, por la etiqueta noindex ni por requisitos de inicio de sesión. Si la página se ve bien, puedes solicitar que Google vuelva a rastrear tus URLs.
   Nota: Da cierto margen de tiempo a Google para que vuelva a rastrear e indexar tus páginas. Recuerda que Google puede tardar varios días en encontrar y rastrear una página después de publicarse.
9. Para que Google siempre tenga la versión actualizada de tus páginas, te recomendamos que envíes un sitemap. Puedes automatizar el envío con la API Sitemap de Search Console.

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:

Nota: Es posible que estas imágenes no reflejen con precisión cómo se muestra este tipo de resultados en la búsqueda. Puedes previsualizar la mayoría de las funciones con la prueba de resultados enriquecidos.

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": { "@type": "EntryPoint", "urlTemplate": "https://query.example.com/search?q={search_term_string}" }, "query-input": "required name=search_term_string" } } </script> </head> <body> </body> </html>

<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": {
          "@type": "EntryPoint",
          "urlTemplate": "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>

<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": { "@type": "EntryPoint", "urlTemplate": "https://query.example.com/search?q={search_term_string}" }, "query-input": "required name=search_term_string" },{ "@type": "SearchAction", "target": { "@type": "EntryPoint", "urlTemplate": "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>

<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": {
          "@type": "EntryPoint",
          "urlTemplate": "https://query.example.com/search?q={search_term_string}"
        },
        "query-input": "required name=search_term_string"
      },{
        "@type": "SearchAction",
        "target": {
          "@type": "EntryPoint",
          "urlTemplate": "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.

Advertencia: Si tu sitio infringe una o varias de estas directrices, es posible que apliquemos alguna acción manual para resolver esas infracciones. Una vez que hayas solucionado los problemas, puedes enviar una solicitud de reconsideración.

• Directrices básicas de la Búsqueda
• Directrices generales de datos estructurados

Evitar que aparezca un cuadro de búsqueda de enlaces de sitios

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 etiqueta meta a tu página principal:

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

El cuadro de búsqueda de enlaces de sitios se inhabilita como parte del rastreo y procesamiento habituales de la página que hace el robot de Google, lo que puede tardar algunas semanas en función del sitio y otros factores.

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. Las propiedades que admite Google son las siguientes:

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 para 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 para Android, enviará ese intent. Debes crear un sitio web SearchAction para habilitar el caso de búsqueda para ordenadores. Si también permites que se busque en aplicaciones, puedes especificar otro objeto SearchAction para tu aplicación. Cada objeto SearchAction debe contener las siguientes propiedades anidadas: potentialAction.@type potentialAction.target potentialAction.query-input Ejemplo de sitio web Con el siguiente ejemplo se enviaría una solicitud GET a https://query.example.com/search?q=user%20search%20string. "potentialAction": [{ "@type": "SearchAction", "target": { "@type": "EntryPoint", "urlTemplate": "https://query.example.com/search?q={search_term_string}" } "query-input": "required name=search_term_string" }] Ejemplo de aplicación Con el siguiente ejemplo se enviaría un objeto intent Android a android-app://com.example/https/query.example.com/search/?q=user_search_string. "potentialAction": [{ "@type": "SearchAction", "target": { "@type": "EntryPoint", "urlTemplate": "android-app://com.example/https/query.example.com/search/?q={search_term_string}" } "query-input": "required name=search_term_string" }]
potentialAction.query-input	Text Usa la cadena required name = search-term o cualquier marcador de posición que hayas utilizado en el objeto target. Estos marcadores de posición deben tener los mismos valores. Por ejemplo, en los dos valores de marcador de posición de las propiedades target y query-input se usa la cadena search-term: "potentialAction": [{ "@type": "SearchAction", "target": { "@type": "EntryPoint", "urlTemplate": "https://query.example.com/search?q={search-term}" } "query-input": "required name=search-term" }] query-input es una propiedad con anotaciones. Puedes consultar más información en la página de Potential Actions.
potentialAction.target	EntryPoint Objeto EntryPoint con una propiedad urlTemplate. El valor de urlTemplate debe ser 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 Con sitios web, indica la URL del controlador que recibe y gestiona las consultas de búsqueda; en el caso de las aplicaciones, indica el URI del controlador de intent del buscador que gestiona 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" del cuadro de búsqueda. Comprueba que la cadena de marcador de posición que usas aquí también coincide con el valor del elemento name de la propiedad query-input. Google también permite usar un formato breve en esta propiedad. En particular, puedes incluir un elemento Text directamente en la propiedad potentialAction.target y que Google lo expanda a urlTemplate. Por ejemplo: "potentialAction": [{ "@type": "SearchAction", "target": "android-app://com.example/https/query.example.com/search/?q={search_term_string}", "query-input": "required name=search_term_string" }] No obstante, este formato no es estándar y Google lo admite principalmente para mantener la simplicidad de los microdatos. Para conseguir los mejores resultados posibles, te recomendamos que incluyas un objeto EntryPoint completo.
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 es que haya un aumento en el número de elementos válidos y que no lo haya en el número de elementos no válidos. Si detectas problemas en tus datos estructurados, haz lo siguiente:

1. Corrige los elementos no válidos.
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 significativos en tu sitio web, observa si se incrementa la cantidad de elementos no válidos de datos estructurados.

• Si notas que hay más elementos no válidos, 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 un incremento de elementos no válidos, 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.

Advertencia: No depures tus páginas mediante enlaces en caché. Es mejor que uses la herramienta de inspección de URLs, ya que tiene la versión más actualizada de tus páginas.

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 o depurar datos estructurados, a continuación se incluyen algunos recursos que pueden serte útiles.

• Si usas un sistema de gestión de contenido (CMS) o alguien se encarga de gestionar tu sitio, pídele ayuda. No olvides reenviarle cualquier mensaje de Search Console que incluya información sobre el problema en cuestión.
• Google no garantiza que las funciones que utilizan datos estructurados aparezcan en los resultados de búsqueda. Para ver una lista con motivos habituales por los que Google no muestra tu contenido en resultados enriquecidos, consulta las directrices generales de datos estructurados.
• Es posible que haya un error en tus datos estructurados. Consulta la lista de errores de datos estructurados.
• Si se ha aplicado una acción manual de datos estructurados a tu página, se ignorarán sus datos estructurados, aunque la página puede seguir apareciendo en los resultados de la Búsqueda de Google. Para corregir problemas de datos estructurados, usa el informe "Acciones manuales".
• Revisa las directrices para comprobar si tu contenido no las cumple. El problema podría deberse a que la página incluye contenido engañoso o etiquetas con contenido fraudulento. No obstante, es posible que el problema no se deba a la sintaxis, por lo que la prueba de resultados enriquecidos no podrá ayudarte a identificarlo.
• Soluciona problemas si faltan resultados enriquecidos o si se ha reducido su número total.
• Dale tiempo a Google para que vuelva a rastrear e indexar tu página. Recuerda que Google puede tardar varios días en encontrar y rastrear una página después de publicarse. Consulta las preguntas frecuentes sobre el rastreo y la indexación de la Búsqueda de Google.
• Publica una pregunta en el foro del Centro de la Búsqueda de Google.