> ## Documentation Index
> Fetch the complete documentation index at: https://dokumentation.websale.de/llms.txt
> Use this file to discover all available pages before exploring further.

# SEO-Optimierung mit TopRank

> Das TopRank-Modul einrichten: automatisch erzeugte XML-Sitemaps und HTML-Seiten samt eigener Templates sowie die Felder, die ein SEO im TopRank-Manager pflegt.

TopRank ist ein optionales Modul zur Verbesserung des Suchmaschinenrankings. Seine Funktionen zerfallen in zwei Gruppen, und diese Unterscheidung bestimmt auch den Aufbau dieser Seite:

| Gruppe | Funktionen | Wer arbeitet daran |
| - | - | - |
| läuft automatisch | XML-Sitemaps, statische HTML-Seiten | einmal einrichten, danach niemand |
| lebt von Eingaben | Begriffe für Kategorien, SEO-Content für Produkte, Aufbau der Adressen, Kurzadressen | der SEO-Verantwortliche, laufend |

Die Oberfläche für beides ist der Dienst TopRank-Manager im Online-Servicebereich. Er ist zugleich der Grund, warum das Modul für viele Shops interessant ist: Ein externer SEO bekommt dort Zugang, ohne Zugriff auf die Warenwirtschaft zu brauchen.

## Was TopRank automatisch erzeugt

Für beide automatischen Funktionen gilt dasselbe Vorgehen. Aktiviert werden sie je Subshop im TopRank-Manager. Erzeugt werden die Dateien danach einmal täglich von selbst. Wer nicht bis zum nächsten Tag warten will, etwa nach neuen Einstellungen oder Begriffszuordnungen, stößt die Erzeugung im TopRank-Manager von Hand an.

Wohin die Dateien geschrieben werden, steht im Abschnitt `<TopRank>` der `shop.config`:

| Parameter | Legt fest |
| - | - |
| `TopRankDir` | Ausgabeverzeichnis der TopRank-HTML-Seiten, voreingestellt `/artikel` unterhalb der Shop-Root |
| `SitemapDir` | Ausgabeverzeichnis der Sitemap-Dateien |

Beide Angaben sind relative Pfade unterhalb des Shop-Wurzelverzeichnisses. Ein Pfad, der aus diesem Verzeichnis herausführt, wird abgewiesen und die Erzeugung bricht mit einer Fehlermeldung ab.

Für `SitemapDir` wird auch die ältere Schreibweise `SiteMapDir` noch gelesen. In bestehenden Shops kann also beides stehen. Für neue Einträge ist `SitemapDir` die richtige Form.

Referenz: [Abschnitt TopRank](https://dokumentation.websale.de/v8s/referenz/konfigurationen/shopkonfiguration-shop-config/grundlagen-und-technik.md#toprank)

### XML-Sitemaps

Eine Sitemap zählt der Suchmaschine auf, welche Adressen es gibt. TopRank nimmt dabei auf:

* alle im Shop aktiven Kategorien
* alle im Shop aktiven Produkte, die einer Kategorie zugewiesen sind
* die Startseite des Shops
* die Index-Seiten der TopRank-HTML-Seiten

Wie viele Adressen in eine einzelne Datei dürfen, ist begrenzt. TopRank legt deshalb bei Bedarf mehrere Dateien an und dazu eine Index-Datei namens `toprank-sitemap_index.xml`, die alle erzeugten Dateien aufführt. Diese eine Datei ist es, die Sie bei der Suchmaschine bekannt machen.

Die Namen der einzelnen Dateien folgen diesem Schema:

```text theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
toprank-sitemap_<Subshop-ID><fortlaufende Nummer>.xml
```

Die erste Sitemap-Datei des Subshops `deutsch` heißt also `toprank-sitemap_deutsch0.xml`.

#### Die Domain in den Adressen

In einer Sitemap stehen absolute Adressen. Die dafür nötige Domain liest TopRank aus dem Parameter `Domain-!` im Abschnitt `<Basic>` der `shop.config`.

> [!WARNING]
>
> Prüfen Sie bei älteren Shops, ob im Abschnitt `<TopRank>` noch der Parameter `SiteMapDomain` steht. Er ist überflüssig geworden. Für neue Projekte und bei Überarbeitungen konfigurieren Sie die Domain ausschließlich über `Domain-!` im Abschnitt `<Basic>`.

Wird ein Subshop über eine eigene Domain oder Subdomain aufgerufen, braucht diese ein eigenes Wurzelverzeichnis und ein eigenes SSL-Zertifikat. Bei der Bereitstellung eines Subshops mit eigener Domain wird beides standardmäßig eingerichtet.

Referenz: [Abschnitt Basic](https://dokumentation.websale.de/v8s/referenz/konfigurationen/shopkonfiguration-shop-config/grundlagen-und-technik.md#basic)

#### Sitemaps bei der Suchmaschine anmelden

Je nach Suchmaschine ist die Sitemap-Technologie für eine Domain über einen Webmaster-Zugang freizuschalten. Bei Beauftragung des TopRank-Moduls legt die WEBSALE AG einen solchen Zugang bei Google als Teil der Bereitstellung an. Ihr beauftragter Suchmaschinenoptimierer kann das ebenso übernehmen.

Alternativ zur Anmeldung von Hand trägt TopRank die Sitemaps auf Wunsch selbst in die `robots.txt` ein.

Wegweiser: [Sitemaps, robots.txt und Mobile-Subshops](https://dokumentation.websale.de/v8s/seo/sitemaps-robots-txt-und-mobile-subshops.md)

#### Mobile-Shops

Betreiben Sie einen Mobile-Shop als eigenen Subshop, braucht er eigene Sitemap-Dateien, weil er teils andere Inhalte und andere Parameter ausliefert. Gekennzeichnet wird ein solcher Subshop im Abschnitt `<Basic>`:

```ini theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
<Basic>
   ...
   TargetSystems = mobile
   ...
</Basic>
```

Ist für diesen Subshop im TopRank-Manager "Sitemaps erzeugen" aktiv, erkennt TopRank die Kennzeichnung und erzeugt Mobile-Sitemaps.

> [!WARNING]
>
> Ausgewertet wird genau der Wert `mobile`. Eine andere Schreibweise führt dazu, dass gewöhnliche Sitemaps erzeugt werden, ohne dass ein Fehler gemeldet wird.

### TopRank-HTML-Seiten

Neben den Sitemaps erzeugt TopRank statische HTML-Seiten mit Linklisten auf Kategorien und Produkte. Ihr Nutzen liegt in der inneren Verlinkung des Shops, und sie erreichen auch Suchmaschinen, die keine Sitemaps auswerten.

Diese Seiten ranken erfahrungsgemäß etwas schlechter als die Shopseiten selbst und erscheinen in Trefferlisten hinter ihnen. Sie werden also seltener angeklickt. Trotzdem lohnt es sich, ihnen zumindest ansatzweise das Erscheinungsbild des Shops zu geben.

Die Index-Seiten je Subshop heißen:

```text theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
index-<Subshop-ID>.htm
index-flat-<Subshop-ID>.htm
```

Die Seiten der einzelnen Kategorien folgen diesem Schema:

```text theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
<Kategoriename>-<Subshop-ID>.htm
```

Die Seite der Kategorie "Schuhe" im Subshop `deutsch` heißt also `Schuhe-deutsch.htm`.

> [!WARNING]
>
> Legen Sie einen Link auf die Index-Seiten. Sind die TopRank-Sitemaps aktiv, wird der Link darüber zwar bekannt gemacht, viele Suchmaschinen finden die Seiten aber nur über einen echten Link im Shop. Ohne Sitemaps ist der Link zwingend, sonst werden die Seiten nie besucht.

#### Die Templates anpassen

Für die Seiten sind zentrale Templates in neutralem Design zugeordnet. Sie liegen in mehreren Sprachen vor, die im Online-Servicebereich ausgewählt werden. Fehlt eine Sprache, kann sie entweder zentral durch die WEBSALE AG ergänzt oder vom Designer des Shops je Subshop selbst erstellt werden. Dasselbe gilt für ein eigenes Design.

Eigene Templates gehören in das Ausgabeverzeichnis der TopRank-Seiten, also in das Verzeichnis aus `TopRankDir`. Die Namen sind vorgegeben:

| Template | Wofür |
| - | - |
| `template-subshop.htm` | die globale Index-Seite |
| `template-category.htm` | die Kategorien mit den darin enthaltenen Produkten |

Sollen nur bestimmte Subshops ein eigenes Design bekommen, hängen Sie die Subshop-ID an den Namen an. Für den Subshop `deutsch` heißen die Templates dann `template-subshop-deutsch.htm` und `template-category-deutsch.htm`.

In diesen Templates gelten eigene Tags, die nur hier zulässig sind. Die Tags der Shop-Templates stehen dort nicht zur Verfügung.

Referenz: Spezielle Tags der TopRank-Templates

## Was ein SEO im TopRank-Manager pflegt

### Zusätzliche Begriffe für Kategorien

Über den TopRank-Manager lassen sich Kategorien mit zusätzlichen Keywords und Texten anreichern. Diese Begriffe können im sichtbaren Bereich der Seite stehen oder unsichtbar im Kopf, und sie lassen sich auch bei den Produkten der jeweiligen Kategorie ausgeben.

Damit lässt sich ein Problem lösen, das entsteht, sobald ein Produkt in mehreren Kategorien steht: Die Produktseite ist dann unter mehreren Adressen mit demselben Inhalt erreichbar. Werden die der Kategorie zugeordneten Texte auf die Produktseite übernommen, unterscheiden sich diese Seiten wieder voneinander.

Der Inhalt dieser Felder kann je Feld einzeln festgelegt auch aus der Warenwirtschaft kommen, sofern diese solche Kategoriefelder unterstützt. Empfohlen ist trotzdem die Pflege im Online-Servicebereich, weil dort auch externe SEOs arbeiten können, die keinen Zugriff auf die Warenwirtschaft haben.

Wegweiser: [Weitere Möglichkeiten für die Beschreibung einer Kategorie](https://dokumentation.websale.de/v8s/kategorien/beschreibung-einer-kategorie.md)

Referenz: [CAT-FreeField1…20](https://dokumentation.websale.de/v8s/referenz/tags/cat/kategoriedaten.md#cat-freefield1-30)

### SEO-Content für Produkte

Wie gut ein Produkt gefunden wird, hängt vor allem an der Beschreibung, die für Suchmaschinen ausgeliefert wird. Das Feature "SEO-Content für Produkte" stellt dafür je Produkt zusätzliche Felder bereit, gepflegt entweder im SEO-Modus direkt im Shop oder über die Upload-Funktion des TopRank-Managers. Derselbe Mechanismus liefert auch den sprechenden Namen für die Produktadresse.

Wegweiser: [SEO-Content für Produkte](https://dokumentation.websale.de/v8s/seo/seo-content-fuer-produkte.md)

### Der Aufbau der Adressen

Wie die Adressen des Shops gebildet werden, stellen Sie ebenfalls im TopRank-Manager ein, shopübergreifend oder je Subshop abweichend. Woher der sprechende Teil der Adresse kommt, unterscheidet sich je Seitentyp:

| Seitentyp | Quelle des Namens |
| - | - |
| Kategorien | eigenes Feld im TopRank-Manager, alternativ ein Kategoriefeld aus der Warenwirtschaft |
| Produkte | SEO-Produktname aus "SEO-Content für Produkte" |
| Informationsseiten | Menüpunkt "URLs von Informationsseiten" im TopRank-Manager |

Auch hier gilt: Die Pflege im Online-Servicebereich ist der empfohlene Weg, weil externe SEOs dort ohne Zugriff auf die Warenwirtschaft arbeiten können.

Die Einstellungen selbst, also Trennzeichen, Aufbau je Seitentyp, Weiterleitungen und Entfernen überflüssiger Parameter, sind an anderer Stelle beschrieben.

Wegweiser: [SEO-URLs und Link-Optimierung](https://dokumentation.websale.de/v8s/seo/seo-urls-und-link-optimierung.md)

### Kurzadressen für Kampagnen

Eine Kurzadresse ist eine zusätzliche, von außen aufrufbare Adresse für eine Shopseite. Ihr Zweck ist die Printanzeige: Der Leser soll etwas abtippen können, das kurz genug zum Merken ist. Ein Aufruf wird per 301-Weiterleitung auf die eigentliche Zielseite geführt.

Angelegt wird eine Kurzadresse im TopRank-Manager aus zwei Angaben, der Adresse selbst und den Shop-Parametern, die das Ziel bestimmen:

| Angabe | Beispiel |
| - | - |
| Kurzadresse | `ihr-shop.de/angebot` |
| Zielparameter | `&pi=2-1312` |

Damit führt `ihr-shop.de/angebot` auf das Produkt mit dem Produktindex `2-1312`.

Mit der Aktivierung der SEO-URLs für einen Shop oder Subshop werden die Kurzadressen im TopRank-Manager gepflegt, damit alle Einstellungen zu Adressen an einer Stelle liegen. Der separate Dienst "Kurzadressen für Kampagnen", der zu den parameterbehafteten V8-Adressen gehörte, hat ab diesem Zeitpunkt keine Funktion mehr.

## Verwandte Themen

* Wegweiser: [SEO-URLs und Link-Optimierung](https://dokumentation.websale.de/v8s/seo/seo-urls-und-link-optimierung.md)
* Wegweiser: [SEO-Content für Produkte](https://dokumentation.websale.de/v8s/seo/seo-content-fuer-produkte.md)
* Wegweiser: [Sitemaps, robots.txt und Mobile-Subshops](https://dokumentation.websale.de/v8s/seo/sitemaps-robots-txt-und-mobile-subshops.md)
* Wegweiser: Weitere Möglichkeiten für die Beschreibung einer Kategorie


## Related topics

- [SEO- (URL-Einstellungen TopRank)](https://dokumentation.websale.de/v8s/referenz/tags/seo-url-einstellungen-toprank.md)
- [TopRank-HTML-Seiten](https://dokumentation.websale.de/v8s/referenz/tags/toprank-html-seiten.md)
- [SEO-URLs und Link-Optimierung](https://dokumentation.websale.de/v8s/seo/seo-urls-und-link-optimierung.md)
- [Grundlagen und Technik](https://dokumentation.websale.de/v8s/referenz/konfigurationen/shopkonfiguration-shop-config/grundlagen-und-technik.md)
- [Allgemeine Online-Dienste](https://dokumentation.websale.de/v8s/online-servicebereich/allgemeine-online-dienste.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.