Configurações avançadas de URL

OBSERVAÇÃO

A Otimização do mecanismo de pesquisa (SEO) se tornou uma preocupação principal para muitos comerciantes. Por conseguinte, é necessário dar resposta às preocupações relativas às SEO em muitos projetos AEM. Leia SEO e Práticas recomendadas de gerenciamento de URL para obter mais informações.

Os Componentes principais da CIF do AEM fornecem configurações avançadas para personalizar os URLs das páginas de produto e categoria. Muitas implementações personalizam esses URLs para fins de otimização de mecanismo de pesquisa (SEO). O vídeo a seguir mostra detalhes sobre como configurar o serviço UrlProvider e os recursos do Mapeamento do Sling para personalizar os URLs das páginas de produto e categoria.

Configuração

Para configurar o serviço UrlProvider de acordo com os requisitos e necessidades de SEO, o projeto deve fornecer uma configuração OSGI para a "Configuração do provedor de URL da CIF".

OBSERVAÇÃO

Desde a versão 2.0.0 dos Componentes principais da CIF do AEM, a configuração do Provedor de URL fornece apenas formatos de url predefinidos, em vez dos formatos configuráveis de texto livre conhecidos das versões 1.x. Além disso, o uso de seletores para transmitir dados em URLs foi substituído por sufixos.

Formato de URL da página do produto

Isso configura os URLs das páginas do produto e oferece suporte às seguintes opções:

  • {{page}}.html/{{sku}}.html#{{variant_sku}} (default)
  • {{page}}.html/{{url_key}}.html#{{variant_sku}}
  • {{page}}.html/{{sku}}/{{url_key}}.html#{{variant_sku}}
  • {{page}}.html/{{url_path}}.html#{{variant_sku}}
  • {{page}}.html/{{sku}}/{{url_path}}.html#{{variant_sku}}

No caso de Loja de referência Venia:

  • {{page}} será substituída por /content/venia/us/en/products/product-page
  • {{sku}} será substituído pelo SKU do produto, por exemplo VP09
  • {{url_key}} será substituída pela url_key propriedade do produto, por exemplo lenora-crochet-shorts
  • {{url_path}} será substituída pelo do produto url_path, por exemplo venia-bottoms/venia-pants/lenora-crochet-shorts
  • {{variant_sku}} será substituída pela variante selecionada no momento, por exemplo, VP09-KH-S

Com os dados de exemplo acima, um URL de variante de produto formatado usando o formato padrão de URL será semelhante a /content/venia/us/en/products/product-page.html/VP09.html#VP09-KH-S.

Formato de URL da página de categoria

Isso configura os URLs das páginas de categoria ou lista de produtos e oferece suporte às seguintes opções:

  • {{page}}.html/{{url_path}}.html (padrão)
  • {{page}}.html/{{url_key}}.html

No caso de Loja de referência Venia:

  • {{page}} será substituída por /content/venia/us/en/products/category-page
  • {{url_key}} será substituída pela url_key propriedade da categoria
  • {{url_path}} será substituído por url_path

Com os dados de exemplo acima, um URL de página de categoria formatado usando o formato padrão de URL será semelhante a /content/venia/us/en/products/category-page.html/venia-bottoms/venia-pants.html.

OBSERVAÇÃO

O url_path é uma concatenação do url_keys dos ancestrais de um produto ou categoria e do url_key do produto ou categoria, separados por / barra.

Formatos de URL personalizados

Para fornecer um formato de URL personalizado, um projeto pode implementar a UrlFormat interface e registrar a implementação como serviço OSGI, usando-a como página de categoria ou formato de url da página do produto. A propriedade de serviço UrlFormat#PROP_USE_AS indica qual dos formatos predefinidos configurados deve ser substituído:

  • useAs=productPageUrlFormat, substituirá o formato de url da página do produto configurado
  • useAs=categoryPageUrlFormat, substituirá o formato de url da página da categoria configurada

Se houver várias implementações do UrlFormat registradas como serviços OSGI, aquela com a classificação de serviço mais alta substituirá aquela(s) pela classificação de serviço mais baixa.

O UrlFormat deve implementar um par de métodos para criar um URL a partir de um determinado Mapa de parâmetros e analisar um URL para retornar o mesmo Mapa de parâmetros. Os parâmetros são os mesmos descritos acima, somente para categorias um parâmetro {{uid}} adicional é fornecido para o UrlFormat.

Combinar com Mapeamentos do Sling

Além do UrlProvider, também é possível configurar os Mapeamentos do Sling para substituir e processar URLs. O Arquétipo do AEM também fornece um exemplo de configuração para definir alguns Mapeamentos do Sling para as portas 4503 (Publish) e 80 (Dispatcher).

Combinar com o AEM Dispatcher

As substituições de URL também podem ser obtidas usando o servidor HTTP do AEM Dispatcher com o módulo mod_rewrite. O Arquétipo de projeto do AEM fornece uma configuração de referência do AEM Dispatcher que já inclui regras de substituição básicas para o tamanho gerado.

Exemplo

O projeto da loja de referência Venia inclui configurações de exemplo para demonstrar o uso de URLs personalizados para páginas de produto e categoria. Isso permite que cada projeto configure padrões de URL individuais para páginas de produto e categoria de acordo com suas necessidades de SEO. Usa-se uma combinação do UrlProvider da CIF e os Mapeamentos do Sling conforme descrito acima.

OBSERVAÇÃO

Essa configuração deve ser ajustada com o domínio externo usado pelo projeto. Os Mapeamentos do Sling estão funcionando com base no nome do host e no domínio. Portanto, essa configuração é desativada por padrão e deve ser ativada antes da implantação. Para fazer isso, renomeie a pasta hostname.adobeaemcloud.com do Mapeamento do Sling em ui.content/src/main/content/jcr_root/etc/map.publish/https de acordo com o nome de domínio usado e ative essa configuração adicionando resource.resolver.map.location="/etc/map.publish" à configuração JcrResourceResolver do projeto.

Recursos adicionais

Nesta página