Configurações avançadas de URL url

NOTE
A Otimização do mecanismo de pesquisa (SEO) se tornou uma preocupação principal para muitos comerciantes. Como resultado, as preocupações com a SEO devem ser abordadas em muitos projetos do Adobe Experience Manager (AEM) as a Cloud Service. Consulte Práticas recomendadas de gerenciamento de SEO e URL para obter informações adicionais.

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 configuration

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

NOTE
AEM Desde a versão 2.0.0 dos Componentes principais do CIF, 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 do URL da página do produto product

Configura os URLs das páginas de produtos e oferece suporte às seguintes opções:

  • {{page}}.html/{{sku}}.html#{{variant_sku}} (default)
  • {{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}}

Se houver Loja de referência Venia:

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

Uma vez que a url_path foi descontinuado, os formatos de URL de produto predefinidos usam o url_rewrites e escolha aquele com mais segmentos de caminho como alternativa se a variável url_path não está disponível.

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

Formato do URL da página de categoria product-list

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

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

Se houver Loja de referência Venia:

  • {{page}} é substituída por /content/venia/us/en/products/category-page
  • {{url_key}} é substituído pelo nome da url_key propriedade
  • {{url_path}} é substituído pelo nome da url_path

Com os dados de exemplo acima, uma URL de página de categoria formatada usando o formato de URL padrão se parece com /content/venia/us/en/products/category-page.html/venia-bottoms/venia-pants.html.

NOTE
A variável url_path é uma concatenação da variável url_keys dos ancestrais de um produto ou categoria e do produto ou categoria do url_key separado por / barra. Each url_key é considerado exclusivo em um determinado armazenamento.

Configuração específica do armazenamento store-specific-urlformats

Os formatos de URL de categoria e página do produto em todo o sistema definidos pelo Configuração do provedor de URL do CIF pode ser alterado para cada armazenamento.

Na Configuração do CIF, um editor pode selecionar um formato alternativo de URL da página do produto ou da categoria. Se nada for selecionado lá, a implementação voltará para a configuração do sistema geral.

A alteração do formato de URL de um site ativo pode ter um impacto negativo no tráfego orgânico do site. Consulte Práticas recomendadas abaixo e planeje com antecedência a alteração do formato do URL.

Formatos de URL na configuração do CIF

NOTE
A configuração específica do armazenamento dos formatos de URL requer Componentes principais do CIF 2.6.0 e a versão mais recente do complemento Adobe Experience Manager Content and Commerce.

URLs da página do produto com reconhecimento de categoria context-aware-pdps

Como é possível codificar informações de categoria em um URL de produto, os produtos que estão em várias categorias também podem ser endereçados com vários URLs de produto.

Os formatos de URL padrão selecionam uma das alternativas possíveis usando o seguinte esquema:

  • se a variável url_path é definido pelo back-end de comércio eletrônico usá-lo (desaprovado)
  • do url_rewrites usar os URLs que terminam com o do produto url_key como alternativas
  • a partir dessas alternativas, use aquele com mais segmentos de caminho
  • se houver vários, use o primeiro na ordem fornecida pelo back-end de comércio eletrônico

Este esquema seleciona o url_path com a maioria dos antecessores, com base no pressuposto de que uma categoria filho é mais específica do que sua categoria pai. O selecionado url_path é considerado canônico e é sempre usado como o link canônico nas páginas do produto ou no mapa de site do produto.

No entanto, quando um comprador navega de uma página de categoria para uma página de produto ou de uma página de produto para outra página de produto relacionada na mesma categoria, vale a pena manter o contexto de categoria atual. Neste caso, o url_path a seleção deve preferir alternativas que estejam dentro do contexto da categoria atual canônico seleção descrita acima.

Esse recurso deve ser ativado na variável Configuração do provedor de URL do CIF. Se ativada, a seleção pontua as alternativas como maiores, quando

  • elas correspondem a partes de uma determinada categoria url_path do início (correspondência de prefixos difusos)
  • ou eles correspondem a uma determinada categoria url_key em qualquer lugar (correspondência parcial exata)

Por exemplo, considere a resposta de um consulta de produtos abaixo. Considerando o seguinte:

  • o usuário está na página de categoria "Novos produtos / Novo no verão de 2022"
  • a loja usa o formato de URL da página de categoria padrão

A alternativa "new-products/new-in-summer-2022/gold-cirque-earrings.html" corresponde a dois segmentos de caminho do contexto desde o início. Ou seja, "novos produtos" e "novo no verão de 2022". Se a loja usar um formato de URL de página de categoria que contenha apenas a categoria url_key, a mesma alternativa ainda seria selecionada, pois corresponde à variável de contexto url_key em qualquer lugar. Em ambos os casos, o URL da página do produto é criado para o "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"
            }
          ]
        }
      ]
    }
  }
}
NOTE
Os URLs de produtos com reconhecimento de categoria exigem Componentes principais do CIF 2.6.0 ou mais recente.

Categoria específica e páginas de produto specific-pages

É possível criar várias categorias e páginas de produto apenas para um subconjunto específico de categorias ou produtos de um catálogo.

Critérios de seleção specific-pages-selection

A seleção de uma página de categoria específica é direta, com base no url_path ou url_key. Subcategorias correspondentes são suportadas apenas para formatos de URL que contenham a categoria completa url_path. Caso contrário, apenas uma correspondência exata do url_key é possível.

Páginas de produto específicas são selecionadas pelo SKU ou pela categoria do produto. Este último requer que algumas informações de categoria sejam codificadas no URL do produto. Essa funcionalidade só está disponível para alguns dos formatos de URL padrão. Consulte a tabela a seguir para obter uma comparação sobre qual formato de URL suporta uma seleção de página específica por SKU ou categoria.

Formato de URL
por SKU
por categoria
{{page}}.html/{{url_key}}.html
não
não
{{page}}.html/{{category}}/{{url_key}}.html
não
somente correspondência exata
{{page}}.html/{{url_path}}.html
não
sim
{{page}}.html/{{sku}}.html
sim
não
{{page}}.html/{{sku}}/{{url_key}}.html
sim
não
{{page}}.html/{{sku}}/{{category}}/{{url_key}}.html
sim
somente correspondência exata
{{page}}.html/{{sku}}/{{url_path}}.html
sim
sim
NOTE
A seleção de páginas de produtos específicas por categoria requer Componentes principais do CIF 2.6.0 ou mais recente.

Vinculação profunda specific-pages-deep-linking

A variável UrlProvider O é pré-configurado para gerar deep links para páginas de categoria e produto específicas nas instâncias do nível do autor. Essa capacidade é útil para editores que navegam em um site usando o modo de Visualização, navegam até uma página de produto ou categoria específica e voltam ao modo de Edição para editar a página.

Por outro lado, em instâncias do nível de publicação, os URLs de página de catálogo devem ser mantidos estáveis para não perder ganhos nas classificações do mecanismo de pesquisa, por exemplo. Devido a esse nível de publicação, as instâncias não renderizam deep links para páginas de catálogo específicas por padrão. Para alterar esse comportamento, a variável Estratégia de página específica do provedor de URL do CIF O pode ser configurado para sempre gerar URLs de página específicos.

Várias páginas do catálogo multiple-product-pages

Quando os editores desejam ter controle total da navegação de nível superior de um site, usar uma única página de catálogo para renderizar as categorias de nível superior de um catálogo pode não ser desejado. Em vez disso, os editores podem criar várias páginas de catálogo, uma para cada categoria do catálogo que desejam incluir na navegação de nível superior.

Para esse caso de uso, cada uma das páginas do catálogo pode ter uma referência a uma página de produto e categoria específica para a categoria configurada para a página do catálogo. A variável UrlProvider O usa essas conexões para criar links para as páginas e categorias na categoria configurada. No entanto, por motivos de desempenho, somente os filhos de página de catálogo direto da raiz de navegação/página de aterrissagem de um site são considerados.

É recomendável que as páginas de produto e categoria de uma página de catálogo sejam descendentes dessa página de catálogo, caso contrário, componentes como Navegação ou Navegação estrutural podem não funcionar corretamente.

NOTE
O suporte completo para várias páginas de catálogo requer Componentes principais do CIF 2.10.0 ou mais recente.

Personalizações customization

Formatos personalizados de URL custom-url-format

Para fornecer um formato de URL personalizado, um projeto pode implementar a variável ProductUrlFormat ou o CategoryUrlFormat e registre a implementação como um serviço OSGI. Essas implementações, se disponíveis, substituem o formato pré-definido configurado. Se houver várias implementações registradas, aquela com a classificação de serviço mais alta substituirá aquelas com a classificação de serviço mais baixa.

As implementações de formato de URL personalizado devem implementar um par de métodos para criar um URL a partir de determinados parâmetros e para analisar um URL para retornar os mesmos parâmetros, respectivamente.

Combinar com Mapeamentos do Sling sling-mapping

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

Combinar com o AEM Dispatcher dispatcher

As substituições de URL também podem ser obtidas usando o servidor HTTP do AEM Dispatcher com mod_rewrite módulo. 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.

Práticas recomendadas best-practices

Escolher o melhor formato de URL choose-url-format

Como mencionado antes de selecionar um dos formatos padrão disponíveis, ou mesmo implementar um formato personalizado, depende muito das necessidades e dos requisitos de uma loja. As sugestões a seguir podem ajudar a tomar uma decisão instruída.

Use um formato de URL da página do produto que contenha o SKU.

Os Componentes principais do CIF usam o SKU como identificador principal em todos os componentes. Se o formato do URL da página do produto não contiver o SKU, uma consulta do GraphQL será necessária para resolvê-lo. Essa resolução pode afetar o tempo até o primeiro byte. Além disso, pode ser desejável que os compradores possam encontrar produtos por SKU usando mecanismos de pesquisa.

Use um formato de URL da página do produto que contenha o contexto da categoria.

Alguns recursos do Provedor de URL do CIF só estão disponíveis ao usar formatos de URL de produto, que codificam o contexto da categoria, como a categoria url_key ou a categoria url_path. Mesmo que esses recursos não sejam necessários para uma nova loja, usar um desses formatos de URL no início ajuda a reduzir os esforços de migração no futuro.

Equilíbrio entre comprimento do URL e informações codificadas.

Dependendo do tamanho do catálogo, em particular o tamanho e a profundidade da árvore de categoria, pode não ser razoável codificar o inteiro url_path de categorias no URL. Nesse caso, o comprimento do URL poderia ser reduzido incluindo somente o da categoria url_key em vez disso. Este método aceita a maioria dos recursos disponíveis ao usar a categoria url_path.

Além disso, use Mapeamentos do Sling para combinar o SKU com o produto url_key. Na maioria dos sistemas de comércio eletrônico, o SKU segue um formato específico e separa o SKU do url_key para solicitações recebidas deve ser facilmente possível. Com isso em mente, deve ser possível reescrever o URL de uma página de produto para /p/{{category}}/{{sku}}-{{url_key}}.htmle um URL de categoria para /c/{{url_key}}.html respectivamente. A variável /p e /c Os prefixos ainda são necessários para distinguir as páginas de produto e categoria de outras páginas de conteúdo.

Migração para um novo formato de URL migrate-url-formats

Muitos dos formatos de URL padrão são de alguma forma compatíveis entre si, o que significa que os URLs formatados por um podem ser analisados por outro. Isso ajuda a migrar entre formatos de URL.

Por outro lado, os mecanismos de pesquisa precisam de tempo para rastrear novamente todas as páginas do catálogo com o novo formato de URL. Para dar suporte a esse processo e também melhorar a experiência do usuário final, é recomendável fornecer redirecionamentos que encaminham o usuário dos URLs antigos para os novos.

Uma abordagem para isso pode ser, conectar um ambiente de preparo ao back-end de comércio eletrônico de produção e configurá-lo para usar o novo formato de URL. Posteriormente, obtenha a mapa de site do produto gerado pelo gerador de mapa de site de produtos CIF para o ambiente de preparo e produção, e usá-los para criar uma Mapa de reescrita do Apache httpd. Esse mapa de regravação pode ser implantado no Dispatcher junto com a implantação do novo formato de URL.

Exemplo example

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. Essa configuração permite que cada projeto defina 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.

NOTE
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 o mapeamento Sling hostname.adobeaemcloud.com pasta em ui.content/src/main/content/jcr_root/etc/map.publish/https de acordo com o nome de domínio usado e habilite essa configuração adicionando resource.resolver.map.location="/etc/map.publish" para o JcrResourceResolver configuração do projeto.

Recursos adicionais additional

recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab