> ## 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.

# Externe Verlinkungen

> Wie externe Deep-Links aufgebaut sind, mit denen Shop, Subshop, Kategorie, Produkt, Shopseite und Suche von außen gezielt aufgerufen werden.

Neben der Startseite Ihres Shops oder Ihres Subshops können selbstverständlich auch noch weitere Seiten Ihres Shops über externe Deep-Links geöffnet werden.

Bei einem externen Deep-Link wird eine beliebige andere Seite aufgerufen. Dazu werden ein oder mehrere Parameter an den Shop-Aufruf angehängt, die das exakte Ziel spezifizieren.

Externe Deep-Links werden beispielsweise von Suchmaschinen, Preissuchmaschinen, Affiliate-Netzwerken oder Adword- und Banner-Anzeigen verwendet. Deep-Links verweisen typischerweise auf Kategorien und Produkte.

Da solche externen Verlinkungen von den Suchmaschinen indiziert werden, ist es wichtig, diese im Sinne von Suchmaschinen zu gestalten (SEO). Hierzu finden Sie ausführliche Informationen unter:

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

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

Weitere Informationen zu URL-Parametern und deren Bedeutung finden Sie unter Materialien: [URL-Parameter](https://dokumentation.websale.de/v8s/referenz/url-parameter.md).

In diesem Kapitel beschränken wir uns auf wichtige Verlinkungen, die für die Vermarktung Ihres Shops relevant sind. Die Abschnitte gehen dabei von der Startseite über Kategorie und Produkt bis zur einzelnen Shopseite und zur Suche.

## Aufrufen eines Hauptshops

Ist für Ihren Shop bei WEBSALE V8s die Hauptdomain inklusive SSL-Zertifikat eingerichtet und in der Shopkonfiguration `shop.config` im Abschnitt `<Basic>` eingetragen, können Sie die Startseite Ihres Shops mit der parameterfreien Hauptdomain öffnen:

```text theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
https://www.Ihre-Domain
```

> [!WARNING]
>
> Es wird aus Gründen der Suchmaschinenoptimierung (SEO) dringend empfohlen, die Startseite des Shops über die Hauptdomain und nicht mit einem durch Parameter ergänzten URL aufzurufen. Nur in Ausnahmefällen und in Abstimmung mit dem zuständigen Suchmaschinenoptimierer darf eine abweichende Syntax für den Shop-Aufruf eingerichtet werden.

Referenz: [URL-Homepage](https://dokumentation.websale.de/v8s/referenz/tags/url-internetadresse.md#die-adressen-des-shops)

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

## Aufrufen eines Subshops

Ist für Ihren Subshop bei WEBSALE V8s eine eigene Domain inklusive SSL-Zertifikat eingerichtet und in der Shopkonfiguration `shop.config` in dem Abschnitt `<Basic>` eingetragen, können Sie die Startseite Ihres Subshops ebenfalls mit einer parameterfreien Hauptdomain öffnen:

```text theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
https://www.Ihr-Subshop-Domain
```

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

## Aufrufen einer Kategorie

### Parameterfrei (SEO-URLs)

Aufruf einer Kategorie ohne Parameter:

```text theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
https://www.Ihre-Domain/<SEO-Name der Kategorie>
```

Beispiel:

```text theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
https://www.mustershop.de/Tauchsport
```

### Mit Parametern

Für den Aufruf einer Kategorie mit Parametern benötigt man die folgenden Parameter:

* Shopversion `websale8`
* ShopID
* SubshopID, wenn mehrere Subshops betrieben werden
* Parameter `&ci=`

Fügen Sie diese Parameter Ihrer Domain hinzu, um die gewünschte Kategorie zu öffnen:

```text theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
https://www.Ihre-Domain/?websale8=<ShopID>&ci=<Kategorieindex>
```

Oder:

```text theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
https://www.Ihre-Domain/?websale8=<ShopID>.<SubshopID>&ci=<Kategorieindex>
```

Optional möglicher weiterer Parameter:

| Parameter | Bedeutung |
| - | - |
| `&tpl=...` | Wenn zusätzlich der Parameter `tpl` verwendet wird, wird das angegebene Template als Kategorieseite verwendet. |

## Aufrufen eines Produktes

### Parameterfrei (SEO-URLs)

Aufruf eines Produktes ohne Parameter:

```text theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
https://www.Ihre-Domain/<SEO-Name der Kategorie>/<SEO-Name des Produkts>
```

Beispiel:

```text theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
https://www.mustershop.de/Tauchsport/Tauchermaske-Nautilus
```

### Mit Parametern über den Produktindex

Für den Aufruf eines Produkts mit Parametern über den Produktindex benötigt man die folgenden Parameter:

* Shopversion `websale8`
* ShopID
* SubshopID, wenn mehrere Subshops betrieben werden
* Parameter `&pi=`

Fügen Sie diese Parameter Ihrer Domain hinzu, um das gewünschte Produkt zu öffnen:

```text theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
https://www.Ihre-Domain/?websale8=<ShopID>&pi=<Produktindex>
```

Oder:

```text theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
https://www.Ihre-Domain/?websale8=<ShopID>.<SubshopID>&pi=<Produktindex>
```

Optional mögliche weitere Parameter:

| Parameter | Bedeutung |
| - | - |
| `&ci=...` | Der Parameter `ci` ist optional. Er muss nur für den Fall verwendet werden, wenn das gewünschte Produkt gleichzeitig in mehreren Kategorien vorhanden ist und die Anzeige des Produkts mit genau den Rahmendaten einer speziellen Kategorie erfolgen soll. Üblicherweise wird `ci` also weggelassen. |
| `&pn=...` | Wenn zusätzlich der Parameter `pn` verwendet wird, wird der Parameter `pi` vorzugsweise behandelt. Dies bedeutet, wenn beide Parameter verwendet wurden und Produktindex und Produktnummer von unterschiedlichen Produkten stammen, wird das Produkt mit dem angegebenen Produktindex angezeigt. |
| `&tpl=...` | Wenn zusätzlich der Parameter `tpl` verwendet wird, wird das angegebene Template als Produkt-Detailansicht verwendet. |

### Mit Parametern über die Produktnummer

Für den Aufruf eines Produkts mit Parametern über die Produktnummer benötigt man die folgenden Parameter:

* Shopversion `websale8`
* ShopID
* SubshopID, wenn mehrere Subshops betrieben werden
* Parameter `&pn=`

Fügen Sie diese Parameter Ihrer Domain hinzu, um das gewünschte Produkt zu öffnen:

```text theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
https://www.Ihre-Domain/?websale8=<ShopID>&pn=<Produktnummer>
```

Oder:

```text theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
https://www.Ihre-Domain/?websale8=<ShopID>.<SubshopID>&pn=<Produktnummer>
```

Optional mögliche weitere Parameter:

| Parameter | Bedeutung |
| - | - |
| `&ci=...` | Der Parameter `ci` ist optional. Er muss nur dann verwendet werden, wenn das gewünschte Produkt gleichzeitig in mehreren Kategorien vorhanden ist und das Produkt mit genau den Rahmendaten einer speziellen Kategorie angezeigt werden soll. Üblicherweise wird `ci` also weggelassen. |
| `&pi=...` | Wenn zusätzlich der Parameter `pi` verwendet wird, wird der Parameter `pi` vorzugsweise behandelt. Dies bedeutet, wenn beide Parameter verwendet wurden und Produktindex und Produktnummer von unterschiedlichen Produkten stammen, wird das Produkt mit dem angegebenen Produktindex angezeigt. |
| `&tpl=...` | Wird zusätzlich der Parameter `tpl` eingesetzt, so wird das angegebene Template als Produkt-Detailansicht verwendet. |

## Aufrufen einer Shopseite

### Parameterfrei (SEO-URLs)

Aufruf einer Shopseite ohne Parameter:

```text theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
https://www.Ihre-Domain/<SEO-Name des Templates>
```

Beispiel:

```text theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
https://www.mustershop.de/Kontaktseite-der-Firma-Muster-GmbH
```

### Mit Parametern

Für den Aufruf einer Seite mit Parametern benötigt man die folgenden Parameter:

* Shopversion `websale8`
* ShopID
* SubshopID, wenn mehrere Subshops betrieben werden
* Parameter `&tpl=`

Fügen Sie diese Parameter Ihrer Domain hinzu, um die gewünschte Shopseite zu öffnen:

```text theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
https://www.Ihre-Domain/?websale8=<ShopID>&tpl=<Inhaltsseite>
```

Oder:

```text theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
https://www.Ihre-Domain/?websale8=<ShopID>.<SubshopID>&tpl=<Inhaltsseite>
```

Die Template-Datei muss sich im Subshop-Templateverzeichnis unter `benutzer/templates/<Subshop-ID>` oder einem Unterverzeichnis davon befinden.

## Aufrufen einer Suche

Sie können mithilfe eines Deep-Links auch gezielt Suchbegriffe mit übergeben und dann sofort die Suchergebnisse anzeigen lassen.

Wegweiser: [Suchergebnisse](https://dokumentation.websale.de/v8s/suche/suchergebnisse.md)


## Related topics

- [Domains und Shop-Aufruf: Grundlagen](https://dokumentation.websale.de/v8s/domains/grundlagen-domains-und-shop-aufruf.md)
- [WS-hreflang-Verlinkungen](https://dokumentation.websale.de/v8s/schnittstellen/marketing-seo-und-portale/ws-hreflang-verlinkungen.md)
- [Interne Verlinkungen](https://dokumentation.websale.de/v8s/domains/interne-verlinkungen.md)
- [Marketing, SEO und externe Portale](https://dokumentation.websale.de/v8s/schnittstellen/marketing-seo-und-portale.md)
- [$wsExternalData - Externe Daten](https://dokumentation.websale.de/frontend/referenz/module/wsexternaldata.md)


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