Búsqueda de contenido
El CMS de HubSpot tiene integrada la funcionalidad de búsqueda en el sitio para permitir a tus visitantes encontrar fácilmente el contenido que están buscando. Todo tu contenido de HubSpot se indexa automáticamente en el motor de búsqueda nativo de HubSpot, eliminando la molestia de configurar una herramienta de búsqueda de terceros para tu sitio web.
El motor de búsqueda es accesible a través de la api /contentsearch/v2/search. Esta API admite numerosas opciones de filtrado para permitirte crear una experiencia de búsqueda altamente personalizada y potente en tu sitio web. Por ejemplo, si quieres construir una búsqueda en tu blog, puedes consultar por type=BLOG_POST
para que solo te devuelva las publicaciones del blog. O, si quieres construir la búsqueda en la versión española de tu sitio web, podrías consultar language=es
para devolver solo las páginas en español.
La API devuelve JSON que puede ser analizado con JavaScript para mostrar los resultados en tu sitio web. Todos los tipos de contenido devolverán el dominio de la página, el título, la url y el idioma. La descripción devuelta es una muestra del texto del contenido que mejor se ajusta al término de búsqueda. Un elemento <span class="hs-search-highlight hs-highlight-html">
envolverá perfectamente el texto coincidente, permitiéndote resaltar el texto coincidente con CSS.
Dependiendo del tipo de contenido buscado, los resultados devuelven una información ligeramente diferente, por lo que puede mostrar los resultados para tipos de contenido únicos de manera diferente. Por ejemplo, las publicaciones del blog devolverán información sobre las etiquetas que tiene la publicación, quién es el autor y cuándo se publicó.
Para obtener la documentación completa sobre los parámetros de consulta y resultado, consulta la documentación de /contentsearch/v2/search.
Hay dos módulos por opción predeterminada que puedes utilizar para implementar fácilmente la búsqueda en tu sitio web, que utilizan la api /contentsearch/v2/search.
Un campo de entrada para que los visitantes introduzcan los términos de búsqueda. Este módulo puede existir en cualquier lugar de tu sitio web. Este módulo puede incluirse en una plantilla con {% module "search_input" path="@hubspot/search_input" %}
.
Devuelve un listado de contenido basado en el término de búsqueda. Este módulo puede existir en cualquier lugar de tu sitio web. Este módulo puede incluirse en una plantilla con
Si la funcionalidad de estos módulos no es la que deseas que funcione la búsqueda en tu sitio web, puedes crear tus propios módulos o funcionalidad de búsqueda. Los módulos de búsqueda por opción predeterminada están diseñados para ser ampliados en función de tus necesidades de búsqueda. Puedes ver y clonar estos módulos en el Administrador de diseño buscando sus nombres en el Finder o puedes recuperarlos en tu entorno local utilizando la CLI del CMS ejecutando hs fetch @hubspot/search_input.module
o hs fetch @hubspot/search_results.module
.
Cada dominio tiene su propia página de resultados de búsqueda por opción predeterminada. La plantilla y la ruta de esta página se establecen en Configuración > Sitio web > Páginas en la pestaña Páginas del sistema para dominios específicos. Consulta la plantilla de resultados de búsqueda del tema CMS como ejemplo. El dominio establecido para la página de resultados de búsqueda se conecta automáticamente a los módulos de búsqueda por opción predeterminada. Sin embargo, puedes construir la búsqueda como quieras usando la api /contentsearch/v2/search, en cualquier página de tu sitio web.
El orden de los resultados de la búsqueda se determina por una serie de comparaciones ponderadas del contenido de la página con el término de búsqueda del visitante. El contenido de la página se separa en campos de comparación con una ponderación distinta según dónde reside el contenido dentro de las HTML de tus páginas. Los campos de comparación se agrupan en orden de ponderación:
- Título HTML
- Metadescripción
- Elementos HTML H1
- Elementos HTML H2
- Elementos HTML H3
- Otros elementos HTML
Ten en cuenta que esta lista está sujeta a cambios.
Si deseas indicar a nuestro indexador que potencie específicamente ciertos elementos de una página, puedes envolver el contenido en una clase hs-search-keyword
.
Mientras se desarrolla un nuevo sitio, es útil poder probar la búsqueda en el sitio sin preocuparse de que éste sea indexado por motores de búsqueda como Google.
En tu robots.txt
puedes decirle a HubSpot que rastree todo, mientras bloquea otros bots.
Si alguna de tus páginas tiene una metaetiqueta que especifica que no se indexe, la página seguirá sin ser indexada, aunque se permita en el robots.txt
.
Recuerda también revisar tu robots.txt
antes del lanzamiento para asegurarse de que todo se indexa como quieres.
Dado que el CMS conoce la intención de ciertos tipos de páginas, la búsqueda de contenido puede limitar de forma segura la indexación para permitir la indexación de páginas de tipo contenido. Ejemplos de páginas de contenido:
- Páginas de sitio
- Páginas de destino
- Artículos de la base de conocimientos
- publicaciones de blog
Las páginas del sistema y las páginas protegidas por contraseña no se indexan. Las páginas restringidas de CMS Membership solo se mostrarán en la búsqueda de contenido de hubspot para los usuarios que hayan iniciado sesión y tengan acceso a las páginas.
Si bloqueas una página para que no sea indexada a los motores de búsqueda a través del archivo robots.txt
de tu sitio web o a través de las metaetiquetas
, no se indexarán para la búsqueda del sitio.
En tu robots.txt
agrega un disallow
.
También puedes agregar una metaetiqueta NOINDEX, NOFOLLOW
en <head>
a nivel de página o plantilla.
No es necesario bloquear los robots utilizando tanto el robots.txt
como la metaetiqueta. Hacerlo puede hacer que sea confuso después si decides permitir la indexación de una página.
hs-search-hidden
a tu HTML para que la búsqueda ignore el contenido de esas regiones.Gracias por tus comentarios, son muy importantes para nosotros.