Configurazioni URL avanzate

NOTA

L’ottimizzazione SEO (Search Engine Optimization) è diventato un aspetto cruciale per molti esperti marketing. È quindi necessario affrontare questo tipo di ottimizzazione in numerosi progetti Adobe Experience Manager (AEM) as a Cloud Service. Leggere Best practice per la gestione di SEO e URL per ulteriori informazioni.

I componenti core CIF di AEM forniscono configurazioni avanzate per personalizzare gli URL per le pagine di prodotti e categorie. Per molte implementazioni questi URL devono essere personalizzati a scopo di SEO (Search Engine Optimization). Nei seguenti video viene descritto come configurare il servizio UrlProvider e le funzioni di mappatura Sling per personalizzare gli URL delle pagine di prodotti e categorie.

Configurazione

Per configurare UrlProvider secondo i requisiti e le esigenze SEO (Search Engine Optimization), un progetto deve fornire una configurazione OSGI per Configurazione provider URL CIF.

NOTA

A partire dalla versione 2.0.0 dei componenti core CIF dell’AEM, la configurazione del provider URL fornisce solo formati URL predefiniti, invece dei formati configurabili a testo libero noti dalle versioni 1.x. Inoltre, l’utilizzo dei selettori per trasmettere i dati negli URL è stato sostituito dai suffissi.

Formato URL pagina prodotto

Questo configura gli URL delle pagine dei prodotti e supporta le seguenti opzioni:

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

Nel caso di Venia Reference Store:

  • {{page}} sarà sostituito da /content/venia/us/en/products/product-page
  • {{sku}} verrà sostituito dallo SKU del prodotto, ad esempio, VP09
  • {{url_key}} verrà sostituito da quello del url_key proprietà, ad esempio lenora-crochet-shorts
  • {{url_path}} verrà sostituito da quello del url_pathad esempio: venia-bottoms/venia-pants/lenora-crochet-shorts
  • {{variant_sku}} verrà sostituito dalla variante attualmente selezionata, ad esempio, VP09-KH-S

Poiché il url_path diventati obsoleti, i formati URL di prodotto predefiniti utilizzano i url_rewrites e scegliete quello con il maggior numero di segmenti di tracciato come alternativa se url_path non è disponibile.

Con i dati dell’esempio precedente, l’URL di una variante di prodotto formattato con il formato URL predefinito avrà l’aspetto di /content/venia/us/en/products/product-page.html/VP09.html#VP09-KH-S.

Formato URL pagina categoria

In questo modo vengono configurati gli URL delle pagine delle categorie o degli elenchi di prodotti e sono supportate le seguenti opzioni:

  • {{page}}.html/{{url_path}}.html (impostazione predefinita)
  • {{page}}.html/{{url_key}}.html

Nel caso di Venia Reference Store:

  • {{page}} sarà sostituito da /content/venia/us/en/products/category-page
  • {{url_key}} verranno sostituite da quelle della categoria url_key proprietà
  • {{url_path}} verranno sostituite da quelle della categoria url_path

Con i dati dell’esempio precedente, l’URL di una pagina categoria formattato con il formato URL predefinito avrà l’aspetto di /content/venia/us/en/products/category-page.html/venia-bottoms/venia-pants.html.

NOTA

Il url_path è una concatenazione del url_keys dei predecessori di un prodotto o di una categoria e del prodotto o della categoria url_key separato da / barra. Ogni url_key è considerato univoco all’interno di un dato archivio.

Configurazione specifica archivio

Formati URL per categoria e pagina di prodotto a livello di sistema impostati da Configurazione provider URL CIF può essere modificato per ogni negozio.

Nella configurazione CIF, un editor può selezionare un formato URL alternativo per la pagina di un prodotto o di una categoria. Se non viene selezionato nulla, l’implementazione utilizzerà come fallback la configurazione a livello di sistema.

La modifica del formato URL di un sito web live potrebbe avere un impatto negativo sul traffico organico del sito. Consulta la sezione Best practice di seguito e pianifica attentamente la modifica del formato dell’URL in anticipo.

Formati URL nella configurazione CIF

NOTA

La configurazione specifica dell’archivio dei formati URL richiede Componenti core CIF 2.6.0 e la versione più recente del componente aggiuntivo Adobe Experience Manager Content and Commerce.

URL delle pagine dei prodotti in base alla categoria

Poiché è possibile codificare le informazioni di categoria in un URL di prodotto, i prodotti che si trovano in più categorie possono essere indirizzati anche con più URL di prodotto.

I formati URL predefiniti selezioneranno una delle possibili alternative utilizzando lo schema seguente:

  • se url_path è definito dal back-end di e-commerce use it (obsoleto)
  • dal url_rewrites utilizza gli URL che terminano con il url_key come alternative
  • da queste alternative utilizza quella con il maggior numero di segmenti di percorso
  • se esistono più, prendi il primo nell’ordine dato dal backend di e-commerce

Questo schema selezionerà il url_path con il maggior numero di predecessori, in base al presupposto che una categoria figlio sia più specifica della categoria padre. Il così selezionato url_path è considerato canonico e verranno sempre utilizzati come collegamento canonico nelle pagine dei prodotti o nella sitemap del prodotto.

Tuttavia, quando un acquirente passa da una pagina di categoria a una pagina di prodotto o da una pagina di prodotto a un’altra pagina di prodotto correlata nella stessa categoria, vale la pena mantenere il contesto di categoria corrente. In questo caso, il url_path la selezione deve preferire alternative che si trovano nel contesto della categoria corrente rispetto alla canonico selezione descritta in precedenza.

Questa funzione deve essere abilitata nella Configurazione provider URL CIF. Se abilitata, la selezione assegnerà un punteggio più alto alle alternative, quando

  • corrispondono a parti di una determinata categoria url_path dall’inizio (corrispondenza del prefisso fuzzy)
  • oppure corrispondono a quelli di una determinata categoria url_key ovunque (corrispondenza parziale esatta)

Ad esempio, considera la risposta per un query prodotti di seguito. Dato che l’utente si trova sulla pagina della categoria "Nuovi prodotti/Novità dell’estate 2022" e che lo store utilizza il formato URL predefinito per la pagina della categoria, l’alternativa "new-products/new-in-summer-2022/gold-cirque-earrings.html" corrisponderebbe a 2 segmenti del percorso del contesto dall’inizio: "nuovi prodotti" e "nuovi dell’estate 2022". Se lo store utilizza un formato URL per pagina categoria che contiene solo la categoria url_key, la stessa alternativa verrebbe comunque selezionata in quanto corrisponde a url_key ovunque. In entrambi i casi, l’URL della pagina del prodotto viene creato per "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"
            }
          ]
        }
      ]
    }
  }
}
NOTA

Gli URL dei prodotti in base alla categoria richiedono Componenti core CIF 2.6.0 o più recenti.

Categorie specifiche e pagine di prodotti

È possibile creare più pagine di prodotti e categorie solo per un sottoinsieme specifico di categorie o prodotti di un catalogo.

Criteri di selezione

La selezione di una pagina di categoria specifica è diretta, in base al url_path o url_key. La corrispondenza delle sottocategorie è supportata solo per i formati URL che contengono la categoria completa url_path. In caso contrario, solo una corrispondenza esatta url_key è possibile.

Le pagine di prodotto specifiche sono selezionate dallo SKU o dalla categoria del prodotto. Quest’ultimo richiede che alcune informazioni sulla categoria siano codificate nell’URL del prodotto. Questa opzione è disponibile solo per alcuni dei formati URL predefiniti. Consulta la tabella seguente per un confronto tra i formati URL che supportano la selezione di pagine specifiche per SKU o categoria.

Formato URL da sku per categoria
{{page}}.html/{{url_key}}.html no no
{{page}}.html/{{category}}/{{url_key}}.html no solo corrispondenza esatta
{{page}}.html/{{url_path}}.html no
{{page}}.html/{{sku}}.html no
{{page}}.html/{{sku}}/{{url_key}}.html no
{{page}}.html/{{sku}}/{{category}}/{{url_key}}.html solo corrispondenza esatta
{{page}}.html/{{sku}}/{{url_path}}.html
NOTA

La selezione di pagine di prodotti specifiche per categoria richiede Componenti core CIF 2.6.0 o più recenti.

Collegamenti profondi

Il UrlProvider è preconfigurato per generare collegamenti profondi a specifiche pagine di prodotti e categorie sulle istanze del livello di authoring. Questa funzione è utile per gli editor che navigano in un sito utilizzando la modalità Anteprima, per passare a una pagina di prodotto o categoria specifica e tornare alla modalità Modifica per modificare la pagina.

Nelle istanze a livello di pubblicazione, invece, gli URL delle pagine del catalogo devono essere mantenuti stabili per non perdere i guadagni, ad esempio, nella classificazione dei motori di ricerca. Per questo motivo, per impostazione predefinita, le istanze del livello di pubblicazione non eseguiranno il rendering dei collegamenti profondi a pagine di catalogo specifiche. Per modificare questo comportamento, Strategia pagina specifica del provider URL CIF può essere configurato in modo da generare sempre URL di pagina specifici.

Più pagine catalogo

Quando gli editor desiderano avere il controllo completo della navigazione di livello superiore di un sito, l’utilizzo di una singola pagina di catalogo per il rendering delle categorie di livello superiore di un catalogo potrebbe non essere desiderato. Gli editor possono invece creare più pagine di catalogo, una per ogni categoria del catalogo che desiderano includere nella navigazione di livello superiore.

Per questo caso d’uso, ogni pagina di catalogo può avere un riferimento a una pagina di prodotto e di categoria specifica per la categoria configurata per la pagina di catalogo. Il UrlProvider utilizzerà questi per creare collegamenti per le pagine e le categorie nella categoria configurata. Tuttavia, per motivi di prestazioni, vengono considerati solo gli elementi secondari della pagina di catalogo diretto della directory principale di navigazione/pagina di destinazione di un sito.

È consigliabile che le pagine di prodotti e categorie di una pagina di catalogo siano discendenti di tale pagina, altrimenti i componenti come Navigazione o Breadcrumb potrebbero non funzionare correttamente.

NOTA

Il supporto completo per più pagine di catalogo richiede Componenti core CIF 2.10.0 o più recenti.

Personalizzazioni

Formati URL personalizzati

Per fornire un formato URL personalizzato, un progetto può implementare ProductUrlFormat o CategoryUrlFormat e registra l’implementazione come servizio OSGI. Queste implementazioni, se disponibili, sostituiranno il formato configurato e predefinito. Se sono registrate più implementazioni, quella con la classificazione di servizio più alta sostituisce quella con la classificazione di servizio più bassa.

Le implementazioni del formato URL personalizzato devono implementare una coppia di metodi per generare un URL dai parametri forniti e per analizzare un URL rispettivamente per restituire gli stessi parametri.

Combinare con mappature Sling

Oltre a UrlProvider, è anche possibile configurare mappature Sling per riscrivere ed elaborare gli URL. Il progetto AEM Archetype fornisce anche una configurazione esemplificativa per configurare mappature Sling per le porte 4503 (pubblicazione) e 80 (dispatcher).

Combinare con AEM Dispatcher

Le riscritture URL possono essere ottenute anche utilizzando il server HTTP di Dispatcher dell’AEM con mod_rewrite modulo. AEM Project Archetype fornisce una configurazione di AEM Dispatcher di riferimento che include regole di riscrittura di base per la dimensione generata.

Best practice

Scegli il formato URL migliore

Come accennato prima di selezionare uno dei formati predefiniti disponibili, o anche l'implementazione di un formato personalizzato, altamente dipende dalle esigenze e requisiti di un negozio. I seguenti suggerimenti possono essere utili per una descrizione accurata.

Utilizza un formato URL per pagina di prodotto contenente lo SKU.

I componenti core CIF utilizzano lo SKU come identificatore primario in tutti i componenti. Se il formato dell’URL della pagina di prodotto non contiene lo SKU, è necessaria una query GraphQL per risolverlo. Questo può influire sul tempo al primo byte. Inoltre, può essere desiderato, che gli acquirenti possono trovare i prodotti da sku utilizzando motori di ricerca.

Utilizza un formato URL per pagina di prodotto che contenga il contesto della categoria.

Alcune funzioni del provider URL CIF sono disponibili solo quando si utilizzano i formati URL del prodotto, che codificano il contesto della categoria, come la categoria url_key o la categoria url_path. Anche se queste funzioni non sono necessarie per un nuovo archivio, l’utilizzo iniziale di uno di questi formati URL contribuisce a ridurre le attività di migrazione in futuro.

Equilibrio tra la lunghezza dell’URL e le informazioni codificate.

A seconda delle dimensioni del catalogo, in particolare le dimensioni e la profondità dell'albero delle categorie, potrebbe non essere ragionevole codificare l'intero url_path delle categorie nell’URL. In tal caso, la lunghezza dell’URL può essere ridotta includendo solo i url_key invece. Questa opzione supporta la maggior parte delle funzioni disponibili quando si utilizza la categoria url_path.

Inoltre, utilizza Mappature Sling per combinare lo sku con il prodotto url_key. Nella maggior parte dei sistemi di e-commerce lo SKU segue un particolare formato e separa lo SKU dallo url_key per le richieste in arrivo dovrebbe essere facilmente possibile. In quest’ottica, dovrebbe essere possibile riscrivere l’URL di una pagina di prodotto in /p/{{category}}/{{sku}}-{{url_key}}.htmle un URL di categoria a /c/{{url_key}}.html rispettivamente. Il /p e /c Il prefisso è ancora necessario per distinguere le pagine di prodotti e categorie da altre pagine di contenuti.

Migrazione a un nuovo formato URL

Molti dei formati URL predefiniti sono in qualche modo compatibili tra loro, il che significa che gli URL formattati da un possono essere analizzati da un altro. Questo facilita la migrazione tra i formati URL.

D’altra parte, i motori di ricerca avranno bisogno di un po’ di tempo per eseguire nuovamente la ricerca per indicizzazione di tutte le pagine del catalogo con il nuovo formato URL. Per supportare questo processo e anche per migliorare l’esperienza dell’utente finale, si consiglia di fornire reindirizzamenti che inoltrino l’utente dai vecchi URL a quelli nuovi.

Un approccio per farlo potrebbe essere quello di collegare un ambiente di staging al backend di e-commerce di produzione e configurarlo per utilizzare il nuovo formato URL. In seguito ottieni il mappa del sito del prodotto generata dal generatore di sitemap di prodotti CIF sia per l'ambiente di stage che per quello di produzione, e utilizzarli per creare un Mappa di riscrittura httpd Apache. Questa mappa di riscrittura può invece essere distribuita a Dispatcher insieme al rollout del nuovo formato URL.

Esempio

Il progetto Venia Reference Store include configurazioni esemplificative che mostrano come usare URL personalizzati per le pagine di prodotti e categorie. Questo consente a ciascun progetto di impostare pattern di URL individuali per le pagine di prodotti e categorie in base alle proprie esigenze SEO (Search Engine Optimization). Si utilizza una combinazione di UrlProvider CIF e di mappature Sling, come descritto sopra.

NOTA

Questa configurazione deve essere regolata con il dominio esterno utilizzato dal progetto. Le mappature Sling funzionano in base al nome host e al dominio. Pertanto questa configurazione è disabilitata per impostazione predefinita e deve essere abilitata prima della distribuzione. Per eseguire questa operazione, rinomina la cartella delle mappature Sling da hostname.adobeaemcloud.com a ui.content/src/main/content/jcr_root/etc/map.publish/https in base al nome di dominio utilizzato e abilita questa configurazione aggiungendo resource.resolver.map.location="/etc/map.publish" alla configurazione JcrResourceResolver del progetto.

Risorse aggiuntive

In questa pagina