Erweiterte URL-Konfigurationen

Die AEM-CIF-Kernkomponenten ermöglichen erweiterte Konfigurationen zum Anpassen der URLs für Produkt- und Kategorieseiten. Viele Implementierungen passen diese URLs für die Suchmaschinenoptimierung (SEO) an. Im folgenden Video wird beschrieben, wie Sie den UrlProvider-Service und die Funktionen der Sling-Zuordnung konfigurieren können, um die URLs für Produkt- und Kategorieseiten anzupassen.

Konfiguration

Um den UrlProvider-Service entsprechend den SEO-Anforderungen und -Bedürfnissen konfigurieren zu können, muss ein Projekt eine OSGI-Konfiguration für die CIF URL Provider-Konfiguration bereitstellen.

URL-Format von Produktseiten

Dies konfiguriert die URLs der Produktseiten und unterstützt die folgenden Optionen:

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

Im Fall des Venia Referenz-Shops:

• {{page}} wird durch /content/venia/us/en/products/product-page ersetzt
• {{sku}} wird durch die Produkt-SKU ersetzt, z. B. VP09
• {{url_key}} wird durch die url_key-Eigenschaft des Produkts ersetzt, z. B. lenora-crochet-shorts
• {{url_path}} wird durch den url_path des Produkts ersetzt, z. B. venia-bottoms/venia-pants/lenora-crochet-shorts
• {{variant_sku}} wird durch die aktuell ausgewählte Variante ersetzt, z. B. VP09-KH-S

Da der url_path veraltet ist, verwenden die vordefinierten Formate für Produkt-URLs die url_rewrites eines Produkts und wählen unter ihnen das Format mit den meisten Pfadsegmenten als Alternative, wenn der url_path nicht verfügbar ist.

Mit den obigen Beispieldaten sieht eine mit dem Standard-URL-Format formatierte Produktvarianten-URL wie /content/venia/us/en/products/product-page.html/VP09.html#VP09-KH-S aus.

URL-Format von Kategorieseiten

Dies konfiguriert die URLs der Kategorieseiten und unterstützt die folgenden Optionen:

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

Im Fall des Venia Referenz-Shops:

• {{page}} wird durch /content/venia/us/en/products/category-page ersetzt
• {{url_key}} wird durch die url_key-Eigenschaft der Kategorie ersetzt
• {{url_path}} wird durch den url_path der Kategorie ersetzt

Mit den obigen Beispieldaten sieht eine Kategorieseiten-URL, die mit dem Standard-URL-Format formatiert ist, wie /content/venia/us/en/products/category-page.html/venia-bottoms/venia-pants.html aus.

Store-spezifische Konfiguration

Die systemweiten URL-Formate für Kategorien und Produktseiten, die in der CIF-URL-Provider-Konfiguration festgelegt sind, können für jeden Shop geändert werden.

In der CIF-Konfiguration kann ein Editor ein alternatives URL-Format für Produkt- oder Kategorieseiten auswählen. Wenn dort nichts ausgewählt ist, wird bei der Implementierung auf die systemweite Konfiguration zurückgegriffen.

Eine Änderung des URL-Formats einer Live-Website kann sich negativ auf den organischen Traffic Ihrer Site auswirken. Bitte beachten Sie die Best Practices unten und planen Sie die Änderung des URL-Formats sorgfältig im Voraus.

Kategoriesensitive Produktseiten-URLs

Da Kategorieinformationen in einer Produkt-URL codiert werden können, können Produkte, die sich in mehreren Kategorien befinden, auch durch mehrere Produkt-URLs adressiert werden.

Die Standard-URL-Formate wählen eine der möglichen Alternativen nach dem folgenden Schema aus:

• wenn der url_path durch das E-Commerce-Backend definiert wird, wird dieser verwendet (nicht mehr unterstützt)
• von den url_rewrites werden diejenigen URLs, die mit dem url_key des Produkts enden, als Alternativen verwendet
• von diesen Alternativen wird die mit den meisten Pfadsegmenten verwendet
• wenn mehrere vorhanden sind, wird die erste in der Reihenfolge genommen, die vom E-Commerce-Backend angegeben wird.

Durch dieses Schema wird der url_path mit den meisten Vorgängern ausgewählt, basierend auf der Annahme, dass eine untergeordnete Kategorie spezifischer ist als ihre übergeordnete Kategorie. Der so ausgewählte url_path gilt als kanonisch und wird immer für den kanonischen Link auf Produktseiten oder in der Produkt-Sitemap verwendet.

Wenn ein Käufer jedoch von einer Kategorieseite zu einer Produktseite oder von einer Produktseite zu einer anderen zugehörigen Produktseite in derselben Kategorie navigiert, empfiehlt es sich, den aktuellen Kategoriekontext beizubehalten. In diesem Fall sollte die Auswahl des url_path Alternativen, die innerhalb des aktuellen Kategoriekontextes liegen, anstelle der oben beschriebenen kanonischen Auswahl bevorzugen.

Diese Funktion muss in der CIF-URL-Provider-Konfiguration aktiviert werden. Wenn die Auswahl aktiviert ist, werden Alternativen höher bewertet, wenn

• sie mit Teilen des url_path einer bestimmten Kategorie von Anfang an übereinstimmen (unscharfer Präfixabgleich)
• oder sie mit dem url_key einer bestimmten Kategorie an beliebiger Stelle (exakter Teilabgleich) übereinstimmen.

Betrachten Sie beispielsweise die Antwort für eine Produktabfrage unten. Wenn sich der Benutzer auf der Kategorieseite „Neue Produkte / Neu im Sommer 2022“ befindet und der Store das standardmäßige URL-Format für die Kategorieseite verwendet, würde die Alternative „new-products/new-in-summer-2022/gold-cirque-earrings.html“ zweien der Pfadsegmente des Kontexts von Anfang an entsprechen, nämlich „new-products“ und „new-in-summer-2022“. Wenn der Store ein URL-Format für Kategorieseiten verwendet, das nur den url_key der Kategorie enthält, wird dieselbe Alternative weiterhin ausgewählt, da sie überall zum url_key passt. In beiden Fällen wird die URL der Produktseite mit dem url_path „new-products/new-in-summer-2022/gold-cirque-earrings.html“ erstellt.

{
  "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"
            }
          ]
        }
      ]
    }
  }
}

Spezifische Kategorie- und Produktseiten

Es ist möglich, mehrere Kategorie- und Produktseiten für nur eine bestimmte Untermenge von Kategorien oder Produkten eines Katalogs zu erstellen.

Auswahlkriterien

Die Auswahl einer bestimmten Kategorieseite versteht sich von selbst, basierend auf dem url_path oder url_key der Kategorie. Die Abgleichung für Unterkategorien wird nur für URL-Formate unterstützt, die den vollständigen url_path der Kategorie enthalten. Andernfalls ist nur eine exakte Übereinstimmung mit dem url_key möglich.

Spezifische Produktseiten werden entweder nach Produktnummer oder nach Kategorie des Produkts ausgewählt. Für die letztere müssen bestimmte Kategorieinformationen in der Produkt-URL codiert werden. Dies ist nur für einige der standardmäßigen URL-Formate verfügbar. In der folgenden Tabelle finden Sie einen Vergleich, welches URL-Format die spezifische Seitenauswahl nach Produktnummer oder Kategorie unterstützt.

Tiefe Verknüpfung

UrlProvider ist vorkonfiguriert, um Deep-Links zu bestimmten Kategorie- und Produktseiten in Instanzen der Autorenebene zu erzeugen. Dies ist für Editoren nützlich, die eine Site im Vorschaumodus durchsuchen, zu einer bestimmten Produkt- oder Kategorieseite navigieren und zurück in den Bearbeitungsmodus wechseln, um die Seite zu bearbeiten.

Auf Instanzen der Veröffentlichungsebene hingegen sollten Katalogseiten-URLs stabil bleiben, um beispielsweise Verbesserungen bei Suchmaschinen-Rankings nicht zu verlieren. Deshalb rendern Instanzen der Veröffentlichungsebene standardmäßig keine Deep-Links von bestimmten Katalogseiten. Um dieses Verhalten zu ändern, kann die Variable für die spezifische Seitenstrategie des CIF-URL-Providers so konfiguriert werden, dass immer bestimmte Seiten-URLs erzeugt werden.

Mehrere Katalogseiten

Wenn Editoren die vollständige Kontrolle über die Navigation einer Site auf oberster Ebene haben möchten, ist die Verwendung einer einzelnen Katalogseite zum Rendern der Kategorien auf oberster Ebene eines Katalogs möglicherweise nicht wünschenswert. Stattdessen können Editoren mehrere Katalogseiten erstellen, nämlich eine für jede Kategorie des Katalogs, die sie in die Navigation auf oberster Ebene aufnehmen möchten.

Für diesen Anwendungsfall kann jede Katalogseite einen Verweis auf eine Produkt- und Kategorieseite haben, die für die für die Katalogseite konfigurierte Kategorie spezifisch ist. Die UrlProvider verwendet diese zum Erstellen von Links für die Seiten und Kategorien in der konfigurierten Kategorie. Aus Leistungsgründen werden jedoch nur die direkt untergeordneten Katalogseiten des Navigationsstamms/der Landingpage einer Site berücksichtigt.

Es wird empfohlen, dass die Produkt- und Kategorieseiten einer Katalogseite dieser Katalogseite untergeordnet sind. Andernfalls funktionieren Komponenten wie die Navigation oder Breadcrumb möglicherweise nicht ordnungsgemäß.

Anpassungen

Benutzerdefinierte URL-Formate

Um ein benutzerdefiniertes URL-Format bereitzustellen, kann ein Projekt die Service-Schnittstelle ProductUrlFormat oder CategoryUrlFormat implementieren und die Implementierung als OSGi-Service registrieren. Diese Implementierungen ersetzen das konfigurierte, vordefinierte Format, sofern verfügbar. Wenn mehrere Implementierungen registriert sind, ersetzt die Implementierung mit dem höheren Serviceranking die Implementierung(en) mit dem niedrigeren Serviceranking.

Die Implementierungen des benutzerdefinierten URL-Formats müssen ein Methodenpaar implementieren, um eine URL aus den angegebenen Parametern zu erstellen bzw. eine URL zu analysieren, um dieselben Parameter zurückzugeben.

Kombinieren mit Sling-Zuordnungen

Neben UrlProvider können auch Sling-Zuordnungen konfiguriert werden, um URLs neu zu schreiben und zu verarbeiten. Das AEM-Archetyp-Projekt bietet außerdem eine Beispielkonfiguration zum Konfigurieren einiger Sling-Zuordnungen für Port 4503 (Veröffentlichungsinstanz) und Port 80 (Dispatcher).

Kombinieren mit AEM Dispatcher

URL-Neuschreibungen können auch mithilfe des AEM Dispatcher-HTTP-Servers mit dem Modul mod_rewrite erreicht werden. Der AEM-Projektarchetyp stellt eine AEM Dispatcher-Referenzkonfiguration bereit, die bereits grundlegende Neuschreibungsregeln für die generierte Größe enthält.

Best Practices

Auswählen des besten URL-Formats

Wie bereits erwähnt, hängt die Auswahl eines der verfügbaren Standardformate oder sogar die Implementierung eines benutzerdefinierten Formats stark von den Bedürfnissen und Anforderungen eines Stores ab. Die folgenden Vorschläge können dabei helfen, eine fundierte Entscheidung zu treffen.

Verwenden Sie ein URL-Format für die Produktseite, das die SKU enthält.

Die CIF-Kernkomponenten verwenden die SKU als primäre Kennung in allen Komponenten. Wenn das URL-Format der Produktseite die SKU nicht enthält, ist eine GraphQL-Abfrage erforderlich, um sie aufzulösen. Dies kann sich auf die Time to First Byte auswirken. Es kann auch gewünscht sein, dass Käufer Produkte nach SKU mithilfe von Suchmaschinen finden können.

Verwenden Sie ein URL-Format für die Produktseite, das den Kategoriekontext enthält.

Einige Funktionen des CIF-URL-Providers sind nur verfügbar, wenn Produkt-URL-Formate verwendet werden, die den Kategoriekontext kodieren, z. B. den Kategorie-url_key oder den Kategorie-url_path. Auch wenn diese Funktionen für einen neuen Store möglicherweise nicht erforderlich sind, trägt die Verwendung eines dieser URL-Formate zu Beginn dazu bei, den Migrationsaufwand in Zukunft zu reduzieren.

Schaffen Sie ein Gleichgewicht zwischen URL-Länge und kodierten Informationen.

Je nach Kataloggröße, insbesondere Größe und Tiefe der Kategoriestruktur, ist es möglicherweise nicht sinnvoll, url_path mit den Kategorien in der URL vollständig zu kodieren. In diesem Fall kann die URL-Länge durch Einbeziehen des Kategorie-url_key reduziert werden. Dadurch werden fast alle Funktionen unterstützt, die bei Verwendung des url_path der Kategorie verfügbar sind.

Nutzen Sie außerdem Sling-Zuordnungen, um die SKU mit url_key des Produkts zu kombinieren. In den meisten E-Commerce-Systemen folgt die SKU einem bestimmten Format und das Trennen von SKU und url_key sollte für eingehende Anfragen leicht möglich sein. Vor diesem Hintergrund sollte es möglich sein, eine Produktseiten-URL als /p/{{category}}/{{sku}}-{{url_key}}.html bzw. eine Kategorie-URL als /c/{{url_key}}.html neu zu schreiben. Die Präfixe /p und /c sind weiterhin erforderlich, um Produkt- und Kategorieseiten von anderen Inhaltsseiten zu unterscheiden.

Migration zu einem neuen URL-Format

Viele der standardmäßigen URL-Formate sind in gewisser Weise miteinander kompatibel, d. h. URLs, die in einem der Formate erstellt wurden, können von einem anderen interpretiert werden. Dies hilft bei der Migration zwischen URL-Formaten.

Andererseits benötigen Suchmaschinen etwas Zeit, um alle Katalogseiten mit dem neuen URL-Format erneut zu durchsuchen. Um diesen Prozess zu unterstützen und auch das Endbenutzererlebnis zu verbessern, wird empfohlen, Umleitungen bereitzustellen, die den Benutzer von den alten URLs an die neuen weiterleiten.

Ein Ansatz dafür wäre, eine Staging-Umgebung mit dem E-Commerce-Backend der Produktion zu verbinden und sie so zu konfigurieren, dass sie das neue URL-Format verwendet. Beschaffen Sie sich anschließend die Produkt-Sitemap, die von dem CIF-Produkt-Sitemap-Generator erzeugt wird, sowohl für die Staging- als auch für die Produktionsumgebung und verwenden Sie sie zum Erstellen einer Apache-HTTPD-Umschreibungszuordnung. Diese Umschreibungszuordnung kann zusammen mit dem Rollout des neuen URL-Formats für den Dispatcher bereitgestellt werden.

Beispiel

Das Projekt Venia-Referenz-Storefront enthält Beispielkonfigurationen, um die Verwendung benutzerdefinierter URLs für Produkt- und Kategorienseiten zu demonstrieren. So können für jedes Projekt individuelle URL-Strukturen für Produkt- und Kategorieseiten entsprechend den SEO-Anforderungen eingerichtet werden. Es wird eine Kombination aus CIF-UrlProvider und Sling-Zuordnungen verwendet, wie oben beschrieben.

Zusätzliche Ressourcen

• Venia-Referenz-Storefront
• AEM-Ressourcenzuordnung
• Sling-Zuordnungen

Ressourcen für Business.Adobe.com