Configuraciones de URL avanzadas
- Se aplica a:
- Experience Manager as a Cloud Service
Creado para:
- Administrador
Los componentes principales del CIF de AEM proporcionan configuraciones avanzadas para personalizar las direcciones URL de las páginas de productos y categorías. Muchas implementaciones personalizan estas direcciones URL con fines de optimización de los motores de búsqueda (SEO). En el siguiente vídeo se explica cómo configurar el UrlProvider
servicio y las funciones de las Asignaciones de Mapping para personalizar las direcciones URL de las páginas de productos y categorías.
Configuración
Para configurar el servicio UrlProvider
según los requisitos y necesidades de SEO, un proyecto debe proporcionar una configuración OSGI para la configuración del proveedor de URL de CIF.
Formato de URL de página de producto
Configura las direcciones URL de las páginas de productos y admite las siguientes opciones:
{{page}}.html/{{sku}}.html#{{variant_sku}}
(predeterminada){{page}}.html/{{sku}}/{{url_key}}.html#{{variant_sku}}
{{page}}.html/{{sku}}/{{category}}/{{url_key}}.html#{{variant_sku}}
{{page}}.html/{{sku}}/{{url_path}}.html#{{variant_sku}}
{{page}}.html/{{url_key}}.html#{{variant_sku}}
{{page}}.html/{{category}}/{{url_key}}.html#{{variant_sku}}
{{page}}.html/{{url_path}}.html#{{variant_sku}}
Si existe la Tienda de referencia de Venia:
{{page}}
se ha reemplazado por/content/venia/us/en/products/product-page
{{sku}}
se ha reemplazado por el SKU del producto, por ejemplo,VP09
{{url_key}}
se ha reemplazado por la propiedadurl_key
del producto, por ejemplo,lenora-crochet-shorts
{{url_path}}
se ha reemplazado porurl_path
del producto, por ejemplo,venia-bottoms/venia-pants/lenora-crochet-shorts
{{variant_sku}}
se ha reemplazado por la variante seleccionada actualmente, por ejemplo,VP09-KH-S
Dado que url_path
quedó obsoleto, los formatos de URL de producto predefinidos utilizan url_rewrites
de un producto y eligen el que tenga la mayor cantidad de segmentos de ruta como alternativa si url_path
no está disponible.
Con los datos de ejemplo anteriores, una URL de variante de producto con formato de URL predeterminada es /content/venia/us/en/products/product-page.html/VP09.html#VP09-KH-S
.
Formato de URL de página de categoría
Configura las direcciones URL de las páginas de categorías o listas de productos y admite las siguientes opciones:
{{page}}.html/{{url_path}}.html
(predeterminada){{page}}.html/{{url_key}}.html
Si existe la Tienda de referencia de Venia:
{{page}}
se ha reemplazado por/content/venia/us/en/products/category-page
{{url_key}}
se ha reemplazado por la propiedadurl_key
de la categoría{{url_path}}
se ha reemplazado porurl_path
de la categoría
Con los datos del ejemplo anterior, la dirección URL de una página de categoría con formato de dirección URL predeterminada es /content/venia/us/en/products/category-page.html/venia-bottoms/venia-pants.html
.
url_path
es una concatenación de url_keys
de los antecesores de un producto o categoría y url_key
del producto o categoría separados por /
barra diagonal. Cada url_key
se considera único dentro de un almacén determinado.Configuración específica de la tienda
Los formatos de URL de categoría y página de producto para todo el sistema establecidos por la configuración del proveedor de URL de CIF se pueden cambiar en cada tienda.
En la configuración de CIF, un editor puede seleccionar un formato de dirección URL de página de categoría o producto alternativo. Si no se selecciona nada allí, la implementación vuelve a la configuración de todo el sistema.
Cambiar el formato de URL de un sitio web activo puede tener un impacto negativo en el tráfico orgánico del sitio. Consulte las Prácticas recomendadas que se describen a continuación y planifique cuidadosamente el cambio de formato de URL con anticipación.
URL de páginas de productos según las categorías
Dado que es posible codificar la información de la categoría en una dirección URL de producto, los productos que se encuentran en varias categorías también se pueden abordar con varias direcciones URL de producto.
Los formatos de URL predeterminados seleccionan una de las posibles alternativas utilizando el siguiente esquema:
- si el backend de comercio electrónico define
url_path
, utilícelo (obsoleto) - de
url_rewrites
usar las direcciones URL que terminan conurl_key
del producto como alternativas - de estas alternativas utilice la que tenga la mayor cantidad de segmentos de ruta
- si hay varios, tome el primero en el orden dado por el backend de comercio electrónico
Este esquema selecciona el(la) url_path
con la mayor cantidad de antecesores, basándose en la suposición de que una categoría secundaria es más específica que su categoría principal. El elemento url_path
seleccionado se considera canónico y siempre se usa como vínculo canónico en las páginas de productos o en el mapa del sitio del producto.
Sin embargo, cuando un comprador navega de una página de categoría a una página de producto, o de una página de producto a otra página de producto relacionada en la misma categoría, vale la pena conservar el contexto de categoría actual. En este caso, la selección url_path
debería preferir las alternativas que se encuentran dentro del contexto de categoría actual sobre la selección canónica descrita anteriormente.
Esta característica debe habilitarse en la configuración del proveedor de URL de CIF. Si se habilita, las alternativas de puntuaciones de selección serán más altas cuando
- coinciden con partes de
url_path
de una categoría determinada desde el principio (coincidencia de prefijo difuso) - o coinciden con
url_key
de una categoría determinada en cualquier lugar (coincidencia parcial exacta)
Por ejemplo, considere la respuesta para una consulta de productos a continuación. Dados lo siguiente:
- el usuario se encuentra en la página de categoría "Nuevos productos / Novedades en verano de 2022"
- la tienda utiliza el formato de dirección URL de página de categoría predeterminado
La alternativa "new-products/new-in-summer-2022/gold-cirque-earrings.html" coincide con dos de los segmentos de ruta del contexto desde el principio. Es decir, "nuevos productos" y "nuevos en verano de 2022". Si la tienda usa un formato de dirección URL de página de categoría que sólo contiene la categoría url_key
, se seleccionaría la misma alternativa, ya que coincide con el url_key
del contexto en cualquier lugar. En ambos casos, la dirección URL de la página de producto se crea para "new-products/new-in-summer-2022/gold-cirque-earrings.html" url_path
.
{
"data": {
"products": {
"items": [
{
"sku": "VA18-GO-NA",
"url_key": "gold-cirque-earrings",
"url_rewrites": [
{
"url": "gold-cirque-earrings.html"
},
{
"url": "venia-accessories/gold-cirque-earrings.html"
},
{
"url": "venia-accessories/venia-jewelry/gold-cirque-earrings.html"
},
{
"url": "new-products/gold-cirque-earrings.html"
},
{
"url": "new-products/new-in-summer-2022/gold-cirque-earrings.html"
}
]
}
]
}
}
}
Categoría específica y páginas del producto
Es posible crear páginas de múltiples categorías y productos solo para un subconjunto específico de categorías o productos de un catálogo.
Criterios de selección
La selección de una página de categoría específica es sencilla, según la categoría url_path
o url_key
. La coincidencia de subcategorías solo se admite para los formatos de dirección URL que contienen la categoría completa url_path
. De lo contrario, solo es posible una coincidencia exacta de url_key
.
Las páginas de productos específicas se seleccionan según el SKU o la categoría del producto. Esto último requiere que se codifique parte de la información de la categoría en la dirección URL del producto. Esta funcionalidad solo está disponible para algunos de los formatos de URL predeterminados. Consulte la siguiente tabla para ver una comparación sobre qué formato de URL admite la selección de páginas específicas por SKU o categoría.
{{page}}.html/{{url_key}}.html
{{page}}.html/{{category}}/{{url_key}}.html
{{page}}.html/{{url_path}}.html
{{page}}.html/{{sku}}.html
{{page}}.html/{{sku}}/{{url_key}}.html
{{page}}.html/{{sku}}/{{category}}/{{url_key}}.html
{{page}}.html/{{sku}}/{{url_path}}.html
Vinculación profunda
UrlProvider
está preconfigurado para generar vínculos profundos a categorías específicas y páginas de productos en instancias de nivel de creación. Esta capacidad es útil para los editores que exploran un sitio mediante el modo de vista previa, navegan a una página de producto o categoría específica y vuelven al modo de edición para editar la página.
En las instancias de nivel de publicación, por otro lado, las direcciones URL de la página del catálogo deben mantenerse estables para no perder ganancias en las clasificaciones de los motores de búsqueda, por ejemplo. Debido a ese nivel de publicación, las instancias no representan vínculos profundos a páginas de catálogo específicas de forma predeterminada. Para cambiar este comportamiento, se puede configurar la estrategia de página específica del proveedor de URL de CIF para que siempre genere direcciones URL de página específicas.
Varias páginas del catálogo
Cuando los editores desean tener un control total de la navegación de nivel superior de un sitio, es posible que no deseen utilizar una sola página del catálogo para procesar las categorías de nivel superior de un catálogo. En su lugar, los editores pueden crear varias páginas de catálogo, una para cada categoría del catálogo que deseen incluir en la navegación de nivel superior.
Para ese caso de uso, cada una de las páginas del catálogo puede tener una referencia a una página de producto y categoría específica para la categoría configurada para la página del catálogo. UrlProvider
utiliza estas conexiones para crear vínculos para las páginas y categorías de la categoría configurada. Sin embargo, por motivos de rendimiento solo se tienen en cuenta los elementos secundarios de la página de catálogo directa de la raíz de navegación o la página de aterrizaje de un sitio.
Se recomienda que las páginas de producto y categoría de una página del catálogo desciendan a esa página del catálogo; de lo contrario, es posible que componentes como Navegación o Ruta de exploración no funcionen correctamente.
Personalizaciones
Formatos de URL personalizados
Para proporcionar un formato de dirección URL personalizado, un proyecto puede implementar la interfaz de servicio ProductUrlFormat
o CategoryUrlFormat
y registrar la implementación como servicio OSGI. Estas implementaciones, si están disponibles, reemplazan el formato configurado y predefinido. Si hay varias implementaciones registradas, la que tenga la clasificación de servicio más alta reemplaza a las que tienen la clasificación de servicio más baja.
Las implementaciones de formato de URL personalizadas deben implementar un par de métodos para crear una dirección URL a partir de parámetros determinados y para analizar una dirección URL y devolver los mismos parámetros respectivamente.
Combinación con asignaciones de Sling
Además de UrlProvider
, también es posible configurar Asignaciones de Sling para reescribir y procesar direcciones URL. El proyecto AEM Archetype también proporciona una configuración de ejemplo para configurar algunas asignaciones de Sling para el puerto 4503 (publicación) y 80 (Dispatcher).
Combinación con AEM Dispatcher
Las reescrituras de URL también se pueden lograr utilizando el servidor HTTP AEM Dispatcher con el módulo mod_rewrite
. El tipo de archivo del proyecto AEM proporciona una referencia a la configuración de AEM Dispatcher que ya incluye las reglas de reescritura básicas para el tamaño generado.
Prácticas recomendadas
Elija el mejor formato de URL
Como se mencionó antes de seleccionar uno de los formatos predeterminados disponibles, o incluso implementar un formato personalizado, depende en gran medida de las necesidades y requisitos de una tienda. Las siguientes sugerencias pueden ayudar a tomar una decisión informada.
Use un formato de dirección URL de página de producto que contenga el SKU.
Los componentes principales de CIF utilizan el SKU como identificador principal en todos los componentes. Si el formato de URL de la página del producto no contiene el SKU, es necesario realizar una consulta GraphQL para resolverlo. Esta resolución puede afectar al tiempo hasta el primer byte. Además, es posible que los compradores puedan encontrar productos por SKU utilizando motores de búsqueda.
Use un formato de dirección URL de página de producto que contenga el contexto de categoría.
Algunas características del proveedor de URL de CIF solo están disponibles cuando se usan formatos de URL de productos que codifican el contexto de categoría, como la categoría url_key
o la categoría url_path
. Incluso si estas funciones pueden no ser necesarias para una tienda nueva, el uso de uno de estos formatos de URL al principio ayuda a reducir los esfuerzos de migración en el futuro.
Equilibrio entre la longitud de la dirección URL y la información codificada.
Según el tamaño del catálogo y, en particular, el tamaño y la profundidad del árbol de categorías, puede que no sea razonable codificar todo el url_path
de categorías en la dirección URL. En ese caso, la longitud de la dirección URL podría reducirse incluyendo solo el url_key
de la categoría. Este método admite la mayoría de las características disponibles al usar la categoría url_path
.
Además, usa Asignaciones de Sling para combinar el SKU con el producto url_key
. En la mayoría de los sistemas de comercio electrónico, el SKU sigue un formato concreto y debería ser posible separarlo del url_key
para las solicitudes entrantes. Con esto en mente, debería ser posible reescribir una URL de página de producto a /p/{{category}}/{{sku}}-{{url_key}}.html
y una URL de categoría a /c/{{url_key}}.html
respectivamente. El prefijo /p
y /c
siguen siendo necesarios para distinguir las páginas de productos y categorías de otras páginas de contenido.
Migración a un nuevo formato de URL
Muchos de los formatos de URL predeterminados son compatibles entre sí, lo que significa que las URL con formato de uno pueden ser analizadas por otro. Esto ayuda a migrar entre formatos de URL.
Por otro lado, los motores de búsqueda necesitan tiempo para volver a rastrear todas las páginas del catálogo con el nuevo formato de URL. Para admitir este proceso y también para mejorar la experiencia del usuario final, se recomienda proporcionar redirecciones que reenvíen al usuario de las direcciones URL antiguas a las nuevas.
Un método para hacerlo sería conectar un entorno de ensayo al back-end de comercio electrónico de producción y configurarlo para utilizar el nuevo formato de URL. Después, obtenga el mapa del sitio del producto generado por el generador de mapas del sitio de productos de CIF tanto para el entorno de ensayo como de producción y úselo para crear un mapa de reescritura Apache httpd. Esta asignación de reescritura se puede implementar en Dispatcher junto con el despliegue del nuevo formato de URL.
Ejemplo
El proyecto Tienda de referencia de Venia incluye configuraciones de muestra para demostrar el uso de direcciones URL personalizadas para páginas de productos y categorías. Esta configuración permite que cada proyecto configure patrones de URL individuales para páginas de productos y categorías según sus necesidades de SEO. Se utiliza una combinación de asignaciones de CIF UrlProvider
y de Sling como se describe anteriormente.
hostname.adobeaemcloud.com
de la asignación de Sling en ui.content/src/main/content/jcr_root/etc/map.publish/https
según el nombre de dominio utilizado y habilite esta configuración agregando resource.resolver.map.location="/etc/map.publish"
a la configuración JcrResourceResolver
del proyecto.