Configurazioni URL avanzate

I componenti core CIF di AEM forniscono configurazioni avanzate per personalizzare gli URL per le pagine di prodotti e categorie. Molte implementazioni personalizzano questi URL 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 in base ai requisiti e alle esigenze SEO (Search Engine Optimization), un progetto deve fornire una configurazione OSGI per Configurazione provider URL CIF.

Formato URL pagina prodotto

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}}

Se è presente Venia Reference Store:

• {{page}} è sostituito da /content/venia/us/en/products/product-page
• {{sku}} è sostituito dalla SKU del prodotto, ad esempio VP09
• {{url_key}} è sostituito da url_key proprietà, ad esempio lenora-crochet-shorts
• {{url_path}} è sostituito da url_pathad esempio: venia-bottoms/venia-pants/lenora-crochet-shorts
• {{variant_sku}} viene 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 ha l’aspetto di /content/venia/us/en/products/product-page.html/VP09.html#VP09-KH-S.

Formato URL pagina categoria

Configura gli URL delle pagine contenenti le categorie o gli elenchi di prodotti e supporta le seguenti opzioni:

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

Se è presente Venia Reference Store:

• {{page}} è sostituito da /content/venia/us/en/products/category-page
• {{url_key}} è sostituito da quello della categoria url_key proprietà
• {{url_path}} è sostituito da quello della categoria url_path

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

Configurazione specifica per lo store

I 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 torna alla 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 Best practice di seguito e pianifica attentamente la modifica del formato dell’URL in anticipo.

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 selezionano 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 seleziona url_path con il maggior numero di predecessori, in base al presupposto che una categoria figlio sia più specifica della categoria padre. Il valore selezionato url_path è considerato canonico e viene sempre utilizzato 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 in Configurazione provider URL CIF. Se l’opzione è abilitata, le alternative per i punteggi di selezione saranno più elevate 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. Considerato quanto segue:

• l’utente si trova sulla pagina della categoria "Nuovi prodotti/Novità dell’estate 2022"
• lo store utilizza il formato URL predefinito per la pagina della categoria

L’alternativa "new-products/new-in-summer-2022/gold-cirque-earrings.html" corrisponde a due dei segmenti di percorso del contesto dall’inizio. Ovvero, "new-products" e "new-in-summer-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"
            }
          ]
        }
      ]
    }
  }
}

Categorie specifiche e pagine di prodotti

È possibile creare pagine di prodotti e categorie multiple 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 vengono selezionate in base alla SKU o alla categoria del prodotto. Quest’ultimo richiede che alcune informazioni sulla categoria siano codificate nell’URL del prodotto. Questa funzionalità è disponibile solo per alcuni dei formati URL predefiniti. Vedi la tabella seguente per un confronto tra i formati URL che supportano la selezione di pagine specifiche per SKU o categoria.

Collegamenti profondi

Il UrlProvider è preconfigurato per generare collegamenti profondi a specifiche pagine di prodotti e categorie sulle istanze del livello di authoring. Questa funzionalità è utile per gli editor che navigano in un sito utilizzando la modalità Anteprima, che visitano una pagina di prodotto o categoria specifica e che tornano 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. A causa di questo livello di pubblicazione, per impostazione predefinita le istanze non eseguono 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 utilizza queste connessioni 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.

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, sostituiscono il formato configurato e predefinito. Se sono registrate più implementazioni, quella con la classificazione di servizio più alta sostituisce quelle 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 al UrlProvider, è anche possibile configurare Mappature Sling per riscrivere ed elaborare gli URL. Il progetto Archetipo AEM fornisce anche un esempio di configurazione per configurare alcune 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 prendere una decisione ponderata.

​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. Questa risoluzione può influire sul tempo al primo byte. Inoltre, può essere necessario che gli acquirenti possano trovare i prodotti per SKU utilizzando i 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. Questo metodo 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 dal url_key per le richieste in entrata dovrebbe essere facilmente possibile. Tenendo presente questo aspetto, 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 utente possono essere analizzati da un altro. Questo facilita la migrazione tra i formati URL.

D’altra parte, i motori di ricerca hanno bisogno 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ò quindi 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. Questa configurazione 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.

Risorse aggiuntive

• Venia Reference Store
• Mappature delle risorse di AEM
• Mappature Sling

Risorse Business.Adobe.com